add_before_body
指令 `add_before_body` 允许你在 NGINX 的 HTTP 响应体之前插入额外内容。 — NGINX HTTP Core
add_before_body
httpserverlocation
语法add_before_body content;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1
说明
指令 `add_before_body` 在 NGINX HTTP core module 中使用,用于在响应体发送给客户端之前追加特定内容。这在无需修改应用或后端服务器的情况下,直接将脚本、注释或其他标记注入响应载荷时特别有用。插入的内容可以定义为字符串字面量,在请求处理阶段作为 HTTP 响应的一部分输出。 该指令可在 `http`、`server` 和 `location` 等上下文中指定,从而实现对内容插入位置的细粒度控制。该指令的参数是一个字符串值,表示要添加的内容。配置后,`add_before_body` 在输出阶段处理请求,确保指定内容位于原始响应体之前。 由于这会修改响应结构,因此必须确保插入的内容不会干扰响应的内容类型或结构。应仔细考虑所添加的内容,以保持有效的 HTTP 响应格式。
配置示例
http {
server {
location /example {
add_before_body '';
}
}
}⚠
确保插入的内容是有效的,并且不会破坏主响应体的结构。
⚠
使用大量内容可能会影响响应大小和性能。
⚠
避免添加会无意中更改内容类型的内容。