Docker Compose 入门与命令速查

Docker Compose 解决什么问题#

Docker Compose 解决的核心问题可以概括为一句话：

把”手动敲一长串 docker run 来跑一组容器”变成”用一个声明式 YAML 文件描述，一条命令管理整套环境”。

Docker Compose 不解决什么#

• 不构建镜像：它调 docker build，构建还是 Dockerfile 的事。compose 里写 build: 只是调用。
• 不做大规模集群编排：跨多主机、自动扩缩容、滚动更新，那是 K8s / Swarm 的领域。Compose 定位是单机（或开发/测试环境）的多容器编排。
• 不替代 docker run 的所有场景：临时跑一条命令，docker run --rm 更直接。

compose 是**docker run 的升级版，具有”声明式 + 编排 + 生命周期管理”**的特点。

概述#

Docker Compose 让用户能够以声明式方式定义和管理多容器应用。它的核心价值在于：用一个 YAML 文件取代一连串手动的 docker run 命令，使得复杂应用的启动、停止和重建变得一键可达。

对于开发团队而言，Compose 解决了三个关键问题：环境一致性（“在我机器上能跑”的问题）、服务依赖管理（确保数据库在应用之前启动）、以及开发-测试-生产的配置差异管理（通过 compose.override.yaml 实现多环境适配）。

在 Linux 上，默认建议通过 Docker 官方软件仓库安装 Compose CLI 插件，这样可以随系统包管理器更新：

1
sudo apt-get update
2
sudo apt-get install docker-compose-plugin

测试安装

1
docker compose version

命令说明#

项目启动与停止：

• docker compose up：第一次启动项目，拉取镜像、创建容器
• docker compose start：启动已停止的容器（项目已存在）
• docker compose stop：优雅地停止容器（不删除容器）
• docker compose down：完全清理，删除容器和网络（开发时常用）

调试与查看：

• docker compose ps：查看项目中的容器状态
• docker compose logs：查看容器日志（排查问题的第一步）
• docker compose exec：进入正在运行的容器执行命令

构建与更新：

• docker compose build：重新构建镜像（修改 Dockerfile 后）
• docker compose pull：更新所有镜像到最新版本

配置验证：

• docker compose config：验证 docker-compose.yml 格式是否正确

命令速查#

按使用场景分类#

混淆点对比#