Docker Compose 中环境变量的优先级

当在多个源中设置相同的环境变量时，Docker Compose 遵循优先级规则来确定该变量在容器环境中的值。

本页解释了当环境变量在多个位置定义时，Docker Compose 如何确定其最终值。

优先级顺序（从高到低）如下：

1. 使用 CLI 中的 docker compose run -e 设置。
2. 使用 environment 或 env_file 属性设置，但其值是从您的 shell 或环境变量文件（可以是您的默认 .env 文件，或通过 CLI 中的 --env-file 参数）中插值得到的。
3. 仅使用 Compose 文件中的 environment 属性设置。
4. 使用 Compose 文件中的 env_file 属性设置。
5. 在容器镜像的 ENV 指令中设置。Dockerfile 中的任何 ARG 或 ENV 设置仅在 Compose 文件中没有 environment、env_file 或 run --env 条目时才有效。

简单示例

在以下示例中，.env 文件中与 Compose 文件中 environment 属性定义了相同的环境变量，但值不同。

$ cat ./webapp.env
NODE_ENV=test

$ cat compose.yaml
services:
  webapp:
    image: 'webapp'
    env_file:
     - ./webapp.env
    environment:
     - NODE_ENV=production

使用 environment 属性定义的环境变量具有更高的优先级。

$ docker compose run webapp env | grep NODE_ENV
NODE_ENV=production

高级示例

下表以 VALUE（一个定义镜像版本的环境变量）为例。

表格的工作原理

每列代表您可以设置值或为 VALUE 替换值的上下文。

列 Host OS environment 和 .env 文件仅用于说明目的。实际上，它们本身并不会在容器中产生变量，而是与 environment 或 env_file 属性结合使用。

每行代表 VALUE 被设置、替换或两者兼有的上下文组合。结果列表示每种场景下 VALUE 的最终值。

理解优先级结果

结果 1：本地环境具有优先级，但 Compose 文件未设置为在容器内部复制此变量，因此未设置此类变量。

结果 2：Compose 文件中的 env_file 属性为 VALUE 定义了显式值，因此容器环境也相应设置。

结果 3：Compose 文件中的 environment 属性为 VALUE 定义了显式值，因此容器环境也相应设置。

结果 4：镜像的 ENV 指令声明了变量 VALUE，由于 Compose 文件未设置为覆盖此值，因此此变量由镜像定义。

结果 5：docker compose run 命令设置了带有显式值的 --env 标志，并覆盖了镜像设置的值。

结果 6：docker compose run 命令设置了 --env 标志以复制环境中的值。主机操作系统值具有优先级并复制到容器的环境中。

结果 7：docker compose run 命令设置了 --env 标志以复制环境中的值。从 .env 文件中选择的值用于定义容器的环境。

结果 8：Compose 文件中的 env_file 属性设置为从本地环境复制 VALUE。主机操作系统值具有优先级并复制到容器的环境中。

结果 9：Compose 文件中的 env_file 属性设置为从本地环境复制 VALUE。从 .env 文件中选择的值用于定义容器的环境。

结果 10：Compose 文件中的 environment 属性设置为从本地环境复制 VALUE。主机操作系统值具有优先级并复制到容器的环境中。

结果 11：Compose 文件中的 environment 属性设置为从本地环境复制 VALUE。从 .env 文件中选择的值用于定义容器的环境。

结果 12：--env 标志具有比 environment 和 env_file 属性更高的优先级，并设置为从本地环境复制 VALUE。主机操作系统值具有优先级并复制到容器的环境中。

结果 13 到 15：--env 标志具有比 environment 和 env_file 属性更高的优先级，因此设置了值。

后续步骤

• 在 Compose 中设置环境变量
• 在 Compose 文件中使用变量插值