在 Linux 系统上安装 Docker Compose 的方法有多种，以下是两种主流方式（ 推荐使用方式一），并附上常见问题的解决方案。

---

方法一：通过 curl 下载二进制文件（推荐）

1. 安装前准备

- 确保已安装 Docker

Docker Compose 依赖 Docker 引擎，需先安装 Docker。
如果未安装，可使用以下命令一键安装（国内服务器推荐使用阿里云镜像加速）：

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

注意操作系统版本，版本太旧可能会报错：安装docker报错：E: Unable to locate package docker-model-plugin（ubuntu版本过旧）

- 检查 Docker 是否安装成功

sudo docker --version

2. 下载并安装 Docker Compose

- 下载最新版本的 Docker Compose 二进制文件

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

• $(uname -s) 和 $(uname -m) 会自动匹配当前系统的操作系统和架构（如 Linux-x86_64）。
• 如果需要指定版本，将 latest 替换为具体版本号，例如 v2.27.0。

- 国内加速下载（解决 GitHub 访问慢的问题）

使用 FastGit 或 ghproxy 代理：

# 使用 FastGit 镜像
sudo curl -L "https://hub.fgit.cf/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose# 或使用 ghproxy 代理
sudo curl -L "https://ghproxy.com/https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

3. 赋予执行权限

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

4. （可选）创建符号链接（Ubuntu无需，因为原路径/usr/local/bin/docker-compose已加入全局环境变量）

将 docker-compose 链接到 /usr/bin 目录，方便全局调用：

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

5. 验证安装

docker-compose --version

成功安装后会显示版本号，例如：

Docker Compose version v2.27.0

---

方法二：手动安装（适用于无法访问 GitHub 的环境）

1. 手动下载二进制文件

• 访问 Docker Compose GitHub Releases 页面。
• 选择适合当前系统的版本（如 docker-compose-linux-x86_64）下载到本地。

2. 上传并安装

• 将下载的二进制文件上传到服务器的 /usr/local/bin 目录。
• 重命名为 docker-compose 并赋予执行权限：

  sudo mv docker-compose-linux-x86_64 /usr/local/bin/docker-compose
  sudo chmod +x /usr/local/bin/docker-compose
  

3. 验证安装

docker-compose --version

---

注意事项

1. 版本选择

• 使用 latest 标签默认安装最新版，或替换为具体版本号（如 v2.27.0）。
• Docker Compose V2 与旧版 V1 兼容，但推荐使用 docker compose（集成到 Docker CLI）而非独立工具 docker-compose。

2. 国内镜像加速

• 若 Docker 镜像拉取缓慢，可修改 Docker 配置文件 /etc/docker/daemon.json，添加国内镜像源（如阿里云、中科大等）：

  {"registry-mirrors": ["https://registry.docker-cn.com","https://hmdsd139.mirror.aliyuncs.com","https://docker.mirrors.ustc.edu.cn"]
  }
  

• 重启 Docker 服务：

  sudo systemctl daemon-reload
  sudo systemctl restart docker
  

3. 权限问题

• 若提示权限错误，检查 /usr/local/bin 目录权限，或使用 sudo 执行命令。

---

常见问题

1. 安装后命令不识别

• 确保 docker-compose 已加入环境变量路径（如 /usr/local/bin 或 /usr/bin）。
• 检查文件权限是否为可执行：

  ls -l /usr/local/bin/docker-compose
  

2. 版本兼容性问题

• 若与 Docker 版本不兼容，建议升级 Docker 或降级 Docker Compose：
  • 卸载当前版本：

    sudo rm /usr/local/bin/docker-compose
    

  • 重新安装指定版本。

3. 下载速度慢

• 使用国内代理或手动下载（如 FastGit、ghproxy、阿里云等）。

---

总结

- 推荐方式：使用 curl 下载并安装（方法一）。

- 离线环境：手动下载二进制文件（方法二）。

- 安装完成后，通过 docker-compose --version 验证是否成功。