Docker Compose 部署常用应用模板

Docker Compose 部署常用应用模板

本教程以"模板库"的视角讲解 Docker Compose：每一类常见的多容器应用（Web 站点、数据库、消息队列、缓存、监控栈、数据管道、自托管服务）都给出可直接抄用的 Compose 配置，逐行讲清关键指令，再补充变体与踩坑记录。适合已经会跑 docker 命令、想用 Compose 把多个容器组织起来的人，也适合想找一套省心部署方案的运维与全栈工程师。

部署多容器应用，最痛苦的是什么？不是容器本身，而是"串起来"。

数据库要等网络就绪再启动，应用要等数据库就绪再连，日志要汇到一处方便排查，密钥不能写死在镜像里，数据要落到磁盘上而不是跟着容器一起蒸发。这些问题单独看都不难，难的是每次都手动编排一遍。Docker Compose 把这一摊事收敛成一个 YAML 文件加一条命令：up 起来，down 撤掉，配置全在文件里，环境换一台机器也能复现。

本教程的定位很明确：不是讲 Docker 语法大全，而是给出一套"拿来就能用"的部署模板库。全书按六章组织：

第一章先把地基打牢。Compose 的四个基本概念（服务、网络、卷、配置）各自解决什么问题，怎么安装和选版本，一个 Compose 文件由哪些顶层块构成，以及 up、down、start、stop、restart 这组生命周期命令到底在背后做了什么。这些是后面所有模板的共同语法，值得花点时间过一遍。

第二章讲部署模式与通用最佳实践。单服务怎么部署、多服务怎么协同、数据怎么持久化、服务之间怎么走网络、配置和环境变量怎么管理、健康检查与启动依赖怎么写、什么时候该横向扩展。这些模式像建筑的承重墙，模板库里的每一张"配方卡"都是它们的组合应用。

第三章是全书的核心：常用应用模板库。Web 应用（Nginx 反代加 Node、静态站）、数据库（PostgreSQL、MySQL、MongoDB 等）、消息队列与缓存（RabbitMQ、Kafka、Redis、Memcached）、开发与测试环境，以及监控与日志栈（Prometheus 加 Grafana 加 Loki）、对象存储与数据管道（MinIO 加 Airflow）、自托管协作应用（Nextcloud、Gitea 等）。每张配方卡都包含完整 Compose 文件、关键行解读、变体和常见坑。

第四章把模板往生产环境推。生产部署要考虑什么、安全如何加固（密钥管理与用户权限）、资源限制与性能优化、日志与监控集成、备份与恢复、如何接入 CI/CD 流水线，以及 Compose 与 Swarm、Kubernetes 的定位关系。这一章读完，你会知道哪些模板能直接上生产，哪些还要补配置。

第五章解决"坏了怎么查"。调试工具与技巧、常见错误类型与解决方案（端口冲突、卷挂载失败、启动顺序错乱这类高频问题都有对应解法）、日志分析与问题定位。这一章建议放在手边，出问题时先翻它。

第六章是附录。命令速查表、推荐资源与社区、最佳实践清单，方便日常查阅。

写作上，我们尽量少说正确的废话。每个模板都给出可以复制运行的完整配置，每条指令都解释"为什么这么写"，每个坑都标注"遇到时怎么判断、怎么改"。Compose 的版本差异、镜像 tag 的选择、健康检查的写法这类细节，也会在具体场景里反复出现，帮你形成肌肉记忆。

在动手之前，先说清楚你需要什么前置条件。本教程假设你已经装好了 Docker 引擎（Linux 上为 Docker Engine，Windows 与 macOS 上为 Docker Desktop），并且跑得通最基本的 docker run hello-world。至于 Docker Compose 本身，新版 Docker Desktop 和大多数 Linux 发行版的 Docker 安装包都已经内置（docker compose 子命令），如果提示找不到命令，第二章第二节会讲三种安装方式与版本选择的取舍。不会用 Docker 命令行也不妨碍阅读，但建议先花半天熟悉 docker run、docker ps、docker logs、docker exec 这四个命令，它们会贯穿全书，也是所有调试工作的基础。

这本教程建议怎么读？如果你是有明确部署目标的人（比如"我想在自己服务器上搭一个带数据库的博客"），可以直接跳到第三章，找到对应的模板抄下来，改改环境变量和端口就能跑，遇到报错再回第五章对照排查。如果你是系统学习，按章节顺序读：第一章的四个概念是后面所有模板的语法基础，第二章的七个部署模式是理解模板为什么要那么写的关键。每章的支柱页都画了本章的全景图，读完章节支柱页再进入小节，效率会高很多。

另外交代一下书里反复出现但容易混淆的两个概念。一是"服务"（service）：Compose 里的服务是一个逻辑单位，一个服务对应一个镜像、一份配置，可以运行一个或多个容器实例；二是"项目"（project）：一个 Compose 文件定义的全部服务合起来构成一个项目，项目名默认取目录名，它决定了网络、卷和容器在 Docker 里的命名前缀。搞懂这两个层级，看任何模板都不会迷路。

最后说一句心里话。Compose 模板网上到处都是，为什么还要系统学一遍？因为抄来的配置在别人的机器上能跑，换到你的环境就报错，多半是因为不理解每一行的作用。本教程的目标，是让你抄完模板之后能说得出"这条卷挂载是干嘛的、这个健康检查为什么这么写、这个网络为什么要单独建"，到那时，你就不再是抄模板的人，而是写模板的人。

现在，从第一章开始，先把地基打牢。