fancyindex: Módulo Fancy Index de NGINX

Instalación

Puedes instalar este módulo en cualquier distribución basada en RHEL, incluyendo, pero no limitado a:

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

CentOS/RHEL 8+, Fedora Linux, Amazon Linux 2023+CentOS/RHEL 7 y 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

Habilita el módulo añadiendo lo siguiente en la parte superior de /etc/nginx/nginx.conf:

load_module modules/ngx_http_fancyindex_module.so;

Este documento describe nginx-module-fancyindex v0.6.1 lanzado el 01 de marzo de 2026.

Módulo Fancy Index de Nginx

El módulo Fancy Index hace posible la generación de listados de archivos, como lo hace el módulo autoindex incorporado, pero añadiendo un toque de estilo. Esto es posible porque el módulo permite un cierto grado de personalización del contenido generado:

Encabezados personalizados, ya sean locales o almacenados de forma remota.
Pies de página personalizados, ya sean locales o almacenados de forma remota.
Añadir tus propias reglas de estilo CSS.
Permitir elegir ordenar los elementos por nombre (predeterminado), tiempo de modificación o tamaño; tanto en orden ascendente (predeterminado) como descendente.

Este módulo está diseñado para trabajar con Nginx, un servidor web de alto rendimiento de código abierto escrito por Igor Sysoev.

Requisitos

CentOS, RHEL, Fedora Linux

Para los usuarios del repositorio estable oficial de Nginx, está disponible un repositorio de paquetes extra con módulos dinámicos y fancyindex está incluido.

Instala la configuración del repositorio y luego el paquete del módulo:

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

Luego carga el módulo en /etc/nginx/nginx.conf usando:

load_module "modules/ngx_http_fancyindex_module.so";

macOS

Los usuarios pueden instalar Nginx en macOS con MacPorts; fancyindex está incluido:

sudo port install nginx

Otras plataformas

En la mayoría de los otros casos necesitarás las fuentes de Nginx. Cualquier versión a partir de la serie 0.8 debería funcionar.

Para utilizar las directivas fancyindex_header_ y fancyindex_footer_ también necesitarás el ngx_http_addition_module integrado en Nginx.

Construcción

Descomprime las fuentes de Nginx:

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

Descomprime las fuentes para el módulo de indexación fancy:
```
$ gunzip -c nginx-fancyindex-?.?.?.tar.gz | tar -xvf -
```
Cambia al directorio que contiene las fuentes de Nginx, ejecuta el script de configuración con las opciones deseadas y asegúrate de poner una bandera --add-module apuntando al directorio que contiene la fuente del módulo de indexación fancy:
```
$ cd nginx-?.?.?
$ ./configure --add-module=../nginx-fancyindex-?.?.? \
   [--with-http_addition_module] [opciones adicionales deseadas]
```
Desde la versión 0.4.0, el módulo también puede ser construido como un módulo dinámico, usando --add-dynamic-module=… en su lugar y load_module "modules/ngx_http_fancyindex_module.so"; en el archivo de configuración.
Construye e instala el software:
```
$ make
```
Y luego, como root:
```
# make install
```
Configura Nginx utilizando las directivas de configuración de los módulos.

Ejemplo

Puedes probar el estilo predeterminado incorporado añadiendo las siguientes líneas en una sección server en tu archivo de configuración de Nginx:

location / {
  fancyindex on;              # Habilitar índices fancy.
  fancyindex_exact_size off;  # Salida de tamaños de archivo legibles por humanos.
}

Temas

Los siguientes temas demuestran el nivel de personalización que se puede lograr utilizando el módulo:

Tema por @TheInsomniac. Usa encabezado y pie de página personalizados.
Tema por @Naereen. Usa encabezado y pie de página personalizados. El encabezado incluye un campo de búsqueda para filtrar por nombre de archivo usando JavaScript.
Tema por @fraoustin. Tema responsivo usando elementos de Material Design.
Tema por @alehaa. Tema simple y plano basado en Bootstrap 4 y FontAwesome.