如何配置Docker中Nginx的反向代理？

Question

如何在Docker中配置Nginx实现反向代理？常见问题包括：如何编写Nginx配置文件、如何将Nginx与后端服务容器互联、如何通过Docker Compose编排多个服务并正确设置代理规则？此外，还常涉及如何处理跨域请求、如何配置HTTPS以及如何调试代理失败等问题。掌握这些关键点，能有效提升应用部署效率和稳定性。

Answer 1

如何在 Docker 中配置 Nginx 实现反向代理

随着微服务架构的普及，使用 Nginx 作为反向代理来统一管理多个后端服务成为常见的部署方式。结合 Docker 容器化技术，可以实现高效、灵活的服务编排与负载均衡。

1. 编写 Nginx 配置文件

Nginx 的核心在于其配置文件，通常位于 /etc/nginx/conf.d/default.conf 或 /etc/nginx/nginx.conf。一个基本的反向代理配置如下：

server {
    listen 80;

    location /api/ {
        proxy_pass http://backend:3000/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

• listen: 监听端口
• location: 匹配请求路径
• proxy_pass: 转发到的目标地址
• proxy_set_header: 设置请求头信息，便于后端识别来源

2. 将 Nginx 与后端服务容器互联

Docker 容器之间可以通过自定义网络进行通信。创建一个自定义桥接网络，并将所有服务加入该网络：

docker network create mynetwork
docker run -d --name backend --network mynetwork myapp:latest
docker run -d --name nginx --network mynetwork -p 80:80 mynginx:latest

容器名	用途	网络
backend	Node.js 后端服务	mynetwork
nginx	Nginx 反向代理	mynetwork

在 Nginx 配置中，通过容器名称（如 http://backend:3000）即可访问其他容器。

3. 使用 Docker Compose 编排多个服务

Docker Compose 是管理多容器应用的利器。以下是一个典型配置：

version: '3'
services:
  backend:
    image: myapp:latest
    ports:
      - "3000"
    networks:
      - appnet

  nginx:
    image: mynginx:latest
    ports:
      - "80:80"
    depends_on:
      - backend
    networks:
      - appnet

networks:
  appnet:

1. 定义两个服务：backend 和 nginx
2. 指定依赖关系：depends_on 确保 backend 先启动
3. 共享自定义网络：networks 保证容器间可通信

4. 处理跨域请求（CORS）

前端访问后端 API 时常遇到跨域问题。可以在 Nginx 配置中添加响应头解决：

add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
add_header 'Access-Control-Max-Age' 1728000;
add_header 'Access-Control-Allow-Credentials' 'true';

5. 配置 HTTPS 支持

启用 HTTPS 可提升安全性。需准备 SSL 证书并修改 Nginx 配置：

server {
    listen 443 ssl;
    ssl_certificate /etc/nginx/ssl/mydomain.crt;
    ssl_certificate_key /etc/nginx/ssl/mydomain.key;

    location /api/ {
        proxy_pass http://backend:3000;
        ...
    }
}

也可使用 Let’s Encrypt 自动获取证书，推荐结合 Certbot 工具。

6. 调试代理失败问题

常见故障排查步骤：

1. 检查容器是否运行：docker ps
2. 查看日志：docker logs nginx
3. 确认 DNS 解析：curl backend:3000 是否能通
4. 测试代理规则是否命中：curl -v http://localhost/api/test

graph TD
    A[Client Request] --> B{Nginx 接收}
    B --> C[解析配置]
    C --> D{匹配 location ?}
    D -- Yes --> E[转发至 backend]
    D -- No --> F[返回 404]
    E --> G[后端处理]
    G --> H[响应客户端]