当前位置:首页>Linux>Linux 安装docker-compose安装

Linux 安装docker-compose安装

  • 2026-09-08 15:36:03
Linux 安装docker-compose安装

在 Linux 系统上安装 Docker Compose 的方法有多种,以下是两种主流方式。

方式一:通过 curl 下载二进制文件(推荐)

1、安装前准备

- 确保已安装 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

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 镜像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

成功安装后会显示版本号,例如:

方法二:手动安装(适用于无法访问 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-composesudo 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-reloadsudo 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 验证是否成功。

最新文章

随机文章