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

531 阅读2分钟

适用于:

  • 银河麒麟 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 -maarch64
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 文件后上传到服务器。