Debian 12 服务器升级实战:Docker 代理配置详解(含恢复)+ JumpServer v4.8.1 → v4.10.19

背景

接手一台内网 Debian 12 服务器(192.168.3.0/24 网段),上面跑着 JumpServer 堡垒机(8 个容器,v4.8.1-ce)。这次要做一次彻底升级:系统安全补丁、Docker 引擎、Compose、容器基础镜像,以及 JumpServer 本身从 v4.8.1 升到 v4.10.19。

整个过程最折腾的一环是 Docker 的代理配置——服务器所在网段无法直连 Docker Hub,代理地址还经历了「猜错 → 排查 → 修正」的波折。本文就把代理这部分单独拎出来详细讲,并附上如何恢复(移除代理)的方法。下文所有命令后的输出都是真实终端截取,不是示意。

一、环境总览

  • OS:Debian 12 (bookworm),内核 6.1.0-53
  • Docker 27.4.0(静态二进制安装,路径 /usr/local/bin/),Compose v2.31.0
  • JumpServer v4.8.1-ce(8 容器:core / web / celery / koko / lion / chen + postgres 16.3-bullseye + redis 7.0-bullseye)
  • 网络:192.168.3.0/24,网关 192.168.3.1;与 192.168.9.0/24 网段隔离(3.x → 9.x 不通)

二、系统安全补丁升级

先看有哪些可升级的包:

apt-get update
apt list --upgradable

共 16 个安全更新,全部来自 Debian 官方安全源(openssl、perl、python3.11 等)。直接升级:

DEBIAN_FRONTEND=noninteractive apt-get -y upgrade

升级后 openssl 3.0.22,再查 apt list --upgradable 已无遗留包。

三、Docker 引擎与 Compose 升级

这台是静态二进制安装(不是 apt 装的),所以升级要走「下载 tarball 替换二进制」的路子。先确认安装方式与路径:

docker --version        # 27.4.0
which docker dockerd    # /usr/local/bin/

下载新版并备份旧二进制(下载走代理,见第四节):

curl -x http://192.168.3.3:1082 -L -o /tmp/docker-29.9.1.tgz \
  https://download.docker.com/linux/static/stable/x86_64/docker-29.9.1.tgz
tar tzf /tmp/docker-29.9.1.tgz   # 查看内容

mkdir -p /opt/docker-backup-$(date +%Y%m%d-%H%M%S)
cp -a /usr/local/bin/docker /usr/local/bin/dockerd /usr/local/bin/containerd \
      /usr/local/bin/containerd-shim-runc-v2 /usr/local/bin/ctr \
      /usr/local/bin/docker-init /usr/local/bin/docker-proxy /usr/local/bin/runc \
      /opt/docker-backup-xxxxx/

停 Docker、替换、重启:

