add_trailer
`add_trailer` 指令允许您在 HTTP/2 和 HTTP/3 协议的 response trailer 中追加自定义 headers。 — NGINX HTTP Core
add_trailer
httpserverlocationif in location
语法add_trailer name value ...;
默认值none
上下文http, server, location, if in location
模块NGINX HTTP Core
参数2-3
说明
`add_trailer` 指令用于指定包含在 HTTP/2 和 HTTP/3 响应的 response trailer 部分的自定义 header 字段。Trailers 是在消息体之后发送的额外 HTTP 头。这对于在主负载发送完成后才能确定的元数据或状态信息很有用。 该指令接受 2 到 3 个参数:第一个参数是要添加的 header 的名称,后续参数是与该 header 关联的 values。values 可以包含 variables,使该指令在处理动态 header 内容时更灵活。如果指定了多个 values,它们将用逗号连接。 需要注意,并非所有 clients 都能良好处理 trailers,因此开发者应确保其 applications 能正确处理包含 trailer 信息的响应。此外,使用该指令时应谨慎,因为它可能会根据添加的 headers 影响 caching 和 client 行为。
配置示例
server {
location /example {
add_trailer X-Custom-Trailer "Trailer Value";
}
}⚠
并非所有客户端都支持响应尾部(trailers),这可能会限制 `add_trailer` 指令的可用性。
⚠
确保格式正确并使用有效的头部名称,以避免由于不正确的 HTTP 头部而产生的问题。