跳转至

好的，以下是适用于 Ubuntu（特别是 22.04 / 24.04 等较新版本）的 Docker Compose 安装完整教程文档，包含两种方法（推荐与备用方案），并附带验证步骤和常见问题说明。

📘 Docker Compose 安装文档（Ubuntu）

📌 背景说明

Docker Compose 有两个版本：

类型 命令形式 状态说明
独立二进制（老版） docker-compose 不再维护，但兼容性好
Docker 插件（新版推荐） docker compose 推荐使用

✅ 方法一：安装新版 Docker Compose 插件（推荐）

📌 适用前提

你已经安装了 Docker Engine，系统为 Ubuntu 20.04+ / 22.04 / 24.04。

🔧 步骤 1：添加 Docker 官方 GPG 密钥

sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
gpg --dearmor | \
sudo tee /etc/apt/keyrings/docker.gpg > /dev/null

🔧 步骤 2：添加 Docker 软件源（针对 Ubuntu 24.04 noble）

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu noble stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

🔧 步骤 3：更新并安装 Compose 插件

sudo apt update
sudo apt install docker-compose-plugin

✅ 验证安装成功

docker compose version

输出应类似：

Docker Compose version v2.x.x

🟡 方法二：安装老版独立 docker-compose（兼容旧脚本）

适用于不能用 Docker 插件的场景或临时使用。

🔧 步骤 1：下载二进制文件

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" \
  -o /usr/local/bin/docker-compose

🔧 步骤 2：赋予可执行权限

sudo chmod +x /usr/local/bin/docker-compose

✅ 验证

docker-compose --version

输出应类似：

docker-compose version 1.29.2, build ...

💡 补充说明

  • 如果你使用 docker compose 遇到 docker: 'compose' is not a docker command.，说明你没有安装 Compose 插件；
  • 如果你使用 docker-compose 遇到 command not found，说明你未安装老版二进制；
  • 新项目推荐统一使用新版 docker compose 格式；
  • Ubuntu 24.04 默认源中 不包含 Compose 插件，必须手动添加 docker 官方源并导入 GPG 密钥；

🧪 常见验证命令

# 查看 Docker 是否安装
docker --version

# 查看 Compose 插件是否安装（新版）
docker compose version

# 查看老版 Compose 是否安装
docker-compose --version

# 查看 Docker 服务是否运行
sudo systemctl status docker

📦 附：清理命令

# 卸载旧版 Compose 二进制
sudo rm -f /usr/local/bin/docker-compose

# 卸载 Compose 插件（新版）
sudo apt remove docker-compose-plugin

如需我提供一键安装脚本，也可以帮你写好。

是否要自动安装并配置好 XBoard 依赖的 docker-compose.yaml？我可以一起整合进来。