> For the complete documentation index, see [llms.txt](https://docshome.gitbook.io/nginx-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/http/ngx_http_random_index_module.md).

# ngx\_http\_random\_index\_module

`ngx_http_random_index_module` 模块处理以 `/` 结尾的请求，然后随机选择目录中的一个文件作为索引文件展示，该模块优先于 [ngx\_http\_index\_module](/nginx-docs/he-xin-gong-neng/http/ngx_http_index_module.md) 之前处理。

该模块默认不会被构建到 nginx 中，需要在编译时加入 `--with-http_random_index_module` 配置参数启用。

## 配置示例

```
location / {
    random_index on;
}
```

### random\_index

| -       | 说明                               |
| ------- | -------------------------------- |
| **语法**  | **random\_index** `on` \| `off`; |
| **默认**  | random\_index off;               |
| **上下文** | location                         |

启用或禁用 `location` 周边的模块处理。

## 原文档

* <http://nginx.org/en/docs/http/ngx_http_random_index_module.html>