立即开始

环境变量。

您自己的变量和 Rivervo 为您设置的变量、生产环境与预览、替换自动设置的值,以及更改何时生效。

1 分钟阅读

应用的密钥、密码和设置保存在 变量 选项卡中。它们以加密方式存储,并作为普通环境变量提供给您的应用。

添加您自己的变量

变量 → 添加变量,输入 名称 和值,然后点击 保存。

  • 名称由拉丁字母、数字和 _ 组成,且不能以数字开头。每个名称必须唯一。
  • 提示: 将 .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_STORELaravel 应用(详见 Laravel)

项目的第一个数据库使用常规名称(DATABASE_URL、DB_*)。第二个数据库只会添加自己的 RIVERVO_<NAME>_URL,因此不会自动切换——详见 数据库。

替换自动设置的值

同名的自定义变量会 替代 自动设置的变量;面板会将其标记为 使用您的值。您可以借此将应用指向其他位置,例如将 DATABASE_URL 指向项目中的另一个数据库。

PORT 是唯一的例外:它始终由 Rivervo 管理。

项目中的服务

项目中的每个服务——后台任务、定时任务、其他 Web 服务——都会获得项目的变量,包括其数据库。服务也可以有自己的变量,其优先级高于项目变量。Web 服务始终有自己的 APP_URL。每个代码服务还会以 RIVERVO_<NAME>_URL 的形式获得其他每个 Web 服务的内部地址;添加或重命名 Web 服务后,请重新部署其他服务,以便它们获取该地址。详见 项目中的服务。

谁能看到变量值

变量值对账户所有者以及在应用中拥有 开发者 或 管理员 角色的成员可见。查看者 角色看不到这些值。详见 应用访问权限。

还有疑问?

和我们聊聊——AI 即时回答,需要时工程师加入,全天候在线。

联系技术支持