如何通过 ngx_http_mirror_module 实现生产环境负载均衡流量的实时镜像操作？

本文共计1146个文字，预计阅读时间需要5分钟。

ngx_http_mirror_module 本身不用于负载均衡，也不提供一键实时镜像的即用功能。它是一个请求复制模块，主要作用是将进入 Nginx 的原始请求（仅读、非阻塞）异步阻塞到指定的镜像服务器，而不会影响主请求的正常处理流程和响应。

在生产环境中实现流量镜像，关键在于正确配置 mirror 指令、合理设计镜像后端以及配置可观测性和稳定性保障措施。

明确 mirror 模块的核心行为

理解以下三点，避免常见误用：

• 只复制请求，不复制响应：镜像请求的返回结果被 Nginx 完全忽略，不会影响客户端响应内容、状态码或响应头。
• 非阻塞、异步发送：主请求处理不受镜像请求超时、失败或慢响应影响；即使镜像服务宕机，主链路完全不受损。
• 仅支持单个镜像目标（或通过 upstream 配合实现有限轮询）：mirror 指令只接受一个 URI 或 location，不能原生做多目标分发或加权镜像。