uwsgi_pass_header
`uwsgi_pass_header` 指令用于指定从 uWSGI 应用传递到客户端响应的头部。 — NGINX HTTP Core
uwsgi_pass_header
httpserverlocation
语法uwsgi_pass_header header_name;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1
说明
`uwsgi_pass_header` 指令是 NGINX 的 uWSGI 模块中的一个配置选项,允许用户指定由 uWSGI 应用返回并在响应中传递给客户端的特定头部。该指令可以在 `http`、`server` 或 `location` 上下文中指定,从而在 NGINX 服务器的不同部分实现灵活配置。该指令的参数是单个头部名称,必须与 uWSGI 应用在响应中包含的头部名称相匹配。 使用 `uwsgi_pass_header` 指令时,只有被指定的头部会被转发到客户端,这有助于控制暴露的信息并确保相关头部被一致地返回。这对于传递应用特定数据的头部特别有用,例如版本信息、安全令牌或自定义的应用状态消息。通过有选择地传递头部,管理员可以提升安全性并减少不必要的数据传输。 如果需要传递多个头部,可以在同一配置块中多次声明 `uwsgi_pass_header` 指令,每次指定一个不同的要转发的头部。整体行为还取决于 uWSGI 服务器的配置,NGINX 在尝试转发到客户端之前会确保这些指定的头部确实存在于响应中。
配置示例
location /app {
include uwsgi_params;
uwsgi_pass my_app;
uwsgi_pass_header X-My-Custom-Header;
}⚠
确保所指定的 header 名称与 uWSGI 响应中出现的完全一致(包括大小写)。
⚠
如果 uWSGI 应用未设置某个 header,则无法通过 `uwsgi_pass_header` 传递该 header,可能会造成混淆。