docker-compose-linux-aarch64 原理 + 安装命令
适用:飞腾FT2000+/D2000、银河麒麟V10、统信UOS ARM64(aarch64)
文件:docker-compose-linux-aarch64 是 Compose V2,Go语言静态编译单ELF二进制
一、安装原理
docker-compose-linux-aarch64:Linux aarch64架构静态可执行程序,内置全部依赖,不需要Python,不需要yum/apt安装包。
- 文件名后缀 -linux-aarch64:标识目标系统+CPU架构。
- 它只是Docker API客户端,本身不启动容器,通过 /var/run/docker.sock 和 dockerd(Docker守护进程)通信,解析yaml,下发创建容器/网络/卷指令。
| 模式 | 存放路径 | 调用命令 | 原理 |
|—|—|—|—|
| Docker CLI插件模式(推荐) | /usr/local/lib/docker/cli-plugins/docker-compose | docker compose up(空格) | docker CLI启动时扫描cli-plugins目录,找到名为docker-compose的二进制,fork执行,转发参数 |
| 独立二进制模式 | /usr/local/bin/docker-compose | docker-compose up(横杠) | 作为独立程序放入PATH环境变量目录,直接运行,兼容旧脚本 |
安装本质只有3步:移动文件 → 重命名 → 添加执行权限,没有安装包写入系统数据库。
二、安装命令(文件在当前目录:./docker-compose-linux-aarch64)
方案A:CLI插件模式(推荐,支持 docker compose)
# 创建插件目录
mkdir -p /usr/local/lib/docker/cli-plugins
# 将当前目录二进制移动并重命名
mv ./docker-compose-linux-aarch64 /usr/local/lib/docker/cli-plugins/docker-compose
# 添加执行权限
chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
# 可选:软链接,兼容旧命令 docker-compose
ln -s /usr/local/lib/docker/cli-plugins/docker-compose /usr/local/bin/docker-compose
# 校验
docker compose version
docker-compose –version
方案B:独立二进制(简单,仅支持 docker-compose)
mv ./docker-compose-linux-aarch64 /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
# 验证
docker-compose –version
三、卸载命令
rm -f /usr/local/lib/docker/cli-plugins/docker-compose
rm -f /usr/local/bin/docker-compose
四、常见报错原理
- 文件名不对,不能带 -linux-aarch64;
- 放错目录,缺少执行权限。
五、测试compose.yml(快速验证)
version: "3"
services:
hello:
image: hello–world
执行:
docker compose up





