Docker Compose 指南：简化多容器开发

Docker Compose 简化了多容器 Docker 应用的管理，使开发者能够轻松编写并运行复杂应用。

中级 DevOps 工程师、后端开发者和云原生开发者，尤其是从事微服务或多服务架构的人员，常常面临管理众多相互关联容器的挑战。Docker Compose 解决了这些复杂性，优化了开发与测试的工作流程。 

在本文中，您将学到使用 Docker Compose 所需的一切。如果您刚开始接触 Docker，请查阅我们的 Docker 新手指南。 

什么是 Docker Compose？

Docker Compose 是一款通过单个 YAML 配置文件 来定义与编排多容器 Docker 应用的工具。 

借助 Compose，您可以轻松指定服务、网络、卷、环境设置和依赖关系。它非常适合本地开发、测试环境、快速原型以及较小的生产环境。

Docker Compose 的常见用例包括创建与真实系统相匹配的本地环境，例如微服务架构。通过清晰定义组件交互，Compose 提供一致性、易用性和更快的迭代周期。

您可能会疑惑为何不直接使用 Kubernetes。首先，对于小型项目和本地测试，Kubernetes 往往“杀鸡用牛刀”。正如您将在我们的 Kubernetes vs. Docker 教程中看到的，Kubernetes 更适合在集群中管理多个容器。我们的 使用 Docker 和 Kubernetes 的容器化与虚拟化课程将更深入讲解如何用 Docker 和 Kubernetes 构建与部署应用。 

为何使用 Docker Compose 而非手动 Docker 命令？

逐个管理多个容器很快就会因以下原因而变得混乱：

• 复杂的依赖顺序， 
• 不一致的环境，以及 
• 可扩展性问题。 

使用手动命令会增加人为错误、配置漂移和低效工作流的风险。 

Docker Compose 通过在一个 YAML 文件中定义所有应用服务和依赖关系来解决这些问题。这带来了一致性、可扩展性和更易管理的依赖关系，大幅减少错误并提升生产力。

与手动创建并连接容器相比，Compose 更快。此外，Compose 会为所有容器创建一个默认网络以便通信；同时它还管理卷，确保在服务替换或重启时自动重新挂载。

您可以在我们的 如何使用 Docker 容器化应用 教程中，学习如何使用 Docker 和 Kubernetes 对机器学习应用进行容器化。 

Docker 与 Docker Compose 有何区别？

Docker 是构建、运行和管理容器的平台；而 Docker Compose 是让您使用 YAML 文件（通常为 docker-compose.yml）轻松定义和管理多个容器的工具。 

Docker 主要处理单个容器，而 Docker Compose 则让您将它们堆叠为一个整体服务。例如，一个包含后端、前端、数据库、缓存等的应用。

没有 Docker Compose，您也可以构建并运行容器。但将一切封装进单个 docker-compose.yml 文件会让多容器管理更简单，并且可以在任何环境中用一条命令启动应用。

理解 Docker 和 Docker Compose 对于您在接下来的面试中脱颖而出至关重要。通过我们的 2025 年顶级 26 道 Docker 面试题与答案，确保您已做好准备。 

Docker Compose 基础

在进入实践细节之前，理解 Docker Compose 的核心原理与语法至关重要。在使用 Compose 之前，请按照我们的 在 Ubuntu 上安装 Docker：从设置到第一个容器 指南完成 Docker 安装。 

概念框架

Docker Compose 为本地开发和更简单的部署抽象了容器编排的复杂性。通过 YAML 格式的 Compose 文件，您可以声明所需服务、定义其依赖、指定网络、卷、环境变量等。Compose 高效管理这些服务的启动、停止、扩缩容与互联。

核心 Compose 语法

Docker Compose 围绕直观的 YAML 语法构建。核心组件包括：

• services：用于定义容器化的应用
• images 或 build：用于指定容器
• ports：用于暴露服务
• volumes：用于持久化数据存储
• networks：用于服务间通信

服务定义与应用架构

Compose 文件体现了应用的服务与连接关系。

定义服务

服务是 Compose 文件的核心。您可以清晰地定义并命名多个服务（如 Web 前端、数据库、缓存服务），并通过诸如 depends_on 等简单关键字指定依赖关系，以控制容器启动顺序。

网络基础

Docker Compose 会自动创建默认网络，方便已定义服务之间的通信。开发者也可按需指定自定义网络，以增强隔离或满足更细致的网络需求。

卷管理

卷可在容器生命周期之外持久化数据。您可以指定具名卷或将宿主目录挂载到容器中，确保数据库、日志或其他有状态数据稳定持久。

