Linux系统安装 Docker Compose V2 插件

新版 Docker 装完默认没有 docker compose，docker-compose 又是 Python 写的旧版，在麒麟上动不动报 KeyError: 'ContainerConfig'。装官方 V2 插件最省事，两种方式任选其一。

1. 确认系统与架构

麒麟桌面版多基于 Ubuntu、服务器版多基于 CentOS，先确认一下，后面选 apt 还是 yum 就清楚了：

cat /etc/os-release        # 看 ID / VERSION_ID
uname -m                   # x86_64 还是 aarch64（飞腾、鲲鹏是 aarch64）
docker -v                  # 确认 Docker 本体已装好

顺手看看是不是已经装过了：

docker compose version
ls /usr/local/lib/docker/cli-plugins/

2. 方式一：包管理器安装（推荐）

系统已经配好 Docker 官方源的话，直接装插件包：

# Debian / Ubuntu 系（麒麟桌面版）
sudo apt-get update
sudo apt-get install -y docker-compose-plugin

# RHEL / CentOS 系（麒麟服务器版）
sudo yum install -y docker-compose-plugin
# 或
sudo dnf install -y docker-compose-plugin

如果提示找不到包，说明没配官方源，直接跳到第 3 节手动装，比折腾源快。

3. 方式二：手动下载二进制（通用）

# 1. 设置版本和架构，麒麟常见为 aarch64 或 x86_64
COMPOSE_VER=v2.29.7
ARCH=$(uname -m)
case "$ARCH" in
  x86_64) DARCH=x86_64 ;;
  aarch64|arm64) DARCH=aarch64 ;;
  *) echo "不支持的架构: $ARCH"; exit 1 ;;
esac

# 2. 下载到 Docker CLI 插件目录
sudo mkdir -p /usr/local/lib/docker/cli-plugins
sudo curl -fsSL "https://github.com/docker/compose/releases/download/${COMPOSE_VER}/docker-compose-linux-${DARCH}" \
  -o /usr/local/lib/docker/cli-plugins/docker-compose

# 3. 赋予执行权限
sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

# 4. 验证
docker compose version

系统级目录不生效的话，放用户级插件目录：

mkdir -p ~/.docker/cli-plugins
mv /usr/local/lib/docker/cli-plugins/docker-compose ~/.docker/cli-plugins/

GitHub 下载慢或超时，可以在 URL 前加第三方加速前缀（如 https://ghfast.top/https://github.com/...），或用能联网的机器下载后 scp 过去。架构一定要对，aarch64 机器装了 x86_64 的二进制会报 exec format error。

4. 验证与权限

docker compose version     # 输出 Docker Compose version v2.x.x 即成功

提示权限不足就把当前用户加进 docker 组，重新登录生效：

sudo usermod -aG docker $USER
newgrp docker              # 或注销重登
docker compose version