ngx_http_random_index_module不能用于灰度测试，因其仅在目录索引时随机选静态文件，不支持读取请求头/Cookie、动态修改proxy_pass、参与rewrite流程或变量决策；灰度需用map+upstream+proxy_pass变量组合实现。
ngx_http_random_index_module 本身不支持灰度测试，也不能用于网关层实现多套反代模板的动态路由。它仅在 location 中启用目录索引时，从指定目录下**随机选取一个文件作为默认索引页**（如 index.html、index.htm），与反向代理、上游选择、流量分发完全无关。
为什么不能用 random_index_module 做灰度？
该模块工作在内容服务阶段，作用域是静态文件目录索引，不具备以下能力：
- 无法读取请求头、Cookie、参数等灰度标识
- 无法修改
proxy_pass目标或 upstream 配置 - 不参与 proxy、rewrite、set 等指令执行流程
- 没有变量注入机制，不能配合 map 或 if 动态决策
真正适合网关层灰度的 Nginx 方案
要在 Nginx 网关层实现多套反代模板的灰度发布（例如 v1/v2 模板分别渲染不同 upstream 或添加不同 header），应组合使用以下核心模块：
- map 指令：根据 $http_cookie、$arg_version、$remote_addr 等提取灰度标签，映射为 upstream 名称或模板开关变量
- upstream + server：定义多组后端集群（如 backend_v1、backend_v2）
-
proxy_pass + 变量：用
proxy_pass http://$upstream_name实现动态转发 - （可选）lua-resty-balancer 或 OpenResty + lua：做更复杂的权重灰度、AB 测试逻辑
一个轻量灰度反代配置示例
假设按 Cookie 中 gray=on 切流量到 v2 模板：
map $http_cookie $target_upstream {
~*gray=on backend_v2;
default backend_v1;
}
<p>upstream backend_v1 {
server 10.0.1.10:8080;
}</p><p>upstream backend_v2 {
server 10.0.1.11:8080;
}</p><p>server {
location / {
proxy_pass <a href="https://www.php.cn/link/4ffb58faad74091abc129498ca03587c">https://www.php.cn/link/4ffb58faad74091abc129498ca03587c</a>;
proxy_set_header Host $host;</p><h1>可在此处根据 $target_upstream 注入不同 header 表示模板版本</h1><pre class="brush:php;toolbar:false;"> proxy_set_header X-Template-Version $target_upstream;
}}
进阶：模板级灰度（不止 upstream，还换 header/rewrite 规则）
若“多套反代模板”指整套行为差异（如 v1 加 /api/v1/ 前缀，v2 加 /api/v2/；或设置不同超时），可结合 if 或 map + 多个 location 块：
- 用 map 将灰度标识转为路径前缀变量（如 $api_prefix）
- 用 rewrite 配合变量重写 URI：
rewrite ^(.*)$ $api_prefix$1 break; - 用 proxy_set_header 设置差异化 header：
proxy_set_header X-Template $target_upstream;
不复杂但容易忽略：所有动态 proxy_pass 必须用变量引用已定义的 upstream 名，不能拼接 IP+端口字符串，否则会报错“invalid hostname”。
