【信创】Docker‑Compose V2 两种离线部署（独立模式、插件模式）简易教程

Docker‑Compose V2 两种离线部署简易教程（aarch64，适合信创静态docker二进制）

前提物料：已经拿到二进制文件 docker‑compose‑linux‑aarch64，同一个二进制文件，只是放不同目录，调用命令不一样。

模式一：独立二进制模式（带横杠 docker‑compose，你外网脚本在用）

特点：直接作为独立程序运行；不依赖docker内部插件扫描；目录天然存在，静态docker离线部署几乎零坑。

离线部署脚本片段

# 复制二进制，重命名为docker‑compose
cp ./docker-compose-linux-aarch64 /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
# 做软链接，兼容PATH环境差异
ln -sf /usr/local/bin/docker-compose /usr/bin/docker-compose

使用命令（带横杠）

#查看版本
docker-compose -v

#业务操作
docker-compose up -d
docker-compose logs -f
docker-compose down

原理

bash在系统$PATH路径直接寻找名叫docker‑compose可执行文件，直接运行，docker主程序完全不参与。

优缺点

✅优点：部署简单，不需要创建额外目录；不受docker cli插件逻辑影响，离线信创兼容性最好。

❌缺点：不能识别docker全局参数，例如 docker‑compose --debug up‑d 不生效；属于兼容遗留模式。

---

模式二：CLI‑Plugin插件模式（空格 docker compose，官方未来标准）

特点：二进制放到docker插件专用目录；由docker主程序内部扫描加载插件 ，不是shell直接调用。

⚠️重点：静态解压docker二进制不会自动创建/usr/local/lib/docker/cli‑plugins目录，必须手动mkdir‑p，否则cp直接报错文件目录不存在。

离线部署脚本片段

#必须先创建插件目录！！静态docker不会自带
mkdir -p /usr/local/lib/docker/cli-plugins
#复制二进制，文件名依然叫 docker‑compose（带横杠）
cp ./docker-compose-linux-aarch64 /usr/local/lib/docker/cli-plugins/docker-compose
chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

使用命令（中间是空格，不带横杠）

#查看版本
docker compose version

#业务操作
docker compose up -d
docker compose logs -f
docker compose down

原理

输入docker compose up‑d，首先执行docker本体程序；docker内部扫描插件目录，找到docker‑compose二进制，拉起进程并转发参数。磁盘上文件名依然是docker‑compose，没有叫compose的文件。

优缺点

✅优点：官方演进方向；支持docker全局参数：docker --debug compose up‑d；docker info可查看已加载插件。

❌缺点：必须手动创建插件目录；极少数国产系统会出现docker cli识别不到插件的诡异问题。

---

推荐生产交付折中方案（双部署，兼顾标准+兜底，你的项目直接用）

同时部署两种模式；脚本优先用官方插件模式；现场异常可以切独立二进制应急。

#1.插件模式（优先使用 docker compose 空格）
mkdir -p /usr/local/lib/docker/cli-plugins
cp ./docker-compose-linux-aarch64 /usr/local/lib/docker/cli-plugins/docker-compose
chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

#2.独立二进制兜底（应急使用 docker‑compose 带横杠）
cp ./docker-compose-linux-aarch64 /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
ln -sf /usr/local/bin/docker-compose /usr/bin/docker-compose

校验两条命令都要能输出版本：

docker compose version    #优先业务脚本使用
docker-compose -v         #现场故障兜底手动执行

业务脚本统一写：docker compose up -d；当插件模式识别异常，运维人员手动敲docker‑compose up‑d恢复业务。

关键避坑清单

1. 不要脚本内混用两种写法，一部分写空格、一部分写横杠，会导致容器名、网络、卷命名不一致，出现业务异常。
2. 插件模式一定要写mkdir‑p，静态二进制docker不会自动生成cli‑plugins文件夹。
3. 二进制架构必须匹配服务器CPU（aarch64，不要用x86_64）。
4. 离线交付物料只需要一份docker‑compose‑linux‑aarch64，双部署只是复制两份副本到不同目录。