fastcgi_pass_header

'fastcgi_pass_header' 指令指定应从 FastCGI 服务器传递到客户端响应的哪些头部。 — NGINX HTTP Core

fastcgi_pass_header
httpserverlocation
语法fastcgi_pass_header header_name;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

'fastcgi_pass_header' 指令允许您定义应包含在发送给客户端的响应中的、从 FastCGI 服务器接收到的哪些 HTTP 头部。该指令可以在同一上下文中多次指定,从而允许传递多个头部。当处理请求且 FastCGI 服务器返回头部时,NGINX 会根据 'fastcgi_pass_header' 提供的配置筛选这些头部。只有与该指令中指定的头部匹配的头部会被包含在最终发回客户端的输出中,所有其他头部将被忽略。这对于控制哪些元数据或指令被传回客户端特别有用,可以提高安全性或仅关注相关数据。 'fastcgi_pass_header' 指令可以在 'http'、'server' 和 'location' 上下文中定义,使其在各种配置中具有灵活性。通过使用此指令,管理员可以确保敏感头部不会被暴露,或防止无关头部使响应杂乱。需要注意的是,该指令与 FastCGI 配置配合使用,并且需要 'fastcgi_pass' 指令将流量定向到 FastCGI 服务器。 配置的一个重要方面是要理解头部名称不区分大小写,但其值是否区分大小写可能取决于应用程序。因此,在定义要传递的头部时,应确保值的拼写和大小写保持一致,以确保正确的运行完整性。

配置示例

location /some_location {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_pass_header X-My-Custom-Header;
}

确保你要传递的头部确实存在于 FastCGI 响应中;否则不会发送任何内容。

如果 FastCGI 服务器未被正确配置以发送预期的头部,则此指令无效。

在此指令中指定的头部必须拼写正确,并且其大小写应与 FastCGI 服务器发送的保持一致。