
一个可用的反向代理只需要三行核心指令:监听、代理地址、转发头。其余都是优化项。先把最小配置跑通,再逐项添加,排查问题时更容易定位。
需要注意的是 proxy_pass 末尾是否带斜杠,会直接改变路径拼接方式。带斜杠表示替换匹配到的路径前缀,不带则原样拼接。这一处错误是路径 404 的高发原因。
后端需要知道真实访问者的地址与协议,否则日志里全是代理 IP,程序生成的链接也会变成 http。
至少要转发三项:Host、真实 IP、协议。真实 IP 通过 X-Forwarded-For 与 X-Real-IP 传递,协议通过 X-Forwarded-Proto 传递。转发后还要确认后端程序信任这些头,否则可能被伪造。
静态资源适合交给 Nginx 直接返回,或设置较长的缓存时间。图片、样式、脚本按后缀匹配,设置合理的过期时间与浏览器缓存头。
动态页面不宜盲目缓存。若确实需要,按路径或参数区分,登录态页面必须排除在外,否则会出现串号这类严重问题。
默认超时时间偏短,接口处理较慢时会出现 504。可以分别调整连接超时、读取超时与发送超时。
重试要谨慎。对非幂等的请求(如支付、下单)重试可能造成重复提交,建议只在连接阶段失败时重试。
一是忘记配置请求体大小上限,文件上传直接报错;二是 WebSocket 未设置协议升级头,长连接建立失败;三是压缩与已压缩资源重复处理,反而增加 CPU 开销;四是缓冲区过小导致大响应被截断;五是证书链不完整,部分客户端提示不安全。
验证顺序建议是:先看首页是否正常,再看静态资源是否命中缓存,然后测试上传与登录,最后压测接口看超时表现。
每次改动前备份配置,改动后用 nginx -t 校验再重载,避免因语法错误导致整站不可用。
反向代理的配置项很多,真正影响稳定性的其实就那么几个:路径拼接、转发头、超时、缓冲。把这四项确认清楚,绝大多数问题都能避免。