Docker Compose 部署教程：多服务编排、网络互通与卷挂载完整步骤

很多人学 Docker 时只会 docker run，一旦服务稍微多一点，比如 Web、数据库、缓存、后台管理一起上，就开始手忙脚乱。教程站真正应该解决的，不是“再给你几个命令”，而是教你怎么把多服务编排成一个能维护、能扩展、能排障的部署结构。Docker Compose 就是这一步的起点。这篇文章会把 Compose 的多服务编排、网络互通、卷挂载和上线排查一步步讲清楚。

步骤 1：先明确服务边界，再写 compose 文件

写 Compose 之前不要急着堆 YAML。先把服务角色梳理出来：Web、数据库、缓存、任务队列、反向代理、日志或监控服务各自做什么，谁依赖谁，哪些需要对外暴露端口，哪些只需要内部互通。只有先把结构想清楚，Compose 文件才不会写成“把所有运行参数堆一起”的垃圾配置。

步骤 2：卷挂载决定数据能不能保住

多服务部署最容易出事的就是数据。数据库目录、上传目录、配置文件、日志目录到底要不要挂卷，要提前想清楚。Compose 不只是“把容器一起起起来”，还要帮你把持久化和宿主机目录规划进去。否则删一个容器，重要数据就没了。

步骤 3：网络互通别靠猜，先理解服务名解析

Compose 最大的便利之一，就是同一个网络里服务名可以直接互相访问。比如 Web 服务连数据库，不需要再写死宿主机 IP，而是直接连数据库服务名。但前提是你理解同网络、端口、内部访问和外部暴露的差别。很多人卡在这里，不是 Compose 难，而是对网络模型没有建立概念。

步骤 4：环境变量和配置文件要分层管理

不要把账号、密码、路径、端口、模式全硬编码进 Compose 文件。教程站更推荐你把环境变量、配置文件和镜像配置分开，让部署、迁移和调试都更轻松。尤其是同一套服务有开发环境、测试环境、线上环境时，分层管理是必须的。

步骤 5：上线前一定要看日志、健康检查和重启策略

真正上线时，Compose 是否能启动，只是最基本的门槛。更关键的是服务挂了能不能自动恢复、日志能不能看清问题、依赖服务没起来时是否会连带崩掉。所以教程站写到这里，必须把 restart、日志查看、健康检查和依赖顺序讲进去。

步骤 6：排障时按“配置 → 网络 → 卷 → 日志”顺序查

Compose 场景最典型的问题包括：服务名解析不到、卷权限错误、端口映射冲突、环境变量没生效、依赖服务未就绪。排障不要乱撞，先看配置，再看网络，再看卷，最后回日志，这个顺序能帮你最快定位根因。

操作清单

• 先梳理服务边界，再写 YAML。
• 数据库和上传目录优先考虑卷挂载。
• 理解服务名解析，不要乱写 IP。
• 环境变量和配置文件分开管理。
• 上线前补健康检查、日志和重启策略。

常见问题 FAQ

1）为什么服务之间互相访问不到？

通常是网络没配对、服务名写错，或者你混淆了内部端口和宿主机映射端口。

2）为什么删了容器数据就没了？

因为你没有把关键目录挂到卷上，数据仍然只存在容器层。

3）Compose 和 Kubernetes 是一回事吗？

不是。Compose 更适合单机或小规模编排，Kubernetes 面向更复杂的集群调度场景。