# AutoIndex
Обслуживает запросы, оканчивающиеся косой чертой (`/`), и выдает листинг каталога. Обычно запрос попадает к модулю `AutoIndex`, когда модуль [Index](https://angie.software//adc/docs/configuration_lb/reference/http/http_index.md#adc-http-index) не нашел индексный файл.
## Пример конфигурации
```nginx
location / {
autoindex on;
}
```
## Директивы
### autoindex
| [Синтаксис](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | `autoindex` `on` | `off`; |
|---------------------------------------------------------------------------------------------------------|-----------------------------|
| По умолчанию | `autoindex off;` |
| [Контекст](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | http, server, location |
Разрешает или запрещает вывод листинга каталога.
### autoindex_exact_size
| [Синтаксис](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | `autoindex_exact_size` `on` | `off`; |
|---------------------------------------------------------------------------------------------------------|----------------------------------------|
| По умолчанию | `autoindex_exact_size on;` |
| [Контекст](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | http, server, location |
Для [формата](#adc-autoindex-format) HTML определяет, как выводить размеры файлов в листинге каталога: точно или округляя до килобайт, мегабайт и гигабайт.
### autoindex_format
| [Синтаксис](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | `autoindex_format` `html` | `xml` | `json` | `jsonp`; |
|---------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
| По умолчанию | `autoindex_format html;` |
| [Контекст](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | http, server, location |
Задает формат вывода листинга каталога.
При использовании формата JSONP имя callback-функции задается в аргументе запроса `callback`. Если аргумент отсутствует или имеет пустое значение, то используется формат JSON.
Вывод в формате XML может быть преобразован при помощи модуля XSLT.
### Форматы вывода
Поля объекта в ответах содержат следующие данные:
| Поле | Описание |
|---------|----------------------------------------------------------------------------------------------------|
| `name` | Имя файла или каталога |
| `type` | Тип объекта: `file` или `directory` |
| `size` | Размер объекта согласно [autoindex_exact_size](#adc-autoindex-exact-size);
для каталогов — `0` |
| `mtime` | Время последнего изменения в формате Unix time |
HTML
```html
Index of /files/
Index of /files/
../
example.txt 12-Jun-2025 14:21 1234
image.png 12-Jun-2025 14:21 4321
```
XML
```xml
example.txt
file
1234
2025-06-12T14:21:00Z
image.png
file
4321
2025-06-12T14:21:00Z
```
JSON
```json
[
{
"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"
}
]
```
JSONP
```javascript
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
| [Синтаксис](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | `autoindex_localtime` `on` | `off`; |
|---------------------------------------------------------------------------------------------------------|---------------------------------------|
| По умолчанию | `autoindex_localtime off;` |
| [Контекст](https://angie.software//adc/docs/configuration_lb/reference/configfile.md#adc-configfile) | http, server, location |
Для [формата](#adc-autoindex-format) HTML определяет, в какой временной зоне выводить время в листинге каталога: в локальной или в UTC.
