这是一篇为您准备的关于在 2025 年最新版 Ubuntu 系统（如 Ubuntu 24.04 LTS 或 25.10）上安装 Docker Compose 的详细指南。

---

2025 最新版 Ubuntu 系统安装 Docker Compose 官方推荐方法

随着 Docker 技术的演进，Docker Compose 已经从早期的独立 Python 脚本（docker-compose）全面转向了 V2 版本，并作为 Docker CLI 的官方插件（docker compose）提供。

官方目前唯一推荐的安装方式是通过 Docker 的官方 Apt 源安装 docker-compose-plugin。这种方式不仅能保证性能，还能通过系统的 apt upgrade 实现自动更新。

准备工作

• 操作系统：Ubuntu 24.04 LTS、24.10 或更新版本。
• 权限：具有 sudo 权限的用户。
• 环境：卸载可能冲突的旧版本（如果你之前手动下载过 docker-compose 二进制文件）。

---

第一步：设置 Docker 官方存储库

在安装 Docker Compose 之前，我们需要配置 Docker 的官方存储库，以确保获取的是最新且受支持的版本。

1. 更新现有的软件包列表：
   bash
sudo apt update

2. 安装必要的依赖工具：
   bash
sudo apt install ca-certificates curl gnupg

3. 添加 Docker 的官方 GPG 密钥：
   这是为了确保下载的软件包是经过官方签名的。
   bash
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

4. 将 Docker 存储库添加到 Apt 源：
   该命令会自动识别您的 Ubuntu 版本代号（如 noble 或 oracular）。
   bash
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

---

第二步：安装 Docker Engine 和 Docker Compose 插件

配置好存储库后，我们可以直接安装 Docker 核心组件以及 Compose 插件。

1. 再次更新软件包索引：
   bash
sudo apt update

2. 安装 Docker Compose 及其依赖：
   bash
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

---

第三步：验证安装

安装完成后，请验证 Docker Compose 是否可以正常工作。请注意： 在 V2 版本中，命令已从 docker-compose（连字符）变为 docker compose（空格）。

1. 查看版本信息：
   bash
docker compose version
   预期输出示例：Docker Compose version v2.x.x

2. 简单测试（可选）：
   运行一个简单的容器来确认一切正常。
   bash
sudo docker run hello-world

---

第四步：后续建议（免 sudo 运行）

默认情况下，运行 Docker 命令需要 sudo 权限。为了日常开发的便利，建议将当前用户添加到 docker 组。

1. 创建 docker 组（通常已自动创建）：
   bash
sudo groupadd docker

2. 将当前用户加入组：
   bash
sudo usermod -aG docker $USER

3. 激活组更改：
   注销并重新登录，或者运行以下命令立即生效：
   bash
newgrp docker

现在你可以直接输入 docker compose up 而不需要前缀 sudo 了。

---

常见问题与提示

• 关于命令差异：Docker Compose V2 已经完全集成进 Docker 命令体系。旧的 docker-compose 命令在某些系统中通过别名维持兼容，但建议在 2025 年的开发中全面转向 docker compose 这种写法。
• 手动二进制安装：除非有极其特殊的离线需求，否则不建议再去 GitHub Release 页面手动下载二进制文件到 /usr/local/bin。手动安装的版本无法通过系统更新补丁，容易产生安全风险。
• 更新方式：未来如果 Docker 发布了新版本，你只需要运行 sudo apt update && sudo apt upgrade 即可完成一键升级。

通过以上方法，你已经在 Ubuntu 上搭建了一个符合 2025 年工业标准的 Docker Compose 开发环境。