环境变量

Compose 简化了将环境变量与机密安全传入容器。它支持在服务下直接声明，也支持引用与 Compose 文件同级的 env 文件中的变量，以将敏感值与 Docker 定义分离并妥善保护。

Docker Compose 的扩缩容与编排

Docker Compose 也简化了基础的扩缩容与编排，这在快速压测或评估并行服务时尤其有用。

扩缩服务

Compose 的 "--scale" 标志可便捷地快速启动服务的多份副本。这使得诸如评估负载均衡或处理并发请求等测试场景更加直观。

例如，只需一条命令即可对一个 Flask 应用容器进行扩容：

docker-compose up --scale flaskapp=4技术支持

Docker Compose vs Docker Swarm 与 Kubernetes

虽然 Docker Compose 在本地开发和小规模场景中表现出色，但在多主机、生产级规模的编排方面存在局限。对于跨多台主机的复杂生产级场景，Docker Swarm 或 Kubernetes 等更强大的编排器更为合适，因为它们提供了负载均衡、自愈、先进网络和大规模扩展等 Compose 不具备的能力。

我们的 Docker Compose 与 Kubernetes 对比 博文更详细地介绍了两者的关键差异。  

高效使用 Compose 的优化技巧

高效利用 Docker Compose 包括优化构建、添加健康检查以及管理服务资源。本节将带您深入了解这些优化技巧。

高效构建策略

在 Dockerfile 中使用多阶段构建有助于减小镜像大小，而显式利用构建缓存可显著加速开发与 CI 流程。

健康检查与重启策略

Compose 允许您定义明确的容器健康检查以维持应用可靠性。重启策略可确保失败的容器自动重启，从而提升韧性。

管理资源限制

在 Compose YAML 定义中直接设置 CPU 与内存限制，有助于控制资源分配，提高可预期性与资源效率。

资源限制示例片段：

services:
  flaskapp:
    image: flask
    deploy:
      resources:
        limits:
          cpus: '0.50'
          memory: 512M技术支持

实践示例：多容器应用

以下是一个简化的真实案例：一个 Python Flask 应用与 Redis 组合：

services:
  redis:
    image: redis:7
    container_name: redis
    ports:
      - "6379:6379"
    restart: always
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 30s
      timeout: 5s
      retries: 3
  web:
    build: .
    container_name: flask_app
    command: gunicorn app:app --worker-class gevent --bind 0.0.0.0:5000 --timeout 3000
    ports:
      - "5000:5000"
    depends_on:
      - redis
    environment:
      - REDIS_URL=redis://redis:6379/0
    env_file:
      - .env
    volumes:
      - ./shorts:/app/shorts
      - ./temp_uploads:/app/temp_uploads
      - ./uploads:/app/uploads
    restart: always

  worker:
    build: .
    container_name: celery_worker
    command: celery -A celery_worker.celery worker --loglevel=info
    depends_on:
      - redis
    environment:
      - REDIS_URL=redis://redis:6379/0
    env_file:
      - .env
    volumes:
      - ./shorts:/app/shorts
      - ./temp_uploads:/app/temp_uploads
      - ./uploads:/app/uploads
    restart: always技术支持

该 Docker Compose 文件定义了一个包含三个服务的多容器应用：

1. redis
2. web（使用 Gunicorn 的 Flask 应用）
3. worker（Celery worker）

对于 redis 服务：

• 使用官方 Redis 7 镜像。
• 将容器名称设为 redis。
• 将容器内的 6379 端口映射到宿主的 6379。
• 若崩溃则总是重启（restart: always）。
• 定义 healthcheck，每 30 秒运行一次 redis-cli ping，5 秒超时，重试 3 次后判定为不健康。

对于 web 服务：

• 从当前目录构建镜像（build: .）。
• 将容器命名为 flask_app。
• 运行命令 gunicorn app:app，使用 gevent worker，绑定 0.0.0.0:5000，超时时间 3000 秒
• 将容器端口 5000 映射到宿主的 5000。
• 声明依赖 redis 服务，确保 Redis 先启动。
• 设置环境变量 REDIS_URL 指向内部的 Redis 容器。
• 从 .env 文件加载额外环境变量。
• 将三个本地文件夹挂载到容器：
• ./shorts 到 /app/shorts，
• ./temp_uploads 到 /app/temp_uploads 
• ./uploads 到 /app/uploads
• 配置为在崩溃时总是重启。

对于 worker 服务：

