环境变量。
您自己的变量和 Rivervo 为您设置的变量、生产环境与预览、替换自动设置的值,以及更改何时生效。
应用的密钥、密码和设置保存在 变量 选项卡中。它们以加密方式存储,并作为普通环境变量提供给您的应用。
添加您自己的变量
变量 → 添加变量,输入 名称 和值,然后点击 保存。
- 名称由拉丁字母、数字和
_组成,且不能以数字开头。每个名称必须唯一。 - 提示: 将
.env文件的内容粘贴到名称字段中,即可一次性添加所有行。
变量在应用运行时生效,而不是在构建阶段。更改 在下次部署时 生效。保存后,面板会提供 立即部署,使用新变量重新部署当前运行的版本,无需重新构建。
生产环境和预览
每个变量都有一个 环境:
| 环境 | 作用范围 |
|---|---|
| 生产环境和预览 | 线上应用和所有分支预览(默认) |
| 仅生产环境 | 仅线上应用——例如正式的支付密钥 |
| 仅预览 | 仅分支预览——例如测试用的支付密钥 |
预览只获得为其设置的变量。预览也有自己的 变量 选项卡:您可以在其中查看它 来自应用 的变量,同名的自定义值仅在该预览中替代这些变量。
自动设置
自动设置 列表显示 Rivervo 为您的应用提供并保持更新的变量。您无需自行添加:
| 变量 | 条件 |
|---|---|
PORT | 始终——您的应用监听的端口 |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | 项目包含 PostgreSQL 或 MySQL 数据库 |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | 数据库为 PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | 项目包含 Valkey |
RIVERVO_<NAME>_URL | 项目中的每个数据库、Valkey 和只读副本,按服务名称命名 |
RIVERVO_<NAME>_URL | 应用中的其他每个 Web 服务——其内部地址,例如 RIVERVO_API_URL=http://api:8080(详见 服务间通信) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | 项目包含对象存储 |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | Laravel 应用(详见 Laravel) |
项目的第一个数据库使用常规名称(DATABASE_URL、DB_*)。第二个数据库只会添加自己的 RIVERVO_<NAME>_URL,因此不会自动切换——详见 数据库。
替换自动设置的值
同名的自定义变量会 替代 自动设置的变量;面板会将其标记为 使用您的值。您可以借此将应用指向其他位置,例如将 DATABASE_URL 指向项目中的另一个数据库。
PORT 是唯一的例外:它始终由 Rivervo 管理。
项目中的服务
项目中的每个服务——后台任务、定时任务、其他 Web 服务——都会获得项目的变量,包括其数据库。服务也可以有自己的变量,其优先级高于项目变量。Web 服务始终有自己的 APP_URL。每个代码服务还会以 RIVERVO_<NAME>_URL 的形式获得其他每个 Web 服务的内部地址;添加或重命名 Web 服务后,请重新部署其他服务,以便它们获取该地址。详见 项目中的服务。
谁能看到变量值
变量值对账户所有者以及在应用中拥有 开发者 或 管理员 角色的成员可见。查看者 角色看不到这些值。详见 应用访问权限。