本篇要点
- 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 也一样吗?
类似,需在节点级配置。