• 同样从当前目录构建镜像（build: .），与 web 服务复用同一 Dockerfile。
• 将容器命名为：celery_worker。
• 运行命令 celery -A celery_worker.celery worker --loglevel=info，启动 Celery worker 以处理后台任务。
• 声明依赖 redis 服务，确保 Redis 先启动。
• 设置相同的 REDIS_URL 环境变量以连接 Redis broker。
• 从 .env 文件加载其他环境变量。
• 与 web 服务挂载相同的三个文件夹，使 Web 应用与 worker 共享文件与上传内容。
• 配置为在崩溃时总是重启。

在我们的 10 个 Docker 项目创意 教程中探索更多 Docker 项目思路。 

构建与运行多容器应用

Docker Compose 为日常容器任务提供了直观的工具集：

构建镜像

使用 docker compose build 按照定义的 Dockerfile 生成容器镜像。 我们在 零基础学习 Docker：数据专业人士指南 教程中提供了更多关于构建 Docker 镜像的信息。 

运行服务

使用 docker compose up  启动 Compose 文件中定义的所有服务。要以分离模式运行，请使用 docker compose up -d。我们的 Docker 入门课程 更详细地介绍了如何在后台运行容器。 

查看运行中的容器

要查看活动容器及其状态，请使用 docker compose ps 列出所有正在运行的服务。

停止服务

使用 docker compose down 停止正在运行的服务。 

查看日志

使用 docker compose logs 查看日志。您可以使用 docker logs container_name 指定某个容器来查看日志。要流式查看日志，请使用 docker compose -f container_name。 

我们的 构建、运行与管理容器的 18 个顶级 Docker 命令 指南分解了更多 Docker 命令，助您自信地在各环境中管理应用。 

Docker Compose 高级用法 

Compose 工作流可适配更复杂的开发环境或不同的环境配置。

多环境配置

使用多个 Compose 文件或覆盖文件可便捷地配置不同环境（开发、测试、生产）。这使定义更易维护与阅读，便于快速修改且不致配置臃肿。

依赖管理

虽然 depends_on 可处理基础的启动顺序，但更复杂的场景可引入初始化脚本（如 "wait-for-it"），以确保仅在满足特定条件（如数据库就绪）后再启动容器。

与 CI/CD 集成

Compose 能无缝融入持续集成工作流，自动化搭建完整的测试环境。GitLab CI 与 GitHub Actions 等平台提供了原生或简化的 Compose 集成方式，从而优化自动化测试流程。

最佳实践与常见挑战

通过有条理地组织与构建 Compose 定义，您可以避免常见陷阱并打造可维护的配置。

Compose 文件组织

保持 Compose 文件清晰且模块化。对于简单项目，单文件可能已足够；而对于更大型的应用，建议借助 覆盖特性 将配置拆分为多个 Compose 文件。这将带来：

• 组件的逻辑分离（例如，docker-compose.backend.yml、docker-compose.frontend.yml）
• 更易于进行本地与生产环境的定制
• 更顺畅的版本控制与协作，因为对单个服务的更改不会影响整个文件

使用有意义的服务名与一致的缩进，使文件更易阅读与导航。

潜在陷阱

请注意以下常见失误：

• 为镜像使用 latest 标签：这会带来不可预测性，因为实际镜像版本可能随时间变化。务必显式固定镜像版本（例如 postgres:15.1），以确保跨环境一致性。
• 硬编码机密：切勿在 Compose 文件中直接包含敏感数据（如 API 密钥、密码）。应使用环境变量、.env 文件（排除在版本控制之外），或 Docker Secrets 等机密管理工具来安全处理。
• 过于复杂的服务定义：避免将过多逻辑或职责塞进单个容器。遵循单一职责原则，并在可能时保持简洁。
• 忽视显式网络配置：优先在 Compose 中定义自定义网络，而不是依赖默认行为。这样可更好地控制服务通信，减少端口冲突，并改进安全边界。

采纳这些实践后，基于 Compose 的工作流将在协作或不断演进的环境中更加健壮、安全且易于维护。

结论

Docker Compose 显著简化了开发者构建、管理与运行多容器应用的过程。其清晰的 YAML 定义、易于编排与直观的扩缩容，使其在本地开发场景与较简单的部署架构中极具价值。尽管针对大规模生产工作负载，Docker Swarm 与 Kubernetes 等高级编排器更为合适，但 Compose 依然是理解容器编排基础与改进开发者工作流的必备起点。

查看我们的 Docker 课程 了解：

• 使用 Docker 与 Kubernetes 的容器化与虚拟化 
• Docker 进阶