fancyindex
Директива `fancyindex` включает расширенные списки каталогов с настраиваемой эстетикой в NGINX.
Описание
Модуль fancyindex позволяет создавать визуально привлекательные списки файлов в NGINX, похожие на встроенный модуль autoindex, но с дополнительными возможностями настройки. При включении он заменяет стандартные списки каталогов структурированным HTML-табличным форматом, обеспечивая более организованное и удобное для пользователя отображение содержимого каталогов. Модуль также позволяет добавлять настраиваемые заголовки и футеры для каждого сгенерированного списка каталогов; они могут быть указаны как в виде локальных файлов, так и в виде удалённых ресурсов (если это разрешено). Если ни заголовок, ни футер не предоставлены, модуль генерирует их по умолчанию. Эта возможность особенно полезна для создания визуально согласованных и брендированных списков каталогов.
Кроме эстетики, модуль fancyindex повышает удобство использования, позволяя сортировать содержимое каталога по имени файла, времени изменения или размеру файла, а также задавать порядок сортировки — по возрастанию или по убыванию. Такой уровень настройки и удобства делает его идеальным выбором для пользователей, желающих адаптировать списки каталогов для улучшения пользовательского опыта при навигации по файловой структуре на сервере NGINX.
Важно отметить, что хотя fancyindex улучшает отображение списков каталогов, он базируется на существующих механизмах модуля autoindex, наследуя его возможности и добавляя более продвинутые опции настройки. Для эффективного использования этого модуля пользователь должен убедиться, что NGINX скомпилирован с ngx_http_addition_module, особенно при использовании настраиваемых заголовков и футеров.
Пример конфига
location /downloads {
fancyindex on;
fancyindex_header /path/to/custom/header.html;
fancyindex_footer /path/to/custom/footer.html;
};Убедитесь, что сервер NGINX имеет права на чтение указанных файлов заголовков и нижних колонтитул.
Не забудьте валидировать HTML, если вы используете пользовательские заголовки и нижние колонтитулы, чтобы избежать проблем с отображением.
Если вы используете внешние ресурсы (для заголовков/нижних колонтитулов), убедитесь, что они доступны с сервера NGINX.