Debian 12 Docker 拉镜像超时?给 Docker daemon 配 HTTP 代理一步到位(含恢复方法 + 引擎/Compose 升级)

背景

在内网部署的 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。

本文所有命令都来自真实操作环境,可直接复制使用。

一条评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注