Nginx反向代理头部传递（从零开始掌握请求头透传技巧）

为什么需要传递请求头？

当你通过 Nginx 将请求转发给后端（如 Node.js、Java Spring Boot 或 PHP 应用）时，后端看到的“客户端”其实是 Nginx 服务器本身。这意味着：

• 真实客户端 IP 变成了 127.0.0.1 或 Nginx 的内网 IP
• Host 头可能被替换为后端服务器地址
• 原始的 User-Agent、Referer 等信息可能丢失

这会导致日志记录错误、安全策略失效（如 CORS）、甚至功能异常（如基于 IP 的限流）。因此，正确配置 代理头部设置 至关重要。

核心配置指令详解

Nginx 提供了多个指令来控制请求头的传递行为，最常用的是 proxy_set_header。

1. 传递客户端真实 IP

使用 X-Real-IP 和 X-Forwarded-For 是行业标准做法：

location / {    proxy_pass http://backend_server;    proxy_set_header X-Real-IP $remote_addr;    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;}  

说明：

• $remote_addr：客户端的真实 IP 地址
• $proxy_add_x_forwarded_for：在原有 X-Forwarded-For 值后追加客户端 IP，适用于多层代理

2. 保留原始 Host 头

如果不设置，后端可能收不到正确的域名信息：

proxy_set_header Host $http_host;  

注意：使用 $http_host 会包含端口号（如果有的话），而 $host 只包含域名部分且小写。

3. 传递其他关键头部

为了保持请求完整性，建议传递以下头部：

proxy_set_header User-Agent $http_user_agent;proxy_set_header Accept-Encoding "";proxy_set_header Connection "";proxy_set_header Referer $http_referer;  

其中，清空 Accept-Encoding 和 Connection 是为了避免 Nginx 与后端之间的压缩或连接复用冲突。

完整配置示例

下面是一个典型的反向代理配置，适用于大多数 Web 应用：

server {    listen 80;    server_name example.com;    location / {        proxy_pass http://127.0.0.1:3000;  # 后端服务地址        # 关键头部传递        proxy_set_header Host $http_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;        # 其他常用头部        proxy_set_header User-Agent $http_user_agent;        proxy_set_header Accept-Encoding "";        proxy_set_header Connection "";    }}  

配置完成后，记得重载 Nginx：

sudo nginx -s reload  

验证是否生效

你可以在后端打印接收到的所有请求头，或者使用如下命令测试：

curl -H "X-Forwarded-For: 1.2.3.4" \     -H "User-Agent: MyTestClient" \     http://your-domain.com/debug-headers  

如果后端能正确输出 X-Forwarded-For: 1.2.3.4, your-real-ip 和 User-Agent: MyTestClient，说明 请求头传递 配置成功！

常见误区提醒

• 不要重复设置 proxy_set_header，后面的会覆盖前面的
• 避免直接传递所有 $http_* 头部，可能带来安全风险
• 在 HTTPS 场景下，记得设置 X-Forwarded-Proto: https

掌握这些技巧后，你就能轻松应对各种 Nginx 反向代理场景，确保前后端通信无误。快去试试吧！