通过 APT 安装 Docker Compose V2

Docker Compose V2 是 Docker 官方推荐的新一代工具，作为 CLI 插件与 docker 命令整合使用，取代了旧的 docker-compose 命令。本教程将介绍如何在 Ubuntu 系统中通过 APT 正确安装 Compose V2。

📦 什么是 Docker Compose V2？

使用方式为：docker compose（空格分隔）
使用 Go 语言开发，性能更好
作为 Docker CLI 插件存在，不再是独立二进制文件
官方已于 2023 年停止支持 V1

❌ 为什么不推荐使用 `apt install docker.io`？

Ubuntu 自带的 docker.io 包版本较旧，不包含 Compose 插件。安装后无法使用 docker compose 命令，可能会看到如下报错：

1

docker: 'compose' is not a docker command.

✅ 正确安装 Docker + Compose V2

1. 卸载旧版本（可选）

1

sudo apt remove docker docker.io docker-compose

2. 添加 Docker 官方 APT 源

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


sudo apt update
sudo apt install ca-certificates curl gnupg

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

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

sudo apt update

3. 安装 Docker 及 Compose 插件

1
2


sudo apt install docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

4. 验证安装

1
2


docker --version
docker compose version

输出示例：

1
2


Docker version 24.x.x, build abcdefg
Docker Compose version v2.x.x

🧪 附加：使用 Compose 命令

示例项目：

1
2
3
4
5
6


# docker-compose.yml
services:
  web:
    image: nginx
    ports:
      - "8080:80"

运行：

1

docker compose up -d

✅ 小结

安装方式	是否支持 Compose V2
`apt install docker.io`	❌ 不支持
官方 APT 源 + `docker-compose-plugin`	✅ 支持

本文由作者学习整理，内容由 ChatGPT 自动汇总。