docker build-args传递SOCKS5代理参数无效，求助解决

我之前也遇到过和你一模一样的问题，当时折腾了好一会儿才弄明白原因，分享下我的解决方案和分析：

问题复现 #

你的Dockerfile内容：

FROM clearlinux:base
RUN swupd bundle-add c-basic

执行构建命令时超时失败：

docker build --build-arg="ALL_PROXY='socks5://proxy.company.com'" -t test-socks .

但在Dockerfile中直接添加ENV ALL_PROXY='socks5://proxy.company.com'后，构建就能正常完成，且仅ALL_PROXY存在该异常。

核心原因 #

1. --build-arg的作用范围：--build-arg传递的是构建阶段的参数，这些参数默认不会自动成为容器运行环境（也就是RUN命令执行时的环境）的环境变量，除非你在Dockerfile中显式声明并转换。
2. 参数格式问题：你构建命令里的ALL_PROXY值加了单引号，这会导致实际传递的变量值包含单引号（比如'socks5://proxy.company.com'），swupd无法识别这个格式错误的代理地址，也是超时的诱因之一。

解决方案 #

方案一：修改Dockerfile，将构建参数转为环境变量 #

在Dockerfile中先声明ARG ALL_PROXY，再通过ENV把它注入到容器环境中，这样--build-arg传递的参数就能被swupd读取到：

FROM clearlinux:base
# 声明要接收的构建参数
ARG ALL_PROXY
# 将构建参数转为容器环境变量
ENV ALL_PROXY=$ALL_PROXY
RUN swupd bundle-add c-basic

然后执行构建命令（注意去掉参数值的单引号）：

docker build --build-arg=ALL_PROXY=socks5://proxy.company.com -t test-socks .

方案二：临时在构建命令中注入环境变量（不修改Dockerfile） #

如果你不想修改Dockerfile，可以在RUN命令前临时设置环境变量，但这种方式不够优雅：

FROM clearlinux:base
RUN ALL_PROXY=$ALL_PROXY swupd bundle-add c-basic

然后执行同样的构建命令（去掉单引号）：

docker build --build-arg=ALL_PROXY=socks5://proxy.company.com -t test-socks .

验证说明 #

两种方案都能让swupd正确读取到代理地址，解决超时问题。其中方案一更通用，适合需要在多个RUN命令中使用代理的场景。

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