Nginx反向代理核心是正确配置proxy_pass及配套头信息与超时参数。末尾斜杠影响路径重写；必须设置Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto等头；需补全proxy_redirect、WebSocket支持和超时配置。

在 Linux 系统中用 Nginx 配置 proxy_pass 实现反向代理，核心是让 Nginx 接收客户端请求后，把请求转发给后端服务（如 Node.js、Python Flask、Java 应用等），再把响应原样返回给用户。关键不在“能不能转”，而在于路径处理、头信息、超时和协议一致性是否正确。

基础 proxy_pass 配置写法

最简配置示例（假设后端服务运行在 http://127.0.0.1:3000）：

location / {
    proxy_pass http://127.0.0.1:3000;
}

注意：proxy_pass 后面的 URL 末尾是否有斜杠（/），会极大影响路径拼接逻辑：

• 写成 proxy_pass http://127.0.0.1:3000;（无尾部 /）→ 请求 /api/user 会被完整转发为 http://127.0.0.1:3000/api/user
• 写成 proxy_pass http://127.0.0.1:3000/;（有尾部 /）→ 请求 /api/user 会被重写为 http://127.0.0.1:3000/user（/api 被剥离）

必须设置的关键代理头信息

如果不显式设置，后端可能拿不到真实客户端 IP、协议类型或 Host，导致日志不准、HTTPS 判断失败、重定向异常等问题。推荐在 location 块内加上：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

其中：

• X-Real-IP 和 X-Forwarded-For 是后端获取用户真实 IP 的主要依据
• X-Forwarded-Proto 让后端知道原始请求是 HTTP 还是 HTTPS，避免强制跳转出错

常见问题与对应配置补丁

实际部署中容易踩坑的地方：

• 后端返回 302 重定向地址错误：Nginx 默认不改写后端响应里的 Location 头。可加 proxy_redirect http://127.0.0.1:3000/ /; 或设为 proxy_redirect default; 自动适配
• WebSocket 连接失败：需额外透传升级头：proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
• 大文件上传/长连接超时：增加超时时间：proxy_connect_timeout 60; proxy_send_timeout 60; proxy_read_timeout 60;
• 静态资源缓存干扰动态接口：建议按路径区分 location，例如 location /static/ { ... } 直接 serve 文件，location /api/ { proxy_pass ... } 走代理

验证与调试小技巧

配置完别急着 reload，先检查语法并观察日志：

• 执行 sudo nginx -t 确保配置无语法错误
• 修改后运行 sudo systemctl reload nginx（非 restart，避免中断连接）
• 查看错误日志：sudo tail -f /var/log/nginx/error.log
• 临时在后端打印 X-Forwarded-For 和 X-Forwarded-Proto 值，确认头已透传