mirror_request_body

'mirror_request_body' 指令控制是否在 NGINX 中镜像请求体。 — NGINX HTTP Core

mirror_request_body
httpserverlocation
语法mirror_request_body on | off;
默认值off
上下文http, server, location
模块NGINX HTTP Core
参数flag

说明

'mirror_request_body' 指令在 NGINX 配置中用于启用或禁用请求体的镜像。当设置为 'on' 时,它允许将当前请求接收的请求体作为新的镜像请求发送到由 'mirror' 指令定义的上游服务器。该功能在调试时尤其有用,或在需要在执行一些非侵入性操作时保留原始请求的场景下非常重要。镜像请求体会影响性能,因为它需要额外的内存用于缓冲,并且将请求体传输到上游服务器时会产生网络开销。

配置示例

location /api {
    mirror_request_body on;
    mirror /mirror_endpoint;
}

确保镜像不会导致意外的请求处理或性能下降。

注意大型请求体,因为它们可能由于缓冲而导致内存使用增加。

如果管理不当,镜像的请求体可能会在处理原始请求时引入延迟。