# AutoIndex
Atiende solicitudes que terminan con una barra diagonal (`/`) y produce un listado de directorios. Normalmente, una solicitud se pasa al módulo `AutoIndex` cuando el módulo [Index](https://es.angie.software//angie/docs/configuration/modules/http/http_index.md#http-index) no puede encontrar un archivo índice.
## Ejemplo de configuración
```nginx
location / {
autoindex on;
}
```
## Directivas
### autoindex
| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `autoindex` `on` | `off`; |
|--------------------------------------------------------------------------------------------|-----------------------------|
| Predeterminado | `autoindex off;` |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location |
Habilita o deshabilita la salida del listado de directorios.
### autoindex_exact_size
| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `autoindex_exact_size` `on` | `off`; |
|--------------------------------------------------------------------------------------------|----------------------------------------|
| Predeterminado | `autoindex_exact_size on;` |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location |
Para el [formato](#autoindex-format) HTML, especifica si se deben mostrar los tamaños exactos de los archivos en el listado de directorios, o si se deben redondear a kilobytes, megabytes y gigabytes.
### autoindex_format
| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `autoindex_format` `html` | `xml` | `json` | `jsonp`; |
|--------------------------------------------------------------------------------------------|---------------------------------------------------------|
| Predeterminado | `autoindex_format html;` |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location |
Establece el formato del listado de directorios.
Cuando se utiliza el formato JSONP, el nombre de la función de callback se establece con el argumento de solicitud `callback`. Si el argumento falta o tiene un valor vacío, se utiliza el formato JSON.
La salida XML puede transformarse utilizando el módulo [XSLT](https://es.angie.software//angie/docs/configuration/modules/http/http_xslt.md#http-xslt).
### Formatos de salida
Los campos de objeto en las respuestas contienen los siguientes datos:
| Campo | Descripción |
|---------|---------------------------------------------------------------------------------------------------|
| `name` | Nombre del archivo o directorio |
| `type` | Tipo de objeto: `file` o `directory` |
| `size` | Tamaño del objeto según [autoindex_exact_size](#autoindex-exact-size);
para directorios — `0` |
| `mtime` | Hora de última modificación en formato de tiempo Unix |
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
| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `autoindex_localtime` `on` | `off`; |
|--------------------------------------------------------------------------------------------|---------------------------------------|
| Predeterminado | `autoindex_localtime off;` |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location |
Para el [formato](#autoindex-format) HTML, especifica si las horas en el listado de directorios deben mostrarse en la zona horaria local o en UTC.
