Nginx反向代理架构设计与基础配置流程-Nginx-PHP中文网

Nginx反向代理核心是统一入口、负载分发、协议/路径转换；需配置upstream、server块、关键代理头、静态资源与超时；规避502、重定向异常、WebSocket断连、大文件上传等问题。

nginx反向代理架构设计与基础配置流程

用Nginx做反向代理，核心是把外部请求“转交”给后端服务，同时隐藏真实服务器细节。关键不在配置多复杂，而在于理清流量路径、明确角色分工、提前规避常见坑点。

明确反向代理的核心职责

反向代理不是万能中转站，它主要承担三件事：统一入口（所有请求先到Nginx）、负载分发（可选，单台后端也适用）、协议/路径转换（如HTTP→HTTPS、/api→后端8080端口）。不需要它做业务逻辑、不建议它存大量静态资源（除非小文件且CDN未介入）。

基础配置四步走

1. 定义上游服务（upstream）
即使只有一台后端，也建议用upstream块定义，方便后续扩展。例如：

upstream backend {
    server 127.0.0.1:8080;
    # 可加 weight、max_fails、fail_timeout 等参数
}

2. 配置server块监听与路由
指定监听端口、域名、匹配规则。常用写法：

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;">location / {
    proxy_pass http://backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

}

3. 关键代理头必须设置
- Host：确保后端收到原始Host头，否则可能404或跳转错乱；
- X-Real-IP / X-Forwarded-For：让后端能拿到真实客户端IP（注意：X-Forwarded-For可能被伪造，生产环境建议配合real_ip_module+可信代理段使用）；
- 若后端是HTTPS服务，还需加 proxy_set_header X-Forwarded-Proto $scheme;。

4. 处理静态资源与超时
- 静态文件（js/css/img）建议由Nginx直接serve，避免穿透代理：

location ~* \.(js|css|png|jpg|gif)$ {
    root /var/www/static;
    expires 1h;
}

- 调整超时防止长连接卡死：

proxy_connect_timeout 30s;<br>
proxy_send_timeout 60s;<br>
proxy_read_timeout 60s;

典型问题与应对要点

- 502 Bad Gateway：后端没起来、端口不通、proxy_pass地址写错（注意末尾斜杠是否一致）；
- 重定向跳转异常（301/302跳到内网地址）：后端应用生成了绝对URL，需在Nginx加 proxy_redirect 或让后端读取X-Forwarded-*头动态构造；
- WebSocket断连：需显式开启升级头：

proxy_http_version 1.1;<br>
proxy_set_header Upgrade $http_upgrade;<br>
proxy_set_header Connection "upgrade";

；
- 大文件上传失败：检查 client_max_body_size 和后端框架的上传限制是否匹配。

上线前必查清单

确认Nginx用户对配置文件、日志目录有读写权限
用 nginx -t 验证语法，再 nginx -s reload 生效
检查 error.log 是否有connect refused、no live upstream等报错
curl测试时加 -v 查看响应头和真实返回地址
用 netstat -tuln | grep :80 确认Nginx确实在监听