技术 / 容器

Docker 不走代理:因为你不是它

你在终端里设了 HTTPS_PROXY,只对当前 shell 生效。拉镜像的是后台守护进程,它读的是自己的配置。

Docker代理路由
本篇要点
  • docker pull 由守护进程发起,不继承终端环境变量。
  • 守护进程代理要写在 systemd 的 drop-in 里并重载。
  • TUN 接管默认路由后,容器网段要显式排除。

为什么不生效

Docker 是客户端-守护进程架构。你在终端里 export HTTPS_PROXY,只对当前 shell 生效;真正发请求的是后台服务,它读自己的环境。

三种做法

方式作用范围适用
守护进程代理所有 pull/push长期方案
容器内环境变量容器内进程容器访问外网
TUN 模式整机流量临时或统一接管

守护进程配置

推荐用 systemd drop-in,改完 daemon-reload 再重启:

mkdir -p /etc/systemd/system/docker.service.d
cat > /etc/systemd/system/docker.service.d/proxy.conf <

TUN 与网段冲突

TUN 接管默认路由后,容器网段(常见 172.17.0.0/16)可能被一并劫持,表现为容器间通信异常或 DNS 失败。解法是把容器与内网网段加入绕过列表。

镜像加速器的边界

加速器把镜像缓存到国内节点,解决的是速度,不解决「某些镜像根本不允许从本地访问」。两者要分开判断:能 pull 但很慢是速度问题,pull 直接 403 是权限或策略问题。

怎么确认配置生效

执行 docker info,输出的末尾会列出 HTTP Proxy 与 HTTPS Proxy。为空说明 drop-in 没生效,常见原因是路径写错或没 daemon-reload。

容器内访问外网的两种写法

临时调试用 --env HTTPS_PROXY=... 就够了;长期跑的服务更适合在 compose 的 environment 里写死,或直接让容器走宿主 TUN。注意容器里的 127.0.0.1 是容器自己,指向宿主机要写宿主的局域网地址。

如果只有个别镜像拉不动而其他正常,先怀疑该镜像的仓库策略(403、429),而不是代理没配好。这两类问题的表现很像,但一个是网络,一个是权限。

常见问题

改完要重启吗?

要,daemon-reload 后重启服务。

容器内 curl 不通?

给容器设代理或让它走宿主 TUN。

影响本地网络吗?

守护进程代理只影响 Docker。

K8s 也一样吗?

类似,需在节点级配置。