Skip to content

环境变量

您可以为资源定义环境变量,这些变量将在您的应用程序中可用。

预览部署可以有不同的环境变量,因此您可以将其用作应用程序的暂存环境进行测试。

构建时变量

如果您想为构建过程设置环境变量,可以通过在 UI 的普通视图中勾选 构建变量 复选框来实现。

共享变量

您可以使用三种类型的共享变量:

  1. 团队共享变量
  2. 项目共享变量
  3. 环境共享变量(生产、暂存等)

您可以在各自的页面上设置共享变量。

然后您可以在任何地方使用这些变量。例如:您将 NODE_ENV 定义为 production

团队共享变量

您可以在 团队 页面上设置它们,并使用 {{team.NODE_ENV}} 来引用。请勿将 "team" 替换为您的实际团队名称。

项目共享变量

您可以在 项目 页面上,通过齿轮图标设置它们,并使用 {{project.NODE_ENV}} 来引用。请勿将 "project" 替换为您的实际项目名称。

环境共享变量

您可以在 环境 页面上(选择一个 项目),通过齿轮图标设置它们,并使用 {{environment.NODE_ENV}} 来引用。请勿将 "environment" 替换为您的实际环境名称。

在 Compose 文件中使用共享变量

如果您想在 Compose 文件中使用环境变量,可以使用以下语法:

bash
environment:
  - NODE_ENV=${NODE_ENV}

然后在 UI 中将 NODE_ENV 设置为您想要的共享变量。例如,如果您想使用团队共享变量(请确保您已在团队变量中设置了 NODE_ENV 变量):

bash
NODE_ENV={{team.NODE_ENV}}

预定义变量

Coolify 为您预定义了一些变量,您可以在应用程序或服务中使用它们。您只需在应用程序或服务中添加如下环境变量即可。

bash
# 例如,您可以在应用程序中使用此变量
MY_VARIABLE=$SOURCE_COMMIT
# 您的应用程序中将有源码的提交哈希作为环境变量 MY_VARIABLE 的值

应用程序变量

COOLIFY_FQDN

应用程序的完全限定域名。

COOLIFY_URL

应用程序的 URL。

COOLIFY_BRANCH

源代码的分支名称。

COOLIFY_RESOURCE_UUID

Coolify 生成的唯一资源标识符。

COOLIFY_CONTAINER_NAME

Coolify 生成的容器名称。

SOURCE_COMMIT

源代码的提交哈希。

PORT

如果未设置:会设置为 端口暴露 中的第一个端口。

HOST

如果未设置:会设置为 0.0.0.0

服务栈变量

SERVICE_NAME_<SERVICE>

栈中特定服务的服务名称。例如,如果您有一个名为 web 的服务,可以通过 SERVICE_NAME_WEB 访问它。这在服务名称会变化的预览部署中非常有用。