在线咨询

    宝塔面板安装 Docker Compose 详细教程，轻松管理容器化应用

    发布时间：2026-01-08 12:32 更新时间：2025-11-19 12:27 阅读量：16

    在当今的云计算和DevOps环境中，容器化技术已成为应用部署和管理的标准。Docker作为容器技术的代表，极大地简化了应用的打包和分发。而docker-compose作为Docker官方的编排工具，允许我们通过一个简单的YAML文件来定义和运行多容器应用。对于使用宝塔面板的用户而言，虽然宝塔提供了便捷的服务器管理功能，但其默认环境并不包含docker-compose。本文将详细介绍如何在宝塔面板环境中安装docker-compose，从而在宝塔的便捷管理与Docker的强大容器化能力之间架起一座桥梁。

    为什么需要在宝塔面板中安装 Docker Compose？

    宝塔面板以其图形化界面和丰富的功能，深受广大运维人员和开发者的喜爱，特别是在Web服务器环境搭建（如Nginx、PHP、MySQL）方面表现出色。然而，当应用架构转向微服务或需要复杂的多容器部署时，单纯的宝塔面板功能就显得有些局限。

    • 统一管理平台：您可以在熟悉的宝塔界面中管理服务器基础服务（网站、FTP、数据库等），同时利用docker-compose编排更复杂的容器化应用（如ELK日志系统、GitLab代码托管等），实现传统应用与现代化应用的统一管理。
    • 简化部署流程：使用docker-compose.yml文件，您可以一键启动、停止或重建整个应用栈，极大地提升了部署效率和可重复性。
    • 环境隔离与依赖管理：Docker容器为每个应用提供了独立的运行环境，避免了依赖冲突。结合docker-compose，可以轻松管理这些相互关联的容器。

    安装前的准备工作

    在开始安装docker-compose之前，请确保您的服务器已经满足以下两个基本条件：

    1. 已安装宝塔面板：这自然是前提。如果尚未安装，请前往宝塔官网根据您的操作系统获取安装命令。
    2. 已安装 Docker：docker-compose是依赖于Docker的，因此必须先安装Docker引擎。您可以通过宝塔面板的软件商店搜索“Docker管理器”并安装，这是一种非常便捷的方式。或者，您也可以通过SSH连接到服务器，使用官方脚本进行安装，这样通常能获得更新的版本。
    # 使用官方脚本安装Docker（推荐）
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# 启动Docker并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

    安装完成后，可以运行 docker --version 来验证Docker是否安装成功。

    安装 Docker Compose 的两种主流方法

    这里我们介绍两种最常用且可靠的方法，您可以根据自己的偏好和服务器环境选择其一。

    方法一：使用官方二进制包安装（推荐）

    这是Docker官方推荐的方法，直接下载编译好的二进制文件，简单快捷。

    1. 确定最新版本号：访问 Docker Compose的GitHub发布页面，查看最新的稳定版版本号（例如 v2.24.1）。下面的命令中将用此版本号进行替换。

    2. 通过SSH执行安装命令：依次执行以下命令。

    # 下载Docker Compose二进制文件到 /usr/local/bin/docker-compose
# 请将 `v2.24.1` 替换为你在第一步中查到的最新版本
sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 授予二进制文件可执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 创建符号链接，以便在任意目录下直接使用 `docker-compose` 命令
# （新版本的Docker Compose插件式使用方式，此步骤非必须但能兼容旧习惯）
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
    1. 验证安装：安装完成后，运行以下命令检查是否安装成功。
    docker-compose --version

    如果终端输出类似 Docker Compose version v2.24.1 的信息，则表明安装成功。

    方法二：使用Python的pip包管理器安装

    如果您的系统已经安装了Python和pip，这也是一种可行的方式。

    1. 安装pip3（如果未安装）：
    sudo yum install python3-pip -y  # 适用于CentOS
# 或者
sudo apt install python3-pip -y  # 适用于Ubuntu/Debian
    1. 使用pip安装docker-compose：
    sudo pip3 install docker-compose

    注意：通过pip安装的docker-compose可能不是最新版本，且依赖于Python环境。

    1. 验证安装：同样使用 docker-compose --version 命令进行验证。

    使用 Docker Compose：一个简单的实战示例

    安装成功后，让我们通过一个简单的例子来体验docker-compose的强大功能。我们将部署一个最基本的Nginx容器。

    1. 创建项目目录：在宝塔面板的文件管理器中，或者通过SSH命令，创建一个用于测试的目录，例如 my_nginx_app。

    2. 创建 docker-compose.yml 文件：在该目录下，创建名为 docker-compose.yml 的文件，并填入以下正文：

    version: '3.8'  # 指定docker-compose的版本语法

services:
web:
image: nginx:latest  # 使用最新的Nginx镜像
container_name: my-nginx-container
ports:
- "8080:80"  # 将宿主机的8080端口映射到容器的80端口
volumes:
- ./html:/usr/share/nginx/html  # 挂载本地html目录到容器
    • ports：端口映射是关键，它让我们能够通过服务器的IP和端口访问容器内的服务。
    • volumes：数据卷挂载，允许我们将宿主机的目录（如存放网站文件的html目录）挂载到容器中，实现数据持久化和方便修改。
    1. 启动服务：在SSH中，进入 my_nginx_app 目录，执行以下命令：
    docker-compose up -d

    参数 -d 表示在后台运行（守护进程模式）。

    1. 验证服务：现在，您可以在浏览器中访问 http://您的服务器IP:8080。如果看到Nginx的欢迎页面，说明您的docker-compose已经成功运行！

    2. 管理服务：

    • 查看运行状态：docker-compose ps
    • 停止服务：docker-compose down
    • 查看日志：docker-compose logs

    可能遇到的问题与解决方案

    • 权限问题：如果执行docker-compose命令时提示权限不足，可以将当前用户加入docker用户组。
    sudo usermod -aG docker $USER

    执行后需要重新登录SSH会话才能生效。

    • 命令未找到：如果提示 docker-compose: command not found，请检查安装路径是否正确，并确认 /usr/local/bin 或 /usr/bin 是否在系统的PATH环境变量中。

    通过在宝塔面板环境中成功安装docker-compose，您不仅保留了宝塔在基础服务管理上的便利性，更融入了Docker生态的灵活与强大。无论是用于个人项目测试，还是生产环境的复杂应用编排，这套组合拳都能显著提升您的工作效率和系统的可维护性。

    继续阅读

    📑 📅
    宝塔面板设置文件监控告警，实时防御网站安全的必备指南 2026-01-08
    宝塔面板如何查看历史备份记录，完整操作指南 2026-01-08
    宝塔面板 MySQL 参数优化指南 2026-01-08
    宝塔面板如何启用 OCSP Stapling，一步步提升网站安全与性能 2026-01-08
    宝塔面板 Nginx 重载失败排查 2026-01-08
    宝塔面板网站出现 500 错误排查，从入门到精通的解决指南 2026-01-08
    宝塔面板如何开启 TCP_FASTOPEN，加速网站访问的进阶配置 2026-01-08
    宝塔面板操作历史回滚功能，您的服务器安全守护者 2026-01-08
    宝塔面板站点跨服务器迁移，完整指南与最佳实践 2026-01-08
    宝塔面板 SSH 密钥管理，告别密码，拥抱安全与效率 2026-01-08