在工程化实践中，使用 docker-compose 部署前后端项目最适合中小规模场景或测试环境，核心是通过编排文件统一管理容器网络、依赖和启动顺序。
先说结论：docker-compose 能简化多容器管理，但生产环境需配合日志收集和重启策略，不建议直接用于大规模集群调度。
- 适合：单体架构或服务耦合度高的项目
- 先准备：前后端独立的 Dockerfile 及网络规划
- 验收：容器状态稳定且接口连通性正常
命令速用版
以下是日常操作中最常用的几条命令，直接在 docker-compose.yml 所在目录执行：
docker-compose up -d # 后台启动所有服务 docker-compose ps # 查看容器运行状态 docker-compose logs -f [服务名] # 实时查看特定服务日志 docker-compose down # 停止并移除容器和网络
为什么会这样
前后端分离项目通常涉及至少两个运行环境：前端需要 Nginx 托管静态文件，后端需要运行应用服务并暴露 API。手动逐个启动容器容易出错，比如后端还没准备好前端就开始请求，或者容器间网络不通。docker-compose 通过一个 YAML 文件定义服务依赖、网络互通和卷挂载，确保启动顺序正确且内部域名可解析。
分步处理
1. 准备前后端 Dockerfile
后端通常直接暴露业务端口，前端需要构建静态资源后用 Nginx 托管。确保后端 Dockerfile 中有 EXPOSE 指令，前端 Dockerfile 包含构建阶段和运行阶段。
2. 编写 docker-compose.yml
定义 services，注意服务名即为内部域名。例如后端服务名为 api，前端容器内请求后端应使用 http://api:8080 而非 localhost。
3. 配置网络与卷
建议显式定义 network，避免使用默认桥接。数据持久化（如数据库）必须挂载 volume，日志建议挂载到宿主机便于收集。
4. 环境变量管理
敏感信息不要写死在 YAML 里，使用 .env 文件或 environment 字段注入，不同环境通过替换 .env 文件切换。
怎么验证是否生效
1. 检查容器状态
执行 docker-compose ps，所有服务 State 应为 Up，Restart 计数不应持续增加。
2. 验证内部连通性
进入前端容器 docker-compose exec frontend sh，使用 curl 请求后端服务名，确认能通。
3. 外部访问测试
浏览器访问宿主机映射端口，检查页面加载及接口响应，观察 Nginx 日志是否有 502 或 404 错误。
常见坑
1. 构建上下文路径错误
compose 文件中的 build context 路径是相对于 compose 文件本身的，路径不对会导致构建失败。
2. 端口冲突
宿主机端口被占用会导致启动失败，映射前先用 netstat -tulpn 检查。
3. 权限问题
挂载卷时，容器内用户与宿主机文件权限不一致可能导致写入失败，尤其是日志文件。
4. 依赖启动顺序
虽然 depends_on 能控制启动顺序，但不能保证服务就绪。后端应用需自行实现健康检查或重试机制。
原文链接：https://www.zjcp.cc/ask/10153.html