Alliot's blog ·

Docker 代理配置机制与作用域

💡 原文中文，约2400字，阅读约需6分钟。

📝

内容提要

Docker代理配置涉及多层：CLI的config.json影响构建和容器运行，Dockerfile的ARG仅构建期有效，ENV写入镜像并影响运行时，dockerd的systemd代理仅影响拉取镜像。常见误区是ARG不会自动进入容器，config.json不仅影响构建。推荐显式传参，避免依赖自动注入。

🔎

延伸解读

代理配置层级与作用域

Docker 代理配置分布在多个层级，各自影响范围不同：CLI 的 config.json 影响构建和容器运行，Dockerfile 的 ARG 仅构建期有效，ENV 写入镜像并影响运行时，而 dockerd 的 systemd 代理仅影响拉取镜像。理解这些层级有助于避免配置错位，例如误以为 ARG 会自动进入容器，或认为 config.json 只影响构建。

常见误区与正确理解

常见误区包括：ARG 不会自动进入运行时容器，除非显式转换为 ENV；config.json 不仅影响构建，还会在 docker run 时自动注入代理环境变量。正确理解这些机制，可以避免在容器内代理失效或意外暴露代理设置。

Q&A

Docker中如何配置代理？

Docker代理配置有多个层级：CLI代理配置在~/.docker/config.json，影响docker build和docker run；Dockerfile中可用ARG和ENV设置代理，ARG仅构建期有效，ENV会写入镜像；dockerd代理通过systemd配置文件设置，仅影响拉取镜像等daemon操作。

~/.docker/config.json中的代理配置会影响哪些操作？

~/.docker/config.json中的代理配置会影响docker build和docker compose build（自动转为build-args），以及docker run和docker compose up（自动注入为容器环境变量）。

Dockerfile中的ARG和ENV在代理配置上有什么区别？

ARG定义的变量（如HTTP_PROXY）仅在构建阶段可用，不会自动出现在最终镜像中，必须通过--build-arg显式传入；ENV定义的变量会写入镜像元数据，运行容器时自动存在，且可被docker run -e覆盖。

如何为Docker daemon配置代理？

创建/etc/systemd/system/docker.service.d/http-proxy.conf文件，写入[Service]和Environment变量（如HTTP_PROXY、HTTPS_PROXY、NO_PROXY），然后执行systemctl daemon-reload和systemctl restart docker使配置生效。

dockerd的代理配置会影响哪些操作？

dockerd的代理配置仅影响daemon自身的网络行为，包括docker pull、docker login和registry通信，不会影响Dockerfile构建阶段和容器运行阶段。

Docker代理配置中常见的误区有哪些？

常见误区有两个：一是认为ARG会自动进入运行时容器，实际上ARG仅存在于构建阶段，除非显式转换为ENV；二是认为config.json仅影响build，实际上它同时影响docker build和docker run。

在Docker中推荐如何配置代理？

推荐实践：构建阶段显式传参，如docker build --build-arg HTTP_PROXY=...；运行阶段在compose文件中显式声明environment，不要依赖CLI自动注入；daemon代理仅在宿主机需要代理访问registry时启用。

🏷️