nginx需三步启用random_index模块：确认编译时已加入--with-http_random_index_module、目录下存在至少两个同级普通html文件、在location块中配置random_index on且使用root而非alias。
要让 Nginx 支持并正确使用 random_index 模块实现随机主页效果，需完成三步：确认模块已编译启用、设置正确的静态文件目录结构、在 location 中精准开启该功能。它不是插件式开关，而是编译期特性 + 运行时配置的组合。
确认 random_index 模块是否可用
该模块名为 ngx_http_random_index_module，Nginx 官方提供，但**默认不保证启用**。需验证是否已编译进当前 Nginx：
- 运行
nginx -V 2>&1 | grep -o with-http_random_index_module - 若有输出，说明已启用；若无，需重新编译 Nginx 并添加
--with-http_random_index_module参数 - 注意：无需安装额外包或加载动态模块，它不支持 run-time 动态加载
准备候选首页文件目录
模块只对以 / 结尾的请求生效（如访问 / 或 /landing/），且仅从指定目录中随机选取**同级普通文件**：
- 目录下不能只有子目录，必须有至少两个 HTML、HTML-like 文件（如
index-v1.html、promo-a.html、test.htm） - 以点开头的文件（如
.gitignore、.env）自动被忽略 - 不支持子目录内文件参与随机，也不识别后缀优先级——所有匹配文件概率均等
- 建议统一命名便于维护，例如：
tmpl-blue.html、tmpl-green.html、tmpl-2026.html
在 location 中启用并配置
模块指令 random_index on; 只能出现在 location 块内，且优先级高于 index 指令：
- 典型配置示例：
location / {<br> root /usr/share/<a style="color:#f60; text-decoration:underline;" title="nginx" href="https://m.php.cn/zt/16000.html" target="_blank">nginx</a>/html/landing;<br> random_index on;<br> index index.html; # 仅当 random_index 失效（如目录为空）时才用到<br>}
-
root必须指向真实存在的本地路径，且该路径对 Nginx worker 进程可读 - 若同时配置了
alias，注意alias不支持random_index—— 必须用root - 该配置仅对 URI 为
/的请求生效；若想对/home/生效，应写location /home/ { ... }，且 root 对应目录需含文件
常见问题与避坑提示
实际部署中容易卡在这几个地方：
- 访问
/却始终返回同一个页面？检查目录权限、文件是否真在root指向路径下，以及是否误用了alias - 返回 403？多半是目录无读取权限，或 SELinux/AppArmor 限制，非模块本身问题
- 想按用户/IP 固定版本？
random_index本身不支持——需结合map+try_files或 Lua 实现灰度逻辑，它只负责“纯随机” - 刷新没变化？确认浏览器没缓存响应，可加
add_header Cache-Control "no-store, no-cache";临时调试
