强曰为道

与天地相似,故不违。知周乎万物,而道济天下,故不过。旁行而不流,乐天知命,故不忧.
文档目录

Docker Compose 完全指南

Docker Compose 完全指南

一条命令,编排整个应用。

Docker Compose 是 Docker 官方提供的多容器编排工具,通过一个 YAML 文件定义和管理多个容器化服务,是现代开发、测试、CI/CD 乃至轻量生产环境的核心基础设施。


为什么写这份指南?

  • 网上资料碎片化严重,版本混杂(V1 / V2 / Compose Specification)
  • 官方文档偏重 API 参考,缺乏业务场景驱动的系统讲解
  • 很多团队会用 Compose,但不会用好 Compose

本教程共 15 章,每章 200–500 行,力求可读、可运行、可落地


读者对象

层级你可能是…能获得什么
初学者刚接触 Docker,想编排多容器系统入门,建立正确心智模型
中级开发者已有 Compose 经验,想更进一步网络、卷、环境管理、多环境方案
DevOps / SRE需要生产级编排与可观测性Swarm 部署、日志、监控、CI/CD 集成

章节目录

章节主题关键词
第 1 章 · 简介Compose 概念、版本演进、vs Kubernetes概念入门
第 2 章 · 安装安装方式、V2 vs V1、验证环境准备
第 3 章 · 基础services / image / ports / volumes基础语法
第 4 章 · 网络默认网络、自定义网络、外部网络网络隔离
第 5 章 · 数据卷named volumes / bind mounts / tmpfs持久化
第 6 章 · 环境变量.env / environment / env_file配置管理
第 7 章 · 依赖与健康检查depends_on / healthcheck / restart启动顺序
第 8 章 · 构建build context / Dockerfile / 多阶段构建自定义镜像
第 9 章 · 多环境管理override 文件 / profiles / 变量替换多环境
第 10 章 · 敏感信息secrets / configs / Docker Secrets安全管理
第 11 章 · Swarm 部署deploy / replicas / update_config容器编排
第 12 章 · 日志logging driver / 集中式日志日志治理
第 13 章 · 监控cAdvisor / Prometheus / Grafana可观测性
第 14 章 · 故障排查常见问题 / 调试技巧问题解决
第 15 章 · 最佳实践项目结构 / 生产规范 / CI/CD工程规范

环境要求

工具最低版本推荐版本
Docker Engine20.10+26.x
Docker ComposeV2 (2.20+)最新版 (作为 Docker CLI 插件)
操作系统Linux / macOS / Windows (WSL2)Linux (Ubuntu 22.04+)

约定说明

  • 所有示例均经过实际验证,可直接复制运行
  • 代码块标注语言类型:yamlbashdockerfile
  • 关键概念用 粗体 标注,术语首次出现附英文
  • ⚠️ 标记表示注意事项/易踩坑点
  • 💡 标记表示最佳实践/实用技巧

快速开始

如果你已经安装了 Docker,可以立即体验:

# 创建项目目录
mkdir my-first-compose && cd my-first-compose

# 创建 docker-compose.yml
cat > docker-compose.yml << 'EOF'
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
  redis:
    image: redis:7-alpine
EOF

# 启动所有服务
docker compose up -d

# 查看运行状态
docker compose ps

# 清理
docker compose down

扩展阅读