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 是否正常运行

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

# 查看 Docker 版本
docker --version

# 运行测试容器
docker run hello-world

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

第四步：安装 Docker Compose Plugin

1. 创建插件目录

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

2. 下载 Docker Compose（ARM64 版本）

1
2
3

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

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

3. 添加执行权限

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

4. 验证安装

1	docker compose version

成功输出示例：

1	Docker Compose version v2.24.5

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

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

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

然后即可使用：

1	docker-compose --version

第五步：测试 Docker Compose

创建一个简单的测试文件：

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

运行测试：

1	docker compose up

预期输出：

1	test-1 \| Docker Compose on aarch64 works!

清理测试环境

1 2	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 文件后上传到服务器
确保系统架构正确，在 ARM64 系统上必须使用 aarch64 版本的软件包

常见问题

Q: Docker 服务无法启动？

检查系统日志：

1	sudo journalctl -u docker.service

Q: 提示权限不足？

确保当前用户已加入 docker 组：

1 2	sudo usermod -aG docker $USER newgrp docker

Q: 无法下载 Docker Compose？

可以尝试更换代理源或手动下载后上传：

1 2	# 手动下载地址示例 https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-linux-aarch64