You need to enable JavaScript to run this app. 如何在Dockerfile的RUN指令中使用环境变量?为何传入变量为空?
优惠活动
大模型
产品
解决方案
定价
更多

如何在Dockerfile的RUN指令中使用环境变量?为何传入变量为空?

问题核心根因

这个问题的本质是混淆了镜像构建阶段和容器运行阶段的变量作用域,两个阶段的执行上下文完全隔离:

  • Dockerfile中的RUN指令,是在镜像构建流程中执行的,属于构建阶段的逻辑。这个阶段容器还没正式启动,docker-compose中environment字段配置的变量,根本不会被注入到构建流程的执行环境中,所以执行echo命令时,${USERNAME}取到的是空值。
  • docker-compose配置里的environment字段,仅会在容器正式启动运行时,才会被注入到容器的进程环境中,和构建阶段的执行流程没有打通。
  • 你执行docker-compose config能正常看到变量,是因为这个命令仅做配置文件的文本解析、合并、校验展示,不会介入实际的镜像构建、容器运行流程,和变量能不能被对应阶段读取没有任何关系。
对应解决方式

根据你的实际使用场景选择对应的方案:

场景1:需要在构建镜像时就把USERNAME写入日志/配置文件

这种场景不能用运行时的environment传值,需要通过Docker的构建参数(Build Args)把值传到构建流程里:

  1. 修改docker-compose.yml,把变量从environment字段挪到build.args字段下,代表这是给构建流程传递的参数,而非给运行时传递的配置:
    version: "3"
    services:
      web:
        build:
          context: .
          args:
            - USERNAME=larry
    
  2. 修改Dockerfile,在执行对应RUN指令之前,声明接收这个构建参数:
    FROM php:7.4-apache
    # 声明接收构建传入的USERNAME参数,参数仅在当前构建阶段生效
    ARG USERNAME
    RUN echo "I am ${USERNAME}" > /home/dockerfile.log
    

    注意:通过ARG声明的参数是临时值,仅在当前构建流程中存在,不会被持久化到最终镜像的环境变量里。如果需要容器运行时也能读取到这个USERNAME值,需要补充一行指令把参数值赋值为持久化环境变量:ENV USERNAME=${USERNAME}

场景2:需要每次容器启动时,根据运行时传入的变量动态生成配置文件

如果你需要的效果是,每次容器启动时都根据当时传入的运行时变量动态生成配置/日志内容,就不能用RUN实现——RUN的执行结果会在镜像构建完成后就被固化到分层文件系统里,后续哪怕更换运行时的变量值,这个已经写死的文件内容也不会更新。正确的做法是把动态生成文件的逻辑放到容器的启动入口脚本里,在容器正式启动时执行:

  1. 修改Dockerfile,移除原来的RUN写文件逻辑,添加自定义启动脚本的配置:
    FROM php:7.4-apache
    # 复制自定义启动脚本到容器内
    COPY start.sh /usr/local/bin/start.sh
    RUN chmod +x /usr/local/bin/start.sh
    # 替换容器默认启动命令,优先执行自定义脚本
    CMD ["/usr/local/bin/start.sh"]
    
  2. 在和Dockerfile同目录下创建启动脚本start.sh:
    #!/bin/bash
    # 容器启动时,根据运行时注入的USERNAME变量写入日志
    echo "I am ${USERNAME}" > /home/dockerfile.log
    # 必须把原来镜像默认的Apache启动命令接在后面,否则容器会执行完脚本就退出
    apache2-foreground
    
  3. 此时保留docker-compose.yml里原有的environment配置即可,变量会在容器启动时被脚本正常读取,生成正确的日志内容。

内容的提问来源于stack exchange,提问作者Elliott B

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 09:24:04