proxy_pass_trailers
`proxy_pass_trailers` 指令控制上游响应中 HTTP 尾部字段(trailers)的处理。 — NGINX HTTP Core
proxy_pass_trailers
httpserverlocation
语法proxy_pass_trailers on | off;
默认值off
上下文http, server, location
模块NGINX HTTP Core
参数flag
说明
`proxy_pass_trailers` 指令用于 NGINX 配置中,用以决定是否应将 HTTP 尾部字段(即在 HTTP 响应主体之后发送的附加首部)从上游服务器转发给客户端。默认情况下,尾部字段可能未启用,意味着它们不会在响应中被转发,这会影响那些需要尾部字段才能正确处理的客户端场景。 当该指令设置为 `on` 时,表示 NGINX 服务器应允许收集上游响应中的尾部字段并将其返回给客户端。这在尾部信息包含重要元数据或需要在接收响应主体后处理的响应详情的应用中尤为相关。该指令在 `http`、`server` 和 `location` 上下文中生效,便于在不同配置范围内灵活使用。 在性能方面,启用尾部字段处理可能会带来轻微开销,因此通常建议仅在绝对必要时启用。每个尾部字段在主体内容之后被添加到响应中,并且必须遵守 HTTP 标准,以确保与期望此类响应结构的客户端兼容。
配置示例
http {
server {
location /api {
proxy_pass http://backend;
proxy_pass_trailers on;
}
}
}⚠
确保后端服务器确实发送 trailers;否则,启用此指令不会产生效果。
⚠
注意不支持 trailers 的客户端,因为这可能导致兼容性问题。