银河麒麟 / aarch64 系统：Docker + Docker Compose 完整安装教程

适用于：

• 银河麒麟 V10 / Advanced Server
• CPU 架构：aarch64（ARM64）
• 系统基于 RHEL/CentOS 或 openEuler

---

🔍 第一步：确认系统信息

# 查看操作系统
cat /etc/os-release

# 查看 CPU 架构（必须是 aarch64）
uname -m

✅ 正确输出应包含：

aarch64

---

🐳 第二步：安装 Docker Engine（如未安装）

方法 A：使用官方脚本（推荐，自动适配架构）

# 下载并运行 Docker 官方安装脚本（支持 aarch64）
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 将当前用户加入 docker 组（避免每次用 sudo）
sudo usermod -aG docker $USER

# 重新登录或执行以下命令激活组权限
newgrp docker

💡 注：get.docker.com 脚本会自动识别 aarch64 并安装对应版本的 Docker。

方法 B：手动配置 YUM 源（适用于离线或安全环境）

如果你不能联网或需使用国产源，请参考银河麒麟官方文档配置 Docker CE 源。此处略。

---

🔌 第三步：验证 Docker 是否正常运行

# 启动并设置开机自启
sudo systemctl enable --now docker

# 测试
docker --version
docker run hello-world

如果 hello-world 报错，说明 Docker 未正确安装或网络受限，请先解决 Docker 问题。

---

🧩 第四步：安装 Docker Compose Plugin（aarch64 版本）

1. 创建插件目录

sudo mkdir -p /usr/local/lib/docker/cli-plugins

2. 下载最新版 Docker Compose（ARM64）

# 设置版本（可替换为最新版：https://github.com/docker/compose/releases）
VERSION="v2.24.5"

# 使用代理加速下载（国内推荐）
sudo curl -L "https://ghproxy.com/https://github.com/docker/compose/releases/download/${VERSION}/docker-compose-linux-aarch64" \
  -o /usr/local/lib/docker/cli-plugins/docker-compose

如果你无法访问 GitHub，可提前在其他机器下载后传入。

3. 添加执行权限

sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

4. 验证安装

docker compose version

✅ 成功输出示例：

Docker Compose version v2.24.5

---

🔁 （可选）创建传统 docker-compose 命令别名

如果你习惯使用 docker-compose（带连字符），可创建软链接：

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

然后即可使用：

docker-compose --version

---

🧪 第五步：测试 Docker Compose

创建一个简单测试文件：

cat > docker-compose.yml <<EOF
version: '3'
services:
  test:
    image: alpine
    command: echo "Docker Compose on aarch64 works!"
EOF

# 运行
docker compose up

✅ 输出应包含：

test-1  | Docker Compose on aarch64 works!

---

🧹 清理（可选）

docker compose down
rm docker-compose.yml

---

✅ 总结

步骤	操作
1	确认 uname -m 为 aarch64
2	安装 Docker（使用 get.docker.com 脚本）
3	下载 ARM64 版本 的 docker-compose-linux-aarch64
4	放入 /usr/local/lib/docker/cli-plugins/
5	使用 docker compose 命令

---

❗ 注意事项

• 不要尝试 yum install docker-compose-plugin ------ 国产系统仓库通常无此包。
• 不要下载 x86_64 版本，否则会报错：Exec format error。
• 如遇网络问题，可手动下载 .aarch64 文件后上传到服务器。

---