Docker Compose完整指南

多容器编排、网络配置、数据卷管理与生产部署

📅 2026年4月6日 · 阅读约10分钟 · Docker容器化DevOps

Docker Compose是定义和运行多容器Docker应用的工具。通过一个YAML配置文件，你可以同时管理多个服务（Web服务器、数据库、缓存等），一键启动完整的开发或生产环境。对于需要多个服务协作的应用（如Web应用+数据库+Redis），Docker Compose是最高效的管理方式。本指南将帮助你从零掌握Docker Compose的核心用法。

一、Docker Compose核心概念

二、快速开始

# 安装Docker Compose V2（作为Docker插件）
# Docker Desktop自带，Linux安装：
sudo apt install docker-compose-plugin

# 验证安装
docker compose version

一个典型的Web应用配置

# docker-compose.yml
version: '3.8'

services:
  # Web应用
  web:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/myapp
      - REDIS_URL=redis://cache:6379
    depends_on:
      db:
        condition: service_healthy
      cache:
        condition: service_started
    volumes:
      - .:/app
      - /app/node_modules
    restart: unless-stopped

  # PostgreSQL数据库
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: myapp
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user -d myapp"]
      interval: 5s
      timeout: 5s
      retries: 5
    restart: unless-stopped

  # Redis缓存
  cache:
    image: redis:7-alpine
    volumes:
      - redis_data:/data
    ports:
      - "6379:6379"
    restart: unless-stopped

volumes:
  postgres_data:
  redis_data:

三、常用命令

# 启动所有服务（后台运行）
docker compose up -d

# 启动并强制重新构建
docker compose up -d --build

# 查看服务状态
docker compose ps

# 查看日志
docker compose logs -f web
docker compose logs --tail=100

# 停止所有服务
docker compose down

# 停止并删除数据卷
docker compose down -v

# 重启单个服务
docker compose restart web

# 进入容器
docker compose exec web sh

# 查看服务配置
docker compose config

四、网络管理

Docker Compose默认为每个项目创建一个bridge网络，同网络内的容器可以通过服务名互相访问。

# 自定义网络
services:
  frontend:
    networks:
      - frontnet
  backend:
    networks:
      - frontnet
      - backnet
  database:
    networks:
      - backnet

networks:
  frontnet:
    driver: bridge
  backnet:
    driver: bridge
    internal: true  # 不允许外部访问

五、数据卷管理

# 命名卷（推荐用于数据库）
volumes:
  postgres_data:

# 绑定挂载（适合开发时代码同步）
services:
  web:
    volumes:
      - ./src:/app/src          # 宿主机到容器
      - /app/node_modules       # 匿名卷（防止覆盖）

# 只读挂载
services:
  web:
    volumes:
      - ./config:/app/config:ro

# 查看卷列表
docker volume ls
docker volume inspect project_postgres_data

六、环境变量与配置

# .env文件
DB_USER=admin
DB_PASSWORD=secret123
REDIS_HOST=cache

# docker-compose.yml中引用
services:
  db:
    image: postgres:16
    environment:
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASSWORD}

# 多环境配置
# docker-compose.override.yml（开发环境）
services:
  web:
    volumes:
      - .:/app

# 使用：docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

七、生产环境最佳实践

• 设置资源限制：使用deploy.resources限制CPU和内存
• 健康检查：为所有服务配置healthcheck
• 日志管理：配置logging driver和日志大小限制
• 不使用latest标签：固定镜像版本号
• 敏感信息管理：使用Docker Secrets或环境变量文件
• 使用restart策略：unless-stopped确保服务自动恢复

# 生产级配置示例
services:
  web:
    image: myapp:1.2.0
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 512M
        reservations:
          memory: 256M
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    restart: unless-stopped