如何使用 ngx_http_mirror_module 实现生产环境流量的无损镜像实时压测-Nginx-PHP中文网

Nginx mirror模块可零成本实现生产流量实时镜像压测：需1.13.4+版本、启用模块，配置mirror指令指向/internal路由，proxy_pass转发并开启mirror_request_body on，异步非阻塞执行，不干扰主链路。

如何使用 ngx_http_mirror_module 实现生产环境流量的无损镜像实时压测

使用 ngx_http_mirror_module 进行生产环境流量镜像压测，核心在于「不干扰主链路、真实请求零丢失、镜像请求可控制」。它不是复制整个 TCP 连接，而是对原始请求的 HTTP 头和请求体做一次异步、非阻塞的克隆转发，主响应完全不受影响。

确保 Nginx 版本支持并启用模块

该模块自 Nginx 1.13.4 起作为标准模块内置，无需单独编译。确认方式：

运行 nginx -V 2>&1 | grep -o with-http-mirror-module，有输出即已启用
若为旧版本（如 1.12.x），需升级或重新编译时添加 --with-http-mirror-module
注意：OpenResty 默认包含该模块，但部分精简版可能剔除，建议用 openresty -V 验证

基础镜像配置：最小安全压测结构

镜像必须是非阻塞的，且不能让压测服务拖慢线上。典型配置示例如下：

location /api/ {
    # 主服务代理
    proxy_pass http://prod_backend;
<pre class="brush:php;toolbar:false;"># 启用镜像（仅对匹配 location 的请求生效）
mirror /mirror;
mirror_request_body on;  # 必须开启，否则不镜像 request body

# 镜像子请求配置（独立于主请求生命周期）
location = /mirror {
    internal;  # 强制内部访问，禁止外部直接调用
    proxy_pass http://stress_backend$request_uri;
    proxy_pass_request_body on;
    proxy_set_header X-Original-Host $host;
    proxy_set_header X-Mirror-Traffic "true";
    proxy_buffering off;     # 关闭缓冲，降低延迟感知
    proxy_ignore_client_abort on;  # 客户端断开不影响镜像发送
}

}

关键点：
- mirror 指令触发子请求，不等待其完成；
- internal 是硬性要求，防止压测服务被误访问或滥用；
- proxy_ignore_client_abort on 确保用户关掉页面或超时，镜像仍能发完。

生产级增强：过滤、限流与可观测性

直接镜像全量流量风险高，需叠加控制策略：

按条件镜像：用 map 或 if（谨慎）限制范围，例如只镜像 POST 请求或特定 Header
采样率控制：结合 split_clients 实现百分比镜像（如 5%），避免压测服务过载
请求头脱敏：在 /mirror 块中用 proxy_set_header 清除敏感字段（如 Authorization、Cookie）
日志分离：为镜像请求单独定义 log_format 和 access_log，便于识别与分析

示例采样配置：

split_clients "$remote_addr$remote_port" $mirror_flag {
    5%    "true";
    *     "false";
}
server {
    location /api/ {
        mirror /mirror;
        mirror_request_body on;
        # 仅当 $mirror_flag 为 "true" 时才真正触发镜像
        mirror /mirror if=$mirror_flag;
    }
}