Web 服务器与网关 / 系统课时
使用 Compose 部署网关
使用 Compose 部署网关
本篇介绍如何使用 Docker Compose 编排 Nginx 网关与多个后端服务实例,通过统一网络、服务发现、健康检查和日志持久化完成可重复部署。学习完成后,可以快速搭建本地或测试环境中的网关拓扑。
学习目标
- 理解 Compose 管理 Nginx 网关和后端服务的方式
- 掌握内部网络、服务发现和健康依赖配置
- 能够验证部署结果并定位常见启动问题
设计 Compose 网关架构
使用 Compose 部署网关时,核心目标不是简单启动多个容器,而是让容器之间形成稳定的通信关系。Nginx 作为入口服务,通过 Compose 创建的内部网络访问后端服务,不需要依赖固定 IP 地址。

Compose 会通过服务名提供 DNS 解析。例如服务名称为 app,则 Nginx 可以直接代理到 http://app:<PORT>,容器重建后地址变化也不会影响配置。
编写 Compose 部署文件
下面示例定义一个 Nginx 网关、两个后端实例和一个持久化日志目录。实际镜像版本和端口可以根据项目环境调整。
yaml
services:
gateway:
image: nginx:stable
ports:
- "<PORT>:80"
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
- nginx-logs:/var/log/nginx
depends_on:
app:
condition: service_healthy
networks:
- gateway-net
app:
image: example/backend:latest
expose:
- "8080"
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
interval: 10s
timeout: 3s
retries: 5
networks:
- gateway-net
networks:
gateway-net:
volumes:
nginx-logs:启动 Compose 项目:
bash
docker compose up -d预期输出
text
Container gateway Started
Container app Started该配置中,Nginx 不直接绑定后端容器 IP,而是依赖 Compose 服务发现。健康检查通过后,网关才进入可用状态。
配置 Nginx 转发后端服务
Nginx 配置中使用 Compose 服务名作为 upstream 地址,使配置与容器生命周期解耦。
nginx
http {
upstream backend_pool {
server app:8080;
}
server {
listen 80;
location / {
proxy_pass http://backend_pool;
}
}
}预期结果
text
客户端请求 http://<HOST>:<PORT>/
Nginx 转发到 app:8080
后端服务返回响应如果服务名无法解析,通常说明容器没有加入同一个网络,或者 Compose 服务名称与 Nginx 配置不一致。
验证部署和处理失败情况
部署完成后,应分别检查容器状态、网络连接和日志目录。
bash
docker compose ps
docker compose logs gateway预期输出
text
NAME STATUS
gateway running
app healthy常见问题包括健康检查路径错误、挂载配置文件失败以及端口冲突。排查时优先确认 Compose 配置解析结果,再检查容器内部日志。
按自己的节奏,确认真正理解。