Linux 安装docker-compose安装方法(安装docker compose安装)

发布于:2025-09-06 ⋅ 阅读:(15) ⋅ 点赞:(0)


在 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. 手动下载二进制文件

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 验证是否成功。