fancyindex: Módulo Fancy Index do NGINX

Instalação

Você pode instalar este módulo em qualquer distribuição baseada em RHEL, incluindo, mas não se limitando a:

RedHat Enterprise Linux 7, 8, 9 e 10
CentOS 7, 8, 9
AlmaLinux 8, 9
Rocky Linux 8, 9
Amazon Linux 2 e Amazon Linux 2023

CentOS/RHEL 8+, Fedora Linux, Amazon Linux 2023+CentOS/RHEL 7 e Amazon Linux 2

dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-fancyindex

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-fancyindex

Ative o módulo adicionando o seguinte no topo de /etc/nginx/nginx.conf:

load_module modules/ngx_http_fancyindex_module.so;

Este documento descreve o nginx-module-fancyindex v0.6.1 lançado em 01 de março de 2026.

Módulo Fancy Index do NGINX

O módulo Fancy Index possibilita a geração de listagens de arquivos, como faz o módulo embutido autoindex, mas adicionando um toque de estilo. Isso é possível porque o módulo permite um certo grau de personalização do conteúdo gerado:

Cabeçalhos personalizados, locais ou armazenados remotamente.
Rodapés personalizados, locais ou armazenados remotamente.
Adicione suas próprias regras de estilo CSS.
Permite escolher ordenar os elementos por nome (padrão), tempo de modificação ou tamanho; tanto em ordem crescente (padrão) quanto decrescente.

Este módulo foi projetado para funcionar com Nginx, um servidor web de alto desempenho e código aberto escrito por Igor Sysoev.

Requisitos

CentOS, RHEL, Fedora Linux

Para usuários do repositório oficial estável do Nginx, o repositório de pacotes extras com módulos dinâmicos está disponível e o fancyindex está incluído.

Instale a configuração do repositório e, em seguida, o pacote do módulo:

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install nginx-module-fancyindex

Em seguida, carregue o módulo em /etc/nginx/nginx.conf usando:

load_module "modules/ngx_http_fancyindex_module.so";

macOS

Os usuários podem instalar o Nginx no macOS com MacPorts; o fancyindex está incluído:

sudo port install nginx

Outras plataformas

Na maioria dos outros casos, você precisará dos fontes do Nginx. Qualquer versão a partir da série 0.8 deve funcionar.

Para usar as diretivas fancyindex_header_ e fancyindex_footer_, você também precisará do ngx_http_addition_module embutido no Nginx.

Compilação

Descompacte os fontes do Nginx:

$ gunzip -c nginx-?.?.?.tar.gz | tar -xvf -

Descompacte os fontes do módulo de indexação fancy:

$ gunzip -c nginx-fancyindex-?.?.?.tar.gz | tar -xvf -

Mude para o diretório que contém os fontes do Nginx, execute o script de configuração com as opções desejadas e tenha certeza de colocar uma flag --add-module apontando para o diretório que contém os fontes do módulo de indexação fancy:
```
$ cd nginx-?.?.?
$ ./configure --add-module=../nginx-fancyindex-?.?.? \
   [--with-http_addition_module] [opções extras desejadas]
```
Desde a versão 0.4.0, o módulo também pode ser construído como um módulo dinâmico, usando --add-dynamic-module=… em vez de load_module "modules/ngx_http_fancyindex_module.so"; no arquivo de configuração.
Compile e instale o software:
```
$ make
```
E então, como root:
```
# make install
```
Configure o Nginx usando as diretivas de configuração dos módulos.

Exemplo

Você pode testar o estilo padrão embutido adicionando as seguintes linhas em uma seção server no seu arquivo de configuração do Nginx:

location / {
  fancyindex on;              # Ativa índices fancy.
  fancyindex_exact_size off;  # Saída de tamanhos de arquivos legíveis por humanos.
}

Temas

Os seguintes temas demonstram o nível de personalização que pode ser alcançado usando o módulo:

Tema por @TheInsomniac. Usa cabeçalho e rodapé personalizados.
Tema por @Naereen. Usa cabeçalho e rodapé personalizados. O cabeçalho inclui um campo de busca para filtrar por nome de arquivo usando JavaScript.
Tema por @fraoustin. Tema responsivo usando elementos do Material Design.
Tema por @alehaa. Tema simples e plano baseado no Bootstrap 4 e FontAwesome.