ngx_http_random_index_module 不支持灰度随机测试，仅能无状态、无权重地随机选取目录下的index文件，不感知请求头、Cookie、参数等灰度依据，无法实现基于用户或上下文的可控分流。
ngx_http_random_index_module 本身并不支持灰度随机测试，它仅用于在目录中**随机选取一个 index 文件**（如 index.html、home.html）并返回，且不带任何权重、规则或请求上下文判断能力。因此，**不能直接用它实现基于用户、Header、参数等条件的灰度分流**。
为什么 random_index_module 不适合灰度测试
该模块设计目标非常单一：
- 只在 本地文件系统指定目录 下扫描以 index 开头的文件（可通过 random_index 指令启用）；
- 每次请求时从匹配文件中无状态、无权重、完全随机选一个返回；
- 不感知 HTTP 请求头、Cookie、URL 参数、IP 地址等灰度依据；
- 无法与 upstream、service 发现或动态配置联动，纯静态文件路由。
真正可行的网关层灰度方案（Nginx 原生支持）
若需在 Nginx 网关层实现多套静态模板（如 v1/index.html、v2/index.html）的可控灰度，推荐以下组合方式：
-
用 map + cookie 或 header 提取灰度标识：例如根据
$http_x_gray_tag或$cookie_gray_version映射到变量$template_version； -
用 try_files 实现模板路径路由：根据变量拼接路径，按优先级 fallback，例如：
try_files /templates/$template_version/index.html /templates/default/index.html =404; -
配合 rewrite 或 location 分离静态资源域：避免污染主逻辑，例如将所有模板放在
/static/下，并用独立 location 处理； -
（进阶）结合 Lua 或 OpenResty 实现动态权重抽样：如 5% 流量打到 v2，需用
resty.random生成随机数比对阈值，再 set $template_version。
一个轻量灰度示例（纯 Nginx 配置）
假设你有两套模板：/usr/share/nginx/html/templates/v1/index.html/usr/share/nginx/html/templates/v2/index.html
在 server 块中添加：
map $cookie_gray_version $chosen_template {
"v2" "v2";
default "v1";
}
<p>location / {
root /usr/share/nginx/html;
try_files /templates/$chosen_template/index.html =404;
}</p>这样，当用户携带 Cookie: gray_version=v2 时，就会命中 v2 模板；否则默认 v1。可进一步用 Header、IP Hash、甚至 $request_id 的哈希值做一致性灰度。
如果坚持“随机”且要简单上线
可退化为“伪随机灰度”：
- 用 Lua 计算 md5($remote_addr & $time_iso8601) 取模，按余数决定模板版本；
- 或用 split_clients 指令（Nginx 商业版/Plus 支持，开源版不可用），但社区版可通过第三方模块 nginx-http-split-clients-module 编译启用；
- 注意：纯 random_index 是“每次请求都可能变”，对用户不一致，不适合真实灰度验证场景。
