Nginx proxy_pass 高性能转发需精准路径处理、透传四大代理头、优化连接复用、绕过静态资源。带斜杠剥离前缀，不带则全量追加；必设 Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto；启用 HTTP/1.1 长连接及 WebSocket 三件套；静态资源由 Nginx 直接响应。
要让 Nginx 的 proxy_pass 实现真正高性能的服务转发，不能只写一行转发指令。关键在于路径处理精准、请求头透传完整、连接复用合理，同时规避常见性能陷阱。
路径拼接必须严格区分斜杠
末尾斜杠不是风格问题，而是路径重写的开关：
-
带斜杠（如
proxy_pass http://127.0.0.1:3000/;）：location 匹配前缀被完全剥离，后端收到的是干净的相对路径。例如location /api/ { ... }下访问/api/users，后端实际接收/users -
不带斜杠（如
proxy_pass http://127.0.0.1:3000;）：原始 URI 全量追加，后端收到/api/users—— 这容易导致 404，尤其当后端服务未挂载在根路径时 - 正则 location 中必须写全目标 URI，不能省略路径部分，否则 Nginx 会报错或行为异常
四大代理头缺一不可
默认情况下 Nginx 不传递任何原始客户端信息，后端若依赖这些字段就会出错：
Bailian Usage Proxy
下载
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
-
proxy_set_header Host $host;：保持原始 Host 域名，避免后端因识别不到虚拟主机返回 404 -
proxy_set_header X-Real-IP $remote_addr;：直接传递最外层真实 IP（直连或单层代理场景） -
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;：链式追加 IP，支持多级代理（CDN → LB → Nginx → 后端） -
proxy_set_header X-Forwarded-Proto $scheme;：告知后端当前是 http 还是 https，影响重定向生成和安全策略判断
连接与协议优化提升吞吐
默认配置下连接复用率低、升级能力缺失，会拖慢 WebSocket 和 HTTPS 场景：
- 启用 HTTP/1.1 长连接：
proxy_http_version 1.1;+proxy_set_header Connection "";（清空 Connection 头，允许复用） - WebSocket 支持三件套：
proxy_http_version 1.1;+proxy_set_header Upgrade $http_upgrade;+proxy_set_header Connection "upgrade"; - HTTPS 后端需显式开启 SSL 选项：
proxy_ssl_verify off;（仅限开发）、proxy_ssl_server_name on;（SNI 支持）
静态资源绕过代理减轻后端压力
把前端资源交给 Nginx 直接响应，不经过 proxy_pass，能显著降低后端负载和延迟：
- 将静态规则放在 proxy 规则之前，利用最长匹配优先原则
- 示例：
location ~* \.(js|css|png|jpg|gif|woff2?)$ { root /var/www/dist; expires 1y; add_header Cache-Control "public"; } - 注意 root 路径需与 URL 路径对齐，或配合 alias 使用避免路径拼接错误
