http_random_index module

http_random_index module#

The module processes requests ending with the slash character (/) and picks a random file in a directory to serve as an index file. The module is processed before the http_index module.

When building from the source code, this module isn’t built by default; it should be enabled with the ‑‑with‑http_random_index_module build option.

In packages and images from our repos, the module is included in the build.

Example Configuration#

location / {
    random_index on;
}

Directives#

random_index#

Syntax:

random_index on | off.;

Default:

random_index off;

Context:

location

Enables or disables module processing in a surrounding location.