AutoIndex#

Обслуживает запросы, оканчивающиеся косой чертой (/), и выдает листинг каталога. Обычно запрос попадает к модулю AutoIndex, когда модуль Index не нашел индексный файл.

Пример конфигурации#

location / {
    autoindex on;
}

Директивы#

autoindex#

Синтаксис	`autoindex` `on` \| `off`;
По умолчанию	`autoindex off;`
Контекст	http, server, location

Разрешает или запрещает вывод листинга каталога.

autoindex_exact_size#

Синтаксис	`autoindex_exact_size` `on` \| `off`;
По умолчанию	`autoindex_exact_size on;`
Контекст	http, server, location

Для формата HTML определяет, как выводить размеры файлов в листинге каталога: точно или округляя до килобайт, мегабайт и гигабайт.

autoindex_format#

Синтаксис	`autoindex_format` `html` \| `xml` \| `json` \| `jsonp`;
По умолчанию	`autoindex_format html;`
Контекст	http, server, location

Задает формат вывода листинга каталога.

При использовании формата JSONP имя callback-функции задается в аргументе запроса callback. Если аргумент отсутствует или имеет пустое значение, то используется формат JSON.

Вывод в формате XML может быть преобразован при помощи модуля XSLT.

Форматы вывода

Поля объекта в ответах содержат следующие данные:

Поле	Описание
`name`	Имя файла или каталога
`type`	Тип объекта: `file` или `directory`
`size`	Размер объекта согласно autoindex_exact_size; для каталогов — `0`
`mtime`	Время последнего изменения в формате Unix time

<html>
<head>
    <title>Index of /files/</title>
</head>
<body>
    <h1>Index of /files/</h1>
    <hr>
    <pre>
            <a href="../">../</a>
            <a href="example.txt">example.txt</a>               12-Jun-2025 14:21    1234
            <a href="image.png">image.png</a>                   12-Jun-2025 14:21    4321
            </pre>
    <hr>
</body>
</html>

<?xml version="1.0" encoding="UTF-8"?>
<listing>
<file>
    <name>example.txt</name>
    <type>file</type>
    <size>1234</size>
    <mtime>2025-06-12T14:21:00Z</mtime>
</file>
<file>
    <name>image.png</name>
    <type>file</type>
    <size>4321</size>
    <mtime>2025-06-12T14:21:00Z</mtime>
</file>
</listing>

[
{
    "name": "example.txt",
    "type": "file",
    "size": 1234,
    "mtime": "2025-06-12T14:21:00Z"
},
{
    "name": "image.png",
    "type": "file",
    "size": 4321,
    "mtime": "2025-06-12T14:21:00Z"
}
]

callback([
{
    "name": "example.txt",
    "type": "file",
    "size": 1234,
    "mtime": "2025-06-12T14:21:00Z"
},
{
    "name": "image.png",
    "type": "file",
    "size": 4321,
    "mtime": "2025-06-12T14:21:00Z"
}
]);

autoindex_localtime#

Синтаксис	`autoindex_localtime` `on` \| `off`;
По умолчанию	`autoindex_localtime off;`
Контекст	http, server, location

Для формата HTML определяет, в какой временной зоне выводить время в листинге каталога: в локальной или в UTC.