Nginx 代理头部的传递详解

Nginx 作为一款高性能的反向代理服务器，广泛应用于 Web 服务的负载均衡、缓存、HTTPS 终端代理等场景。作为反向代理服务器，Nginx 不仅会转发请求，还需要处理请求头部（Header）信息的传递。在代理过程中，如何处理和转发 HTTP 头部信息，对于保证请求的正确性、响应的安全性以及用户体验至关重要。

一、Nginx 代理工作原理概述

Nginx 作为反向代理服务器时，负责接收来自客户端的请求，并将请求转发给后台的应用服务器（如 Web 服务器、API 服务器等）。在这个过程中，Nginx 不仅需要转发请求的 URL、请求体（Body），还需要对 HTTP 请求头进行相应的处理和传递。

当 Nginx 将请求转发给后端服务器时，通常需要修改、添加或删除某些头部信息。这是因为有些头部信息（如客户端 IP 地址、原始请求头部等）需要在传递给后端时保持原样，而有些头部（如 Host、Connection、Transfer-Encoding 等）则需要被修改或去除，以确保后端服务器能够正常处理请求。

1.1 Nginx 与后端服务器的交互

Nginx 与后端服务器的交互过程通常通过代理指令 proxy_pass 来完成。请求会被发送到后端服务器的指定地址，并且 Nginx 会处理请求头的转发。例如：

location /api/ {

    proxy_pass http://backend_servers;

}

在上述配置中，proxy_pass 指令将客户端请求转发给名为 backend_servers 的后端服务器池。Nginx 会在这个过程中将客户端请求的头部信息（如 User-Agent、Authorization 等）传递给后端服务器。

二、Nginx 代理头部的传递机制

Nginx 在代理请求时，会自动将某些头部信息传递给后端服务器，但也可以通过配置来修改或添加一些特定的头部信息。Nginx 的代理头部传递主要由以下几个方面控制：

2.1 默认代理头部传递

当 Nginx 配置了反向代理时，默认情况下，它会将以下 HTTP 请求头部转发给后端服务器：

Host：请求中的 Host 头部，表示请求的域名。

User-Agent：客户端的浏览器信息。

Accept-Encoding：客户端支持的压缩方式。

Accept-Language：客户端的语言设置。

Referer：发起请求的页面来源。

Cookie：来自客户端的 cookie 信息。

2.2 常见的头部信息传递配置

在实际的生产环境中，我们通常需要根据需求对 HTTP 头部的传递进行调整。Nginx 提供了一些指令来修改或添加头部信息。常见的指令包括：

proxy_set_header：用来设置代理请求头部，可以添加或修改请求头部的内容。

proxy_pass_request_headers：用于控制是否将请求头部转发给后端服务器，默认为开启。

proxy_pass_request_body：用于控制是否将请求体传递给后端服务器。

2.3 proxy_set_header 指令

proxy_set_header 指令用于修改 Nginx 转发请求时所携带的 HTTP 头部信息。例如，通常需要将客户端的原始 IP 地址传递给后端服务器，这时可以使用 X-Real-IP 和 X-Forwarded-For 头部来传递客户端的 IP 地址。

location / {

    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;

    proxy_pass http://backend_servers;

}

在上面的配置中：

X-Real-IP：将客户端的真实 IP 地址传递给后端服务器。

X-Forwarded-For：将请求链中的所有 IP 地址传递给后端服务器，通常用于追踪请求的来源 IP。

X-Forwarded-Proto：将请求使用的协议（HTTP 或 HTTPS）传递给后端。

通过这种方式，后端服务器能够获取到准确的客户端信息，并做出相应的处理。

2.4 proxy_set_header 指令的常见应用场景

客户端 IP 的传递：在负载均衡或代理场景中，后端服务器通常无法获取客户端的真实 IP 地址，因为请求经过了 Nginx 代理。通过 proxy_set_header 设置 X-Real-IP 和 X-Forwarded-For，可以将客户端的 IP 地址传递给后端。

保持协议一致性：对于 HTTPS 和 HTTP 的请求，Nginx 可以通过 X-Forwarded-Proto 头部来告诉后端请求使用的是哪种协议，从而使得后端能够根据协议来处理请求。

修改 Host 头部：在某些情况下，Nginx 可能需要修改传递给后端的 Host 头部，尤其是在多虚拟主机环境中，Nginx 需要将请求转发到不同的后端服务器。可以通过 proxy_set_header Host 来指定目标主机名。

2.5 proxy_pass_request_headers 和 proxy_pass_request_body

默认情况下，Nginx 会将请求头部和请求体转发给后端服务器，但在某些情况下，我们可能需要禁用请求头部或请求体的转发。通过 proxy_pass_request_headers 和 proxy_pass_request_body 指令，可以控制这一行为。

proxy_pass_request_headers：该指令控制是否将请求头部转发给后端服务器，默认为 on。如果设置为 off，Nginx 将不会转发请求的头部。

location / {

    proxy_pass_request_headers off;

    proxy_pass http://backend_servers;

}

location / {

    proxy_pass_request_body off;

    proxy_pass http://backend_servers;

}

三、代理头部传递中的常见问题与解决方案

3.1 客户端 IP 无法正确传递

在代理请求时，Nginx 默认会替换掉 X-Real-IP 和 X-Forwarded-For 头部。如果没有正确配置，后端服务器可能无法获取到客户端的真实 IP 地址。解决方法是使用 proxy_set_header 指令来传递真实的客户端 IP：

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

3.2 Host 头部传递不正确

有时，后端服务器可能需要接收正确的 Host 头部，尤其是在多个虚拟主机的情况下。如果 Host 头部没有正确传递，后端服务器可能无法正确解析请求的域名。可以使用 proxy_set_header 来修改或设置 Host 头部：

proxy_set_header Host $host;

3.3 请求头部被丢失

某些头部在转发过程中可能会丢失，尤其是在处理 Connection、Transfer-Encoding 等头部时。解决方案是确保在代理时，不会删除或修改关键头部。通过 proxy_set_header 可以确保所需的头部被传递。

3.4 安全问题

在某些情况下，恶意客户端可能会伪造头部信息（如 X-Forwarded-For）。为了避免这种安全风险，应该在 Nginx 上进行严格的访问控制，确保只有可信的代理服务器能够修改这些头部。

四、总结

Nginx 作为反向代理服务器，其代理头部的传递机制非常关键。在处理复杂的 Web 服务架构时，如何合理地配置和传递 HTTP 请求头部，直接影响到后端服务器的正确性和性能。通过合理配置 proxy_set_header、proxy_pass_request_headers 和 proxy_pass_request_body 等指令，Nginx 能够确保客户端请求的头部信息正确、完整地传递给后端服务器，从而使得整个 Web 服务体系更加高效和稳定。

優(yōu)網(wǎng)科技秉承"專業(yè)團隊、品質(zhì)服務" 的經(jīng)營理念，誠信務實的服務了近萬家客戶，成為眾多世界500強、集團和上市公司的長期合作伙伴！

優(yōu)網(wǎng)科技成立于2001年，擅長網(wǎng)站建設、網(wǎng)站與各類業(yè)務系統(tǒng)深度整合，致力于提供完善的企業(yè)互聯(lián)網(wǎng)解決方案。優(yōu)網(wǎng)科技提供PC端網(wǎng)站建設（品牌展示型、官方門戶型、營銷商務型、電子商務型、信息門戶型、微信小程序定制開發(fā)、移動端應用（手機站、APP開發(fā)）、微信定制開發(fā)（微信官網(wǎng)、微信商城、企業(yè)微信）等一系列互聯(lián)網(wǎng)應用服務。