Dockerfile/docker-compose构建时能否访问主机环境变量，需手动传入吗？

默认情况下，Docker构建阶段（无论是编写Dockerfile还是执行docker-compose构建）无法直接访问主机的环境变量，必须通过显式配置手动传入。

两种常见的传入方式： #

• 通过docker-compose.yml配置传递
  在docker-compose.yml的build.args字段中定义构建参数，直接引用主机环境变量：

  version: '3.8'
  services:
    app:
      build:
        context: .
        args:
          # 引用主机环境变量HOST_ENV_VAR，传递给构建阶段的ENV_VAR参数
          - ENV_VAR=${HOST_ENV_VAR}
  

  若主机环境变量不存在，可通过${HOST_ENV_VAR:-默认值}的形式设置默认值，避免空值问题。

• 通过命令行参数直接传递
  执行docker-compose build时，使用--build-arg参数直接传入主机环境变量：

  docker-compose build --build-arg ENV_VAR=$HOST_ENV_VAR app
  

Dockerfile中接收并使用参数 #

在Dockerfile里需要用ARG指令声明接收的构建参数，之后就能在构建阶段使用：

# 声明要接收的构建参数
ARG ENV_VAR
# 可将构建参数转为容器运行时的环境变量（可选）
ENV APP_RUN_ENV=$ENV_VAR
# 构建阶段直接使用参数，比如打印变量信息
RUN echo "当前构建环境变量：$ENV_VAR"

注意：构建参数仅在构建阶段有效，若需要容器运行时也能访问对应变量，需通过ENV指令将其转换为容器环境变量。

内容的提问来源于stack exchange，提问作者user7692855