一、先决条件

• 已安装 Docker 引擎（Docker Compose 依赖 Docker 运行）。
• 若未安装 Docker，请先参考官方文档安装 Docker：
• Docker 官方安装指南

二、Linux 系统安装 Docker Compose

方法 1：使用官方二进制包（推荐）

下载最新版 Docker Compose
打开终端，执行以下命令（替换 <版本号> 为最新版本，如 v2.27.1 ）：

# 查看最新版本号：https://github.com/docker/compose/releases
DOCKER_COMPOSE_VERSION=<版本号>  # 例如 DOCKER_COMPOSE_VERSION=v2.27.1
sudo curl -L "https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

赋予可执行权限

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

验证安装

docker-compose --version
# 输出应类似：Docker Compose version v2.27.1

方法 2：使用包管理器（以 Ubuntu/Debian 为例）

sudo apt update
sudo apt install docker-compose-plugin
# 验证
docker compose version

三、macOS 系统安装 Docker Compose

macOS 用户推荐直接安装 Docker Desktop，已内置 Docker Compose。

1. 下载 Docker Desktop
   访问 Docker Desktop for Mac 下载并安装。

验证安装

docker compose version
# 或旧版命令
docker-compose --version

四、Windows 系统安装 Docker Compose

Windows 用户同样推荐使用 Docker Desktop。

1. 下载 Docker Desktop
   访问 Docker Desktop for Windows 下载并安装。
2. 启用 WSL2 或 Hyper-V
   安装时选择使用 WSL2 后端（推荐）或 Hyper-V。

验证安装

docker compose version
# 或旧版命令
docker-compose --version

五、升级 Docker Compose

Linux 用户手动升级

# 删除旧版本
sudo rm /usr/local/bin/docker-compose
# 重新下载新版本（替换为最新版本号）
sudo curl -L "https://github.com/docker/compose/releases/download/v2.27.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

六、常见问题解决

权限问题
如果提示 Permission denied，尝试：

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

命令未找到
检查是否将 /usr/local/bin 加入 PATH 环境变量：

echo $PATH

国内加速下载
若 GitHub 下载慢，可替换 URL 为国内镜像：

# 例如使用 DaoCloud 镜像
https://get.daocloud.io/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)

七、快速开始示例

创建 docker-compose.yml 文件：

version: '3'
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"

启动服务：

docker-compose up -d

查看运行状态：

docker-compose ps

通过以上步骤，您已成功安装并验证 Docker Compose！