Docker Compose从入门到实战：配置与命令全指南

一、核心概念

1. Docker Compose：一个用于定义和运行多容器 Docker 应用程序的工具。
2. docker-compose.yml：一个 YAML 格式的配置文件，用于配置应用程序的服务 、网络 和数据卷。
3. 服务 (Service) ：代表一个容器的配置，包括镜像、端口、环境变量等。一个 docker-compose.yml 可以定义多个服务（如一个 Web 服务，一个数据库服务）。
4. 项目 (Project) ：由一组关联的服务组成，默认使用当前目录名作为项目名。可以通过 -p 选项指定。

二、基本文件结构

一个最简单的 docker-compose.yml 文件包含以下部分：

version: '3.8'  # 指定 Compose 文件格式的版本

services:   # 定义所有服务的核心部分
  service1: # 第一个服务
    ...配置...
  service2: # 第二个服务
    ...配置...

networks:   # （可选）定义自定义网络
  my-net:

volumes:    # （可选）定义数据卷
  my-data:

三、常用服务配置项详解

1. 镜像与构建

配置项	说明	示例
image	直接从仓库拉取镜像	image: nginx:latest
build	根据 Dockerfile 构建镜像	build: . 或 build: ./dir
context	(在 build 下) 构建上下文路径	build: { context: . }
dockerfile	(在 build 下) 指定 Dockerfile 文件名	build: { context: ., dockerfile: Dockerfile.dev }

示例：

services:
  webapp:
    build: . # 使用当前目录下的 Dockerfile 构建镜像
    # 等同于：
    # build:
    #   context: .
    #   dockerfile: Dockerfile

  db:
    image: postgres:13 # 使用现成的镜像

2. 端口映射

配置项	说明	示例
ports	映射端口 [主机端口]:[容器端口]	ports: - "8080:80"
	随机映射主机端口	ports: - "3000" (容器3000端口随机映射到主机)

示例：

services:
  nginx:
    image: nginx
    ports:
      - "80:80"       # 主机80端口 -> 容器80端口
      - "443:443"     # 主机443端口 -> 容器443端口
  api:
    image: my-api
    ports:
      - "3000"        # 容器3000端口随机映射到主机某端口

3. 环境变量

配置项	说明	示例
environment	直接以 key-value 形式设置	environment: MY_VAR: value
env_file	从文件加载环境变量	env_file: - ./.env

示例：

services:
  db:
    image: postgres:13
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    # 或者使用 env_file
    env_file:
      - ./db.env # 文件内容：POSTGRES_PASSWORD=secret

4. 数据卷与挂载

配置项	说明	示例
volumes	挂载宿主机目录或命名的数据卷	volumes: - /host/path:/container/path
	使用匿名卷	volumes: - /container/data
	使用命名的数据卷	volumes: - named-volume:/app/data

示例：

services:
  web:
    image: nginx
    volumes:
      - ./html:/usr/share/nginx/html  # 挂载主机目录（常用於代码开发）
      - nginx-logs:/var/log/nginx     # 使用命名的数据卷持久化日志

# 在文件底部定义命名的数据卷
volumes:
  nginx-logs: # 声明一个名为 nginx-logs 的数据卷，Docker 会自动创建它

5. 依赖与启动顺序

配置项	说明	示例
depends_on	指定服务依赖关系，控制启动顺序	depends_on: - db
healthcheck	定义健康检查，depends_on 可等待服务健康	见下方示例

示例：

services:
  webapp:
    build: .
    depends_on:
      - db       # 确保 db 服务先启动
      - redis
    # 更佳实践：使用健康检查确保依赖服务真正可用
    # depends_on:
    #   db:
    #     condition: service_healthy
    #   redis:
    #     condition: service_started

  db:
    image: postgres:13
    healthcheck: # 为 db 服务定义健康检查
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5

6. 网络

配置项	说明	示例
networks	将服务连接到自定义网络	networks: - my-frontend
ports	暴露端口到宿主机	ports: - "80:80"

示例：

services:
  proxy:
    image: nginx
    networks:
      - frontend
  app:
    build: .
    networks:
      - frontend
      - backend
  db:
    image: postgres
    networks:
      - backend

# 在文件底部定义网络
networks:
  frontend:
  backend:

四、完整实战示例：WordPress + MySQL

这是一个经典的多服务应用示例。

version: '3.8'

services:
  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql # 使用数据卷持久化数据库
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: some_root_password
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress_password
    networks:
      - wordpress-net
    healthcheck: # 健康检查，确保数据库完全启动
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-p$$MYSQL_ROOT_PASSWORD"]
      interval: 10s
      timeout: 5s
      retries: 5

  wordpress:
    depends_on:
      db:
        condition: service_healthy # 等待数据库健康后再启动
    image: wordpress:latest
    ports:
      - "8000:80" # 将主机的8000端口映射到容器的80端口
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306 # 使用服务名"db"作为主机名（Docker DNS）
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress_password
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - ./wp-content:/var/www/html/wp-content # 挂载主题和插件目录方便开发
    networks:
      - wordpress-net

volumes:
  db_data: # 声明一个命名卷用于数据库持久化

networks:
  wordpress-net: # 声明一个自定义网络，让两个容器可以互通

五、常用命令

编写好 docker-compose.yml 后，使用以下命令操作：

命令	说明
docker-compose up	创建并启动所有服务（前台）
docker-compose up -d	创建并在后台启动所有服务（最常用）
docker-compose down	停止并删除所有容器、网络（最常用）
docker-compose down -v	down 的同时删除数据卷（慎用！）
docker-compose ps	列出本项目中的所有容器
docker-compose logs	查看所有服务的日志
docker-compose logs -f service_name	实时追踪特定服务的日志
docker-compose exec service_name command	在服务的容器中执行命令
docker-compose build	重新构建服务的镜像
docker-compose restart	重启所有服务
docker-compose pull	拉取服务的最新镜像

最佳实践

1. 使用 .env 文件 ：将敏感信息（密码、密钥）和可能变化的配置（端口号）放在 .env 文件中，并在 docker-compose.yml 中引用：${VARIABLE_NAME}。
2. 指定版本 ：始终在文件顶部使用 version 键，并选择与你的 Docker Engine 兼容的版本。
3. 使用自定义网络 ：让 Compose 为你管理网络，服务间可以使用服务名作为主机名互相访问（Docker 内置 DNS）。
4. 合理使用数据卷 ：对需要持久化的数据（数据库、日志）使用命名卷 或绑定挂载。
5. 定义健康检查：确保服务间的依赖是真正可用的，而不仅仅是容器启动了。