背景
接手一台内网 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
