在 nginx 中,响应头字段的添加与请求头的转发是两个独立的配置指令。要实现同时满足这两个需求,只需在 `location` 或 `server` 块中分别使用 `add_header` 和 `proxy_set_header` 即可。`add_header` 用于向客户端返回的 http 响应中添加自定义字段,而 `proxy_set_header` 用于修改 nginx 向后端服务器发起的请求中的 header 信息。

如何添加自定义响应头字段
要添加响应头,需使用 add_header 指令。该指令接受两个参数:第一个是头部名称,第二个是头部值。Nginx 默认会在所有状态码(包括错误页)下添加这些头,除非指定了特定的状态码列表。例如,添加一个名为 X-Custom-Header 且值为 MyValue 的响应头,配置如下:

server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_server;
# 添加自定义响应头
add_header X-Custom-Header "MyValue" always;
}
}
上述配置中,always 关键字确保即使后端返回错误状态码(如 4xx 或 5xx),Nginx 也会添加该响应头。如果不加 always,则仅在成功响应(2xx, 3xx)时生效。实际测试中,访问 http://example.com/ 后,通过浏览器开发者工具或 curl -I 命令可以看到响应头中包含 X-Custom-Header: MyValue。
如何转发并修改请求头
要控制请求头转发,需使用 proxy_set_header 指令。Nginx 默认会转发客户端发送的大部分原始请求头,但某些特定头(如 Host、Connection、Keep-Alive)需要显式设置才能正确传递给后端。例如,将 Host 头设置为后端服务器的域名,并添加一个自定义请求头 X-Forwarded-For-App:

server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_server;
# 转发 Host 头
proxy_set_header Host $host;
# 转发真实的客户端 IP
proxy_set_header X-Real-IP $remote_addr;
# 添加自定义请求头
proxy_set_header X-Forwarded-For-App "InternalApp";
}
}
在此配置中,$host 变量代表客户端请求中的 Host 头值,$remote_addr 代表客户端的 IP 地址。后端服务器接收到请求后,可以通过解析 X-Forwarded-For-App 头来识别请求来自 Nginx 代理层。验证方法是启动一个简单的后端服务(如 Python Flask 应用),打印接收到的所有请求头,确认 X-Forwarded-For-App 存在且值为 InternalApp。
当后端返回 404 时响应头是否依然生效
当后端返回 404 错误时,响应头是否生效取决于 add_header 指令是否使用了 always 参数。如果未使用 always,Nginx 默认不会在错误响应中添加自定义头;如果使用 always,则无论后端返回何种状态码,自定义头都会被添加到最终响应中。这一行为可通过对比两种配置下的 curl -I 输出结果进行验证。


