systemctl stop docker
tar xzf /tmp/docker-29.9.1.tgz
cp /tmp/docker/* /usr/local/bin/
systemctl start docker
docker version   # 29.9.1

⚠️ 踩坑:直接 cp 会报 containerd-shim-runc-v2: 文本文件忙(text file busy),因为运行中的容器还在用这个二进制。解决:先 mv 旧文件到 .old(重命名不影响运行中的进程),再 cp 新的。

mv /usr/local/bin/containerd-shim-runc-v2 /usr/local/bin/containerd-shim-runc-v2.old
cp /tmp/docker/containerd-shim-runc-v2 /usr/local/bin/containerd-shim-runc-v2

Compose 同理(插件路径 /usr/local/libexec/docker/cli-plugins/):

curl -x http://192.168.3.3:1082 -L -o /tmp/docker-compose \
  https://github.com/docker/compose/releases/download/v5.6.0/docker-compose-linux-x86_64
chmod +x /tmp/docker-compose
cp /tmp/docker-compose /usr/local/libexec/docker/cli-plugins/docker-compose
docker compose version   # v5.6.0

四、配置 Docker 代理(重点详解)

4.1 为什么需要代理

Docker Hub(registry-1.docker.io / auth.docker.io)在服务器上直连超时:

curl -s -o /dev/null -w '%{http_code}
' --max-time 8 https://registry-1.docker.io/v2/
# 超时 / 000

但 deb.debian.org、download.docker.com 等能直连。说明出网策略是「白名单」式,Docker Hub 不在白名单里,必须走代理。

4.2 先排查:代理地址到底通不通(最容易踩的坑)

这一步最容易被忽略。我一开始拿到两个代理地址,结果都没生效,于是逐个排查:

① 192.168.9.3:7893(另一个网段的代理)——ping 100% 丢包,traceroute 过网关就断:

ping -c 4 192.168.9.3          # 100% packet loss
ip route get 192.168.9.3       # via 192.168.3.1(路由存在)
traceroute -n 192.168.9.3      # 第 1 跳到网关后全部 * * *

结论:这台服务器在 192.168.3.0/24,到 192.168.9.0/24 被防火墙挡了,够不着 9.x 的代理。

② 192.168.3.3:7893(同网段但端口错)——connection refused:

bash -c 'echo > /dev/tcp/192.168.3.3/7893'
# bash: connect: 拒绝连接

结论:192.168.3.3 这台机器是通的,但 7893 端口没有服务监听(代理实际监听在 1082 端口)。

③ 最终确认可用的代理 192.168.3.3:1082:

curl -x http://192.168.3.3:1082 -s -o /dev/null -w '%{http_code}
' \
  https://registry-1.docker.io/v2/
# 401(registry 的 /v2/ 需要认证,未认证返回 401 即代表能通)

4.3 配置 daemon 代理(systemd drop-in)

Docker 的出站流量由 dockerd 进程发起,把代理环境变量注入 dockerd 即可。写一个 systemd drop-in:

mkdir -p /etc/systemd/system/docker.service.d
cat > /etc/systemd/system/docker.service.d/proxy.conf <<'EOF'
[Service]
Environment="HTTP_PROXY=http://192.168.3.3:1082"
Environment="HTTPS_PROXY=http://192.168.3.3:1082"
Environment="NO_PROXY=localhost,127.0.0.1,192.168.3.0/24,172.17.0.0/16,192.168.250.0/24,*.local"
EOF

说明:

  • HTTP_PROXY / HTTPS_PROXY:代理地址。Docker 拉镜像走 HTTPS,CONNECT 隧道也走这个 HTTP 代理。
  • NO_PROXY:不走代理的地址。localhost、本网段、docker 桥接网段都加进去,避免内网流量绕代理。

重载并重启:

systemctl daemon-reload
systemctl restart docker

注意:如果 daemon.json 里配了 "live-restore": true,重启 dockerd 时容器不会中断。

4.4 验证代理生效

docker info | grep -i proxy
# HTTP Proxy: http://192.168.3.3:1082
# HTTPS Proxy: http://192.168.3.3:1082

docker pull hello-world   # 走代理拉取成功

4.5 如何恢复(移除代理)

方法一:直接删掉 drop-in 文件,恢复直连:

rm -f /etc/systemd/system/docker.service.d/proxy.conf
systemctl daemon-reload
systemctl restart docker
docker info | grep -i proxy   # 不再显示代理

方法二:保留文件,改地址或清空代理(临时关闭):

# 编辑 /etc/systemd/system/docker.service.d/proxy.conf
# 删除三行 Environment,或改成新的代理地址
systemctl daemon-reload
systemctl restart docker

一句话总结:代理的开关就是 systemd drop-in 里那三行 Environment,改完 daemon-reload + restart docker 即可生效或失效。

五、容器镜像升级(postgres / redis)

代理配好后镜像就能拉了。基础镜像比较旧(bullseye),升级到 bookworm:

docker pull postgres:16-bookworm
docker pull redis:7.4-bookworm

重建这两个容器时务必保留网络别名——JumpServer 的 core 用短名 postgresql / redis 连接,别名丢了会报 Name or service not known:

docker inspect jms_postgresql --format '{{json .NetworkSettings.Networks}}'
# Aliases: ["jms_postgresql","postgresql"]

重建 postgres(保留别名 + 健康检查,数据是 bind mount 不会丢):

docker stop jms_postgresql && docker rm jms_postgresql
docker run -d --name jms_postgresql \
  --network jms_net --network-alias jms_postgresql --network-alias postgresql \
  --restart always \
  -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=你的密码 -e POSTGRES_DB=jumpserver \
  -v /data/jumpserver/postgresql/data:/var/lib/postgresql/data \
  --health-cmd 'pg_isready -q -U $POSTGRES_USER' --health-interval 10s --health-timeout 5s --health-retries 3 \
  postgres:16-bookworm

redis 同理(命令参数 redis-server /etc/redis.conf --requirepass 你的密码)。重建后 postgres 日志可能有 collation 警告,刷一下版本号即可:

ALTER DATABASE jumpserver REFRESH COLLATION VERSION;

六、JumpServer v4.8.1 → v4.10.19 升级

先确认版本与最新版:当前 v4.8.1-ce(2025-03),最新 v4 线是 v4.10.19-ce(2026-08),欠了约一年半的安全更新。官方升级顺序要求 core → web → celery → koko/lion/chen,core 要先跑数据库迁移。

① 升级前备份数据库:

docker exec -e PGPASSWORD=你的密码 jms_postgresql \
  pg_dump -U postgres -Fc jumpserver > /opt/jumpserver-backup-xxx.dump

② 拉取新镜像(5 个组件 + celery 复用 core 镜像):

docker pull jumpserver/core:v4.10.19-ce
docker pull jumpserver/web:v4.10.19-ce
docker pull jumpserver/koko:v4.10.19-ce
docker pull jumpserver/chen:v4.10.19-ce
# lion 暂不升(见下面坑)

③ 按顺序重建。core 先(跑迁移),迁移日志会显示一堆 Applying xxx... OK,最后 JumpServer version v4.10.19。等 core healthy 后再重建 web、celery、koko、chen(重建时保留原有环境变量、挂载和网络别名)。

docker logs --tail 20 jms_core
# Applying tickets.0007_ticketflow_name... OK
# ...
# JumpServer version v4.10.19

⚠️ 坑:jumpserver/lion:v4.10.19-ce 镜像的 entrypoint 会去跑 supervisord,但这个镜像没装 supervisord,会导致 lion 崩溃循环。所以 lion 保留 v4.8.1-ce(它与 v4.10.19 的 core 兼容),等上游修复后再单独升。

七、验证与回滚

docker ps
# 8 个容器全部 healthy
  • 8 容器 healthy,API 健康检查 200,网络别名解析正常。
  • 回滚:旧镜像 v4.8.1-ce 都还在本地,数据是 bind mount(不随容器删除),pg_dump 备份在 /opt/。

总结

这次升级覆盖了系统补丁、Docker 引擎/Compose、容器镜像、JumpServer 四个层面。最关键的教训:配代理前一定先验证代理地址是否可达(同网段 ≠ 能通,端口也要对),否则配了也是白配;而代理的开关就是 systemd drop-in 里那三行 Environment,改完 reload + restart 即生效。希望对你有帮助。

Ventoy2Disk 图文教程:把移动硬盘做成多合一启动盘(100MB 本体 + 独立数据分区):https://www.hao0564.com/6425.html

发表回复

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