proxy_pass_header
`proxy_pass_header` 指令指定应从被代理服务器传递到客户端的头部。 — NGINX HTTP Core
proxy_pass_header
httpserverlocation
语法proxy_pass_header header_name;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1
说明
`proxy_pass_header` 指令用于 NGINX 配置文件中 `http`、`server` 或 `location` 块的上下文中。该指令允许用户指明在响应由被代理服务器生成时,应包含在从 NGINX 服务器返回给客户端的 HTTP 响应中的特定 HTTP 头。默认情况下,NGINX 会将来自上游服务器的某些头传递给客户端,但 `proxy_pass_header` 指令为用户提供了根据需要添加或限制特定头的灵活性。这对于管理安全性、缓存行为或根据环境定制响应尤其有用。 在使用 `proxy_pass_header` 时,可以指定多个头,从而微调需要传递的头。例如,如果被代理服务器设置了客户端需要接收的自定义头,此指令可以确保该头与响应一起转发回原始客户端。相反,如果有出于安全或隐私考虑不应共享的头,此指令可以用于控制该行为。了解操纵头的影响非常重要,尤其是在安全上下文、缓存和客户端兼容性方面。
配置示例
location /api {
proxy_pass http://backend;
proxy_pass_header X-Custom-Header;
}⚠
确保上游服务器响应中存在指定的头部;否则这些头部将不会被传递给客户端。
⚠
使用过多的头部会增加响应大小,因此仅传递必要的头部。