Nginx 通过内置 mirror 模块实现流量镜像，需在 location 中配置 mirror 指令触发异步子请求，主请求不受影响；镜像路径需配 internal 的同名 location 并 proxy_pass 到镜像服务，支持条件镜像与请求头标记。

nginx 中怎么使用 location 配合 mirror 模块实现流量镜像

Nginx 使用 mirror 模块实现流量镜像，核心是通过 location 块定义要镜像的请求路径，并在其中启用 mirror 指令将请求副本转发到镜像后端。注意：mirror 是 Nginx 1.13.4+ 内置模块，无需额外编译，但需确认版本支持。

配置 mirror 的基本 location 结构

镜像行为必须在 location 上下文中启用，且 mirror 指令本身不改变主请求流向——它只异步发送一个副本。主请求仍按原有 proxy_pass 或本地处理逻辑执行。

使用 mirror /mirror-uri 指定镜像子请求的内部路径（不是完整 URL）
对应需声明一个同名 location /mirror-uri，并在其中用 proxy_pass 转发到镜像服务（如测试环境或分析系统）
镜像子请求默认复用主请求的方法、URI、头和正文；可通过 mirror_request_body off 关闭请求体镜像（节省带宽）

一个典型镜像配置示例

假设要把所有 /api/ 下的 POST 请求镜像到 http://mirror-backend:8080：

location /api/ {
    # 主请求照常代理到生产后端
    proxy_pass http://prod-backend;
<pre class="brush:php;toolbar:false;"># 启动镜像：触发内部子请求 /mirror-api
mirror /mirror-api;
mirror_request_body on;  # 默认即为 on，显式写出更清晰

}

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

定义镜像子请求的处理 location

location = /mirror-api { internal; # 强制仅限内部调用，禁止外部直接访问 proxy_pass https://www.php.cn/link/3d23d15e2e861d31a4f265dc815a6047; proxy_set_header X-Original-Method $request_method; proxy_set_header X-Original-Uri $request_uri; }

注意：internal 是关键，防止恶意请求直接打到 /mirror-api；$request_uri 保证镜像请求携带原始查询参数和路径。

进阶控制：按条件镜像指定请求

可结合 if 或 map 变量实现精细化控制，例如只镜像 POST 且含特定 header 的请求：

用 map 提前定义镜像开关变量（推荐，避免 if 性能问题）
例如：map $request_method:$http_x_mirror_enabled $do_mirror { ~^POST:1 1; default 0; }
在 location 中写：mirror /mirror-api if=$do_mirror;
镜像子请求中可通过 proxy_set_header 添加标记头，方便镜像服务识别