grpc_ignore_headers
grpc_ignore_headers 指令指定在处理请求时要忽略哪些 gRPC 头部。 — NGINX HTTP Core
grpc_ignore_headers
httpserverlocation
语法grpc_ignore_headers header-name [header-name ...];
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1+
说明
grpc_ignore_headers 指令允许用户指定一个在请求处理期间应被忽略的 gRPC 头列表。该指令接受一个或多个头名作为参数,任何与所列名称匹配的头都将被 NGINX 服务器排除在处理之外。这在某些场景下很有用,例如特定头可能会干扰应用逻辑,或安全策略要求从客户端请求中排除特定头。 该指令可用于 http、server 或 location 上下文,这意味着其作用可以限定为整个服务器、某个特定的虚拟主机,或甚至某个特定的 location 块。使用此指令的灵活性允许对 gRPC 流量管理进行细粒度控制。如果未指定任何头,则默认不忽略任何头,意味着默认情况下会处理所有头。 在使用此指令时,重要的是确保您选择忽略的头不会破坏 gRPC 应用程序的预期功能。忽略关键头可能导致应用出现意外行为,因为服务器可能无法接收处理请求所需的必要数据。
配置示例
location /grpc {
grpc_pass grpc://backend;
grpc_ignore_headers
x-grpc-status
x-user-header;
}⚠
确保不要忽略必要的请求头,因为这可能导致应用错误。
⚠
注意使用 grpc_ignore_headers 的上下文;如果将其放在错误的上下文中,可能会导致意外行为。