解决Docker Compose构建时从.env.local而非.env传递代理参数至Dockerfile的问题

你的问题根源在于Docker Compose构建阶段（build）的参数来源和运行阶段（container runtime）的环境变量来源是完全分开的，具体细节如下：

1. 你在docker-compose.yml里配置的env_file是给容器运行时设置环境变量用的，和构建阶段的args没有直接关联；
2. 当你在args里只写变量名（比如- HTTP_PROXY）时，Docker Compose会从两个优先级更高的地方取值：
   • 执行命令时的Shell环境变量
   • 默认自动加载的.env文件（如果执行命令的工作目录是项目根目录，就会加载根目录的.env，这也是你当前拿到错误值的原因）
3. 你的.env.local并没有被构建阶段自动读取，所以构建参数拿到的是.env里的代理地址。

解决办法 #

方法1：构建时显式指定使用.env.local #

Docker Compose提供了--env-file参数，让你可以强制指定构建阶段要加载的环境变量文件，直接修改构建命令即可：

docker-compose -f docker/docker-compose.yml --env-file .env.local build

这个命令会让Docker Compose优先加载.env.local里的变量，构建参数HTTP_PROXY/HTTPS_PROXY就会拿到你想要的127.0.0.1:9090值。

方法2：在docker-compose.yml中明确绑定构建参数（可选） #

如果你想让配置逻辑更清晰，可以在build.args里明确变量的取值绑定（需要和方法1配合使用）：

version: '3.5'
services:
  web:
    env_file:
      - ../.env.local
    build:
      context: ../
      dockerfile: docker/Dockerfile
      args:
        HTTP_PROXY: ${HTTP_PROXY}
        HTTPS_PROXY: ${HTTPS_PROXY}

这样配置后，构建参数的取值来源会更直观，再配合方法1的命令执行构建即可。

验证结果 #

修改后重新执行构建，你会看到Dockerfile里的printenv输出：

http_proxy=127.0.0.1:9090
https_proxy=127.0.0.1:9090

这就说明代理值已经正确从.env.local传递到Dockerfile了。

内容的提问来源于stack exchange，提问作者beta-developper