Dockerfile中RUN命令无法替换环境变量，该如何排查解决？

问题场景 #

你编写的Dockerfile内容如下：

ENV PROXY_HOST=sub.proxy.domain.com
ENV PROXY_PORT=8080
RUN sed -i 's/# https.proxyHost=/https.proxyHost=$PROXY_HOST/g' /opt/coldfusion/jre/conf/net.properties

但构建镜像后，查看/opt/coldfusion/jre/conf/net.properties文件时，对应行并未替换为实际的代理地址，而是直接显示：

https.proxyHost=$PROXY_HOST

你尝试过${PROXY_HOST}语法、Docker ARG特性，均未解决该问题。

核心原因 #

Shell中，单引号会完全屏蔽变量解析，sed命令里的$PROXY_HOST被当作普通字符串处理，没有被替换为环境变量的值。

解决方案 #

方法一：将sed命令的单引号改为双引号 #

把sed命令的单引号替换为双引号，Shell会先解析双引号内的环境变量，再将解析后的内容传递给sed执行：

ENV PROXY_HOST=sub.proxy.domain.com
ENV PROXY_PORT=8080
RUN sed -i "s/# https.proxyHost=/https.proxyHost=$PROXY_HOST/g" /opt/coldfusion/jre/conf/net.properties

注意：如果变量值包含/、&等sed特殊字符，需要提前转义，你的场景中域名无此类字符，可直接使用。

方法二：拆分引号拼接变量 #

如果不想整体使用双引号，可将固定字符串用单引号包裹，变量部分用双引号包裹后拼接：

ENV PROXY_HOST=sub.proxy.domain.com
ENV PROXY_PORT=8080
RUN sed -i 's/# https.proxyHost=/https.proxyHost='"$PROXY_HOST"'/g' /opt/coldfusion/jre/conf/net.properties

这种方式下，Shell会先解析双引号中的$PROXY_HOST，再和前后的单引号内容拼接成完整的sed命令。

关于ARG的补充 #

如果想用ARG构建时变量，需确保ARG在RUN前定义，且若要在ENV中使用ARG需关联，但核心还是要解决引号问题，示例如下：

ARG PROXY_HOST=sub.proxy.domain.com
ARG PROXY_PORT=8080
ENV PROXY_HOST=$PROXY_HOST
ENV PROXY_PORT=$PROXY_PORT
RUN sed -i "s/# https.proxyHost=/https.proxyHost=$PROXY_HOST/g" /opt/coldfusion/jre/conf/net.properties

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