背景
在内网部署的 Debian 12 服务器上,docker pull 直接超时——auth.docker.io、registry-1.docker.io、github.com 这些公网域名 8 秒连不上。但同台机器上 https://www.jumpserver.org 又能正常访问。原因是出网被防火墙策略限制,只放行了少量白名单域名。
服务器上有一台可用的 HTTP 代理 http://192.168.9.3:7893(同端口也支持 SOCKS5,Clash 风格),可以把 Docker 守护进程的出站流量都转到这台代理上,从而恢复 docker pull。
原理
Docker 引擎的出站流量(包括拉镜像、查 tag、push 等)由 dockerd 进程发起。通过给 systemd 的 Docker service 写一个 drop-in 配置文件,往 dockerd 的环境里注入 HTTP_PROXY / HTTPS_PROXY,再 daemon-reload + systemctl restart docker,所有出站就会走代理。docker pull 立刻能用了。
下面所有命令后的输出都是真实的终端截取,不是示意。
【核心】配置步骤
步骤 1:创建 systemd drop-in 目录
mkdir -p /etc/systemd/system/docker.service.d
步骤 2:写 proxy.conf
cat > /etc/systemd/system/docker.service.d/proxy.conf <<EOF
[Service]
Environment="HTTP_PROXY=http://192.168.9.3:7893"
Environment="HTTPS_PROXY=http://192.168.9.3:7893"
Environment="NO_PROXY=localhost,127.0.0.1,192.168.9.0/24,*.local"
EOF
说明:NO_PROXY 里的 192.168.9.0/24 是这台服务器所在的私网网段,本地/内网通信不走代理,避免绕远。
步骤 3:重新加载配置并重启 Docker
systemctl daemon-reload
systemctl restart docker
步骤 4:验证代理生效
重启后 docker info 应该能看到代理字段:
$ docker info | grep -iE "proxy"
HTTP Proxy: http://192.168.9.3:7893
HTTPS Proxy: http://192.168.9.3:7893
No Proxy: localhost,127.0.0.1,192.168.9.0/24,*.local
实际拉一个 hello-world 验证:
$ docker pull hello-world
Using default tag: latest
latest: Pulling from library/hello-world
4f55086f7dd0: Pull complete
Digest: sha256:11a3eb1597e864c51b3f56733cb2e8a90bf0c284bfc05f9444d81c558bc848aa
Status: Downloaded newer image for hello-world:latest
$ docker run --rm hello-world
Hello from Docker!
This message shows that your installation appears to be working correctly.
拉得动,代理就配通了。✅
如何恢复(回到配代理之前)
如果哪天代理服务器下线了,或者你想撤掉代理直接走公网,反向操作三步:
步骤 1:删掉 drop-in 配置文件
rm -f /etc/systemd/system/docker.service.d/proxy.conf
# 如果目录下空了可以连目录一起删(确认没别的东西再删)
# rmdir /etc/systemd/system/docker.service.d
步骤 2:重新加载并重启 Docker
systemctl daemon-reload
systemctl restart docker
步骤 3:验证代理已移除
$ docker info | grep -iE "proxy"
# 应该没有任何输出(说明 HTTP Proxy / HTTPS Proxy 都没了)
如果 docker pull 又开始超时了,说明你的服务器确实没有直连公网,需要保留代理。
顺带:升级 Docker 引擎(静态二进制方式)
如果你的 Docker 当时是用 get-docker.sh 或静态 tarball 装的(dpkg -l | grep docker 为空,/etc/apt/sources.list.d/ 也没有 docker 源),推荐用同样方式升级,避免引入 apt 源依赖。
找最新版本
curl -sS https://download.docker.com/linux/static/stable/x86_64/ \
| grep -oE "docker-[0-9.]+\.tgz" | sort -V | tail -1
# 比如输出:docker-29.9.1.tgz
备份 + 替换 + 重启
# 备份旧的二进制(出问题可回滚)
BACKUP=/opt/docker-backup-$(date +%Y%m%d-%H%M%S)
mkdir -p $BACKUP
for b in /usr/bin/docker /usr/bin/dockerd /usr/bin/containerd \
/usr/bin/runc /usr/bin/docker-init /usr/bin/docker-proxy; do
[ -f "$b" ] && cp -p "$b" $BACKUP/
done
# 停 Docker,下载新版,解压,替换
systemctl stop docker
curl -fsSL https://download.docker.com/linux/static/stable/x86_64/docker-29.9.1.tgz \
-o /tmp/docker.tgz
tar -xzf /tmp/docker.tgz -C /tmp
cp -f /tmp/docker/* /usr/bin/
systemctl start docker
docker --version # 验证
dockerd --version
运行中的容器会被 restart=always 策略自动拉起来,短暂(约 5–10 秒)重启后全部恢复。
顺带:升级 Docker Compose v2 插件
Compose v2 是 Docker CLI 的插件(docker compose 子命令),不是独立的 docker-compose 二进制。升级它:
# 查最新版本
TAG=$(curl -sS https://api.github.com/repos/docker/compose/releases/latest \
| python3 -c "import sys,json;print(json.load(sys.stdin)['tag_name'])")
# 备份并下载新版到 cli-plugins 目录
PLUGIN_DIR=/usr/local/lib/docker/cli-plugins
mkdir -p $PLUGIN_DIR
[ -f $PLUGIN_DIR/docker-compose ] && cp -p $PLUGIN_DIR/docker-compose \
/opt/docker-backup-$(date +%Y%m%d)/docker-compose
curl -fsSL https://github.com/docker/compose/releases/download/$TAG/docker-compose-linux-x86_64 \
-o $PLUGIN_DIR/docker-compose
chmod +x $PLUGIN_DIR/docker-compose
docker compose version # 验证
容器镜像升级的两个坑
用 docker run 部署的容器(不是 docker-compose),升级镜像 tag 时容易踩两个坑:
坑 1:网络别名 --network-alias 容易丢
JumpServer 的 Redis 和 PostgreSQL 容器在用户自定义网桥 jms_net 上挂了短别名 redis 和 postgresql,让应用容器能用 REDIS_HOST=redis 这种短名连接。用 docker run 重建时如果忘了带 --network-alias redis,应用就报 Name or service not known。重建前一定要 inspect 旧容器把 NetworkSettings.Networks.<net>.Aliases 一并搬过去。
坑 2:healthcheck 默认不会复制
自己用脚本 docker run 重建时,--health-cmd 那些 flag 很容易漏,结果新容器没 healthcheck,docker ps 看不到健康状态。重新 inspect 旧容器的 Config.Healthcheck(含 Test / Interval / Timeout / Retries / StartPeriod),完整复制。
总结
内网服务器拉不了 Docker 镜像?给 Docker daemon 加个 systemd drop-in 配 HTTP 代理是最干净的解法——不用改业务镜像、不用装 nginx 转发、几行配置重启就生效。配上后顺便可以平滑升 Docker 引擎和 Compose,升级容器时记得带网络别名和 healthcheck。
本文所有命令都来自真实操作环境,可直接复制使用。

我也遇到这样的问题,国内升级太慢了,要不走代理,要不设置镜像加速跑!!