Cómo habilitar y configurar mod_autoindex en Apache para listar directorios
El módulo mod_autoindex en Apache permite generar automáticamente un listado de los archivos contenidos en un directorio cuando no existe un archivo de índice predeterminado (como index.html). Esto es útil para permitir que los usuarios naveguen por el contenido de directorios específicos del servidor.
¿Qué es mod_autoindex?
mod_autoindex es un módulo de Apache que proporciona la funcionalidad de creación automática de índices de directorios. Cuando un usuario solicita un directorio en el cual no hay un archivo de índice configurado, mod_autoindex genera una lista de los archivos y subdirectorios que contiene. Además, este módulo permite personalizar el estilo y la información que se muestra en los listados de directorios.
Instalación y activación de mod_autoindex en Apache
El módulo mod_autoindex suele venir incluido con Apache, pero puede ser necesario activarlo en algunas configuraciones.
1. Verificar si mod_autoindex está activado:
apachectl -M | grep autoindex
Si autoindex_module no aparece en la lista, debes activarlo.
2. Activar mod_autoindex:
sudo a2enmod autoindex3. Reiniciar Apache para aplicar los cambios:
sudo systemctl restart apache2Configuración de mod_autoindex
Para permitir la generación de listados de directorios, es necesario habilitar la opción Indexes en la configuración de Apache, lo cual puede hacerse en el archivo de configuración del sitio web (/etc/apache2/sites-available/000-default.conf) o en un archivo .htaccess.
Habilitar listados de directorios en un directorio específico
Edita el archivo de configuración del sitio y añade Options +Indexes en el bloque del directorio correspondiente:
<Directory "/var/www/html">
AllowOverride None
Options +Indexes
</Directory>Personalizar la apariencia de los listados de directorios
Puedes personalizar la información que mod_autoindex muestra en los listados de directorios utilizando varias directivas.
Ejemplo de configuración de mod_autoindex
<Directory "/var/www/html">
Options +Indexes
IndexOptions FancyIndexing HTMLTable NameWidth=*
IndexIgnore *.txt *.md
HeaderName HEADER.html
ReadmeName README.html
</Directory>-
IndexOptions FancyIndexing HTMLTable NameWidth=habilita una presentación con tablas HTML, mostrando nombres completos de archivos. -
IndexIgnore .txt .mdoculta archivos con extensiones específicas. -
HeaderName HEADER.htmlyReadmeName README.htmlañaden un archivo de encabezado y un archivo de pie de página, respectivamente, al listado del directorio.
Ejemplo de personalización de listado de directorios
1. Archivo HEADER.html:
Este archivo se muestra como encabezado en el listado.
<h1>Listado de Archivos</h1>2. Archivo README.html:
Este archivo se muestra como pie de página en el listado.
<p>Todos los archivos son propiedad de la empresa.</p>
Estos archivos deben estar ubicados en el directorio correspondiente (/var/www/html en este ejemplo) para que Apache los incluya en el listado.
Referencias adicionales
Para obtener más detalles sobre las opciones de configuración y personalización de mod_autoindex, consulta la documentación oficial de Apache sobre mod_autoindex.
Jorge García
Fullstack developer