AutoIndex#

Atende requisições terminadas com uma barra (/) e produz uma listagem de diretório. Geralmente, uma requisição é passada para o módulo AutoIndex quando o módulo Index não consegue encontrar um arquivo de índice.

Exemplo de Configuração#

location / {
    autoindex on;
}

Diretivas#

autoindex#

Sintaxe	`autoindex` `on` \| `off`;
Padrão	`autoindex off;`
Contexto	http, server, location

Habilita ou desabilita a saída de listagem de diretório.

autoindex_exact_size#

Sintaxe	`autoindex_exact_size` `on` \| `off`;
Padrão	`autoindex_exact_size on;`
Contexto	http, server, location

Para o formato HTML, especifica se os tamanhos exatos dos arquivos devem ser exibidos na listagem do diretório, ou se devem ser arredondados para kilobytes, megabytes e gigabytes.

autoindex_format#

Sintaxe	`autoindex_format` `html` \| `xml` \| `json` \| `jsonp`;
Padrão	`autoindex_format html;`
Contexto	http, server, location

Define o formato de uma listagem de diretório.

Quando o formato JSONP é usado, o nome de uma função de callback é definido com o argumento de requisição callback. Se o argumento estiver ausente ou tiver um valor vazio, então o formato JSON é usado.

A saída XML pode ser transformada usando o módulo XSLT.

Formatos de Saída

Os campos de objeto nas respostas contêm os seguintes dados:

Campo	Descrição
`name`	Nome do arquivo ou diretório
`type`	Tipo do objeto: `file` ou `directory`
`size`	Tamanho do objeto de acordo com autoindex_exact_size; para diretórios — `0`
`mtime`	Horário da última modificação no formato 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#

Sintaxe	`autoindex_localtime` `on` \| `off`;
Padrão	`autoindex_localtime off;`
Contexto	http, server, location

Para o formato HTML, especifica se os horários na listagem do diretório devem ser exibidos no fuso horário local ou UTC.