ngx_http_mirror_module可实现生产流量一键实时镜像压测，核心是异步非阻塞镜像原始请求至压测服务，主流程零干扰；通过mirror指令精准控制时机，支持多目标、按路径分组、运行时开关，需压测服务配合接收与回放。

使用 ngx_http_mirror_module 实现生产流量的一键实时镜像同步压测，核心在于“不干扰线上、零侵入、可随时启停”。它不是复制请求体或响应，而是将原始请求（含 header、body、method、uri）**异步、非阻塞地镜像一份到指定压测服务**，主流程完全不受影响。

配置 mirror 指令，精准控制镜像时机

镜像行为由 mirror 指令触发，支持在 location 或 server 块中配置。关键点：

• 只对匹配该 location 的请求生效，可按 path、host 或 upstream 分组镜像（例如仅镜像 /api/v1/order）
• 支持多个 mirror 指令，实现多目标并行镜像（如同时发往压测集群 A 和 B）
• 镜像请求默认复用原始请求的 method、headers、body；若需改写，需配合 mirror_request_body off + proxy_pass_request_body off + 自定义 body（较复杂，通常不建议）
• 推荐搭配 mirror_request_body on（默认），确保 POST/PUT 等带 body 的请求完整镜像

压测服务需具备接收与回放能力

镜像本身只是“转发”，压测服务必须能正确解析并处理镜像请求：

• 部署一个轻量 HTTP 服务（如 Python Flask / Go net/http），监听 /mirror 或任意路径，接收镜像请求
• 服务需原样记录请求信息（时间戳、header、body、uri），并可选做去重、采样、打标（如加 X-Mirror-Traffic: true）
• 若需真实回放压测，建议将镜像日志接入消息队列（Kafka/RocketMQ），再由压测引擎（如 JMeter + Custom Plugin、Gatling、自研工具）消费并发起真实调用
• 注意：镜像请求是“单向”且“无响应等待”的，压测服务返回 200/500 对主链路完全无影响

一键启停：用变量 + map 实现运行时开关

避免重启 Nginx，通过变量动态控制是否启用镜像：

• 定义 map 变量，例如：
  

  map $http_x_mirror_switch $do_mirror {<br>  "on" 1;<br>  default 0;<br>}

• 在 location 中使用：
  mirror /mirror$request_uri if=$do_mirror;
• 压测时，客户端或网关层在请求头中带上 X-Mirror-Switch: on 即可激活镜像；去掉该 header 或设为 off，立即停止
• 进阶：结合 Consul/K8s ConfigMap 动态下发开关值，实现全集群统一调度

注意事项与典型问题规避

实际落地中易踩坑，需提前确认：

• Body 读取限制：Nginx 默认只读取部分 body 用于路由判断。若镜像 POST 大文件，需确保 client_max_body_size 足够，且 mirror_request_body on 生效（Nginx ≥ 1.13.4）
• Header 透传：镜像请求默认携带原始所有 headers，但 Connection、Keep-Alive 等 hop-by-hop header 会被自动过滤，无需手动清理
• 性能开销：镜像为异步子请求，实测单机万级 QPS 下 CPU 增幅 mirror_timeout 控制超时）
• HTTPS 镜像：若压测服务是 HTTPS，需在 mirror 后的 proxy_pass 中配置 proxy_ssl_verify off（测试环境）及证书信任链（生产环境）