离线升级docker compose和修改自定网络

升级到 Compose v2 + Docker 20.10+

Docker 在宿主机重启后，找不到容器原来连接的那个网络（ID：b256217ba0f0…）。
网络是“临时”的（compose 默认创建的网络在 /var/lib/docker/network/files/ 里，不会随宿主机重启而持久化），所以重启后网络消失，容器再启动就报 network … not found，只能手动 docker compose down && docker compose up -d 重新创建。

根本原因是：你用的是旧版 docker-compose（v1）或旧版 Engine，默认网络驱动是 bridge，且没有持久化；而容器在重启时会尝试重新加入“旧网络”，但旧网络已随宿主机重启被清空。

解决思路：让网络“长存”，或者让容器不再依赖“旧网络”。

一、准备安装包（在有外网的机器下好，拷进内网）

Docker 引擎
到 https://download.docker.com/linux/static/stable/x86_64/ 下载 docker-20.10.xx.tgz（20.10 以上才带 compose 插件支持）。
Docker Compose
到 https://github.com/docker/compose/releases 下载 docker-compose-linux-x86_64（就是 compose v2 单文件二进制）。
systemd 单元文件
新建一个 docker.service，内容见下一步。

二、安装步骤（内网机器执行）

# 1. 解压引擎并放到系统目录
tar -xzf docker-20.10.xx.tgz
cp docker/* /usr/bin/

# 2. 注册 systemd 服务
cat > /etc/systemd/system/docker.service <<'EOF'
[Unit]
Description=Docker Application Container Engine
Documentation=https://docs.docker.com
After=network-online.target firewalld.service
Wants=network-online.target

[Service]
Type=notify
ExecStart=/usr/bin/dockerd
ExecReload=/bin/kill -s HUP $MAINPID
LimitNOFILE=infinity
LimitNPROC=infinity
LimitCORE=infinity
Delegate=yes
KillMode=process
Restart=on-failure
StartLimitBurst=3
StartLimitInterval=60s

[Install]
WantedBy=multi-user.target
EOF

# 3. 安装 compose v2（单文件即插即用）
chmod +x docker-compose-linux-x86_64
mv docker-compose-linux-x86_64 /usr/local/bin/docker-compose
ln -s /usr/local/bin/docker-compose /usr/local/lib/docker/cli-plugins/docker-compose

# 4. 启动 Docker
systemctl daemon-reload
systemctl enable --now docker

# 5. 验证
docker version          # Server ≥20.10
docker compose version  # 能看到 v2.xx 即成功

[root@KylinV10 data]# cp -rf docker/* /usr/bin/
cp：是否覆盖'/usr/bin/containerd'？ yes
cp：是否覆盖'/usr/bin/containerd-shim-runc-v2'？ yes
cp：是否覆盖'/usr/bin/ctr'？
---------------------------------
用 \cp 调用原生命令，屏蔽系统 alias：
\cp -rf docker/* /usr/bin/

[root@KylinV10 data]# ln -s /usr/local/bin/docker-compose /usr/local/lib/docker/cli-plugins/docker-compose
ln: 无法创建符号链接 '/usr/local/lib/docker/cli-plugins/docker-compose': 文件已存在
[root@KylinV10 data]#

先删掉旧的软链接，再重新建：

rm -f /usr/local/lib/docker/cli-plugins/docker-compose
ln -s /usr/local/bin/docker-compose /usr/local/lib/docker/cli-plugins/docker-compose

systemctl daemon-reload
systemctl restart docker
docker compose version
docker version

[root@KylinV10 data]# docker version
Client:
 Version:           29.1.3
 API version:       1.52
 Go version:        go1.25.5
 Git commit:        f52814d
 Built:             Fri Dec 12 14:48:47 2025
 OS/Arch:           linux/amd64
 Context:           default
Error response from daemon: client version 1.52 is too new. Maximum supported API version is 1.39
[root@KylinV10 data]# docker compose version
Docker Compose version v5.0.0
[root@KylinV10 data]#

刚装的 Docker CLI 是 29.1.3，但 后台 daemon 还是旧版（API 1.39），所以 CLI 提示版本过高，无法通信。

升级必须 连 daemon 一起换掉，否则只能降 CLI 版本——离线环境最简单的做法就是：

先把旧 daemon 停掉
systemctl stop docker
用刚才解压出来的 同版本 dockerd 覆盖
\cp -f docker/dockerd /usr/bin/
重新加载并启动
systemctl daemon-reload
systemctl start docker
再验证
docker version          # 两边都应为 29.1.3，API 1.52
docker compose version  # v5.0.0 正常

重启宿主机

{/collapse-item}
{collapse-item label="创建并加入自定义网络"}

创建并加入自定义网络

bridge 是 Docker 的默认网络名字，但它有两个硬伤：

1、默认 bridge 不支持容器互相通过名称解析（只能走 IP）；
自定义 bridge（oracle_net）自带内嵌 DNS，容器之间 ping 容器名 直接通。

2、默认 bridge 在宿主机重启后不会自动重建你之前通过 docker run --net bridge ... 启动的容器网络配置；

而 compose 自己建的那个临时 bridge（ID 很长）重启会消失，于是出现 network not found。

把网络显式建出来并设成 external: true，相当于告诉 compose：

“这网我自己管，重启也在，你别删。”

创建网络：在宿主机上一次性创建该网络（比如web_network以后一直存在，重启也不丢）

docker network create web_network

把正在跑的项目切到这个持久化网络即可，三步完成：

1、把 compose 文件末尾的 networks 段改成：

networks:
  web_network:
    external: true

2、给每个 service 显式指定网络（如果你之前已经写了 networks: - web_network 可跳过）
示例：

services:
  nginx:
    networks:
      - web_network
  tomcat:
    networks:
      - web_network

3、重新应用

docker compose down   # 停旧容器、清掉旧的“临时”网络
docker compose up -d  # 用新的持久网络重新创建容器

完成后验证：

docker network ls        # 能看到 web_network
docker inspect web_network  # 容器已挂进去
reboot                   # 宿主机重启
docker compose start     # 不再报 “network not found”

以后任何其他 compose 项目只要：

networks:
  default:
    external: true
    name: web_network

同网络下的互访

只要满足下面两点，就可以“容器名 + 端口”互相访问：
它们挂在同一个自定义 bridge 网络（这里就是 web_network）；
目标容器监听了对应端口（EXPOSE 或 -p 都可以，不需要映射到宿主机）。
nginx 容器内部监听 80
tomcat 容器内部监听 8080
同一 web_network 下：

在 tomcat 容器里
curl http://nginx:80
在 nginx 容器里
curl http://tomcat:8080

Docker 的内嵌 DNS 会把容器名自动解析成各自的内网 IP，所以跨容器通信无需再记 IP，也无需暴露宿主机端口。

{/collapse-item}