fancyindex: Модуль NGINX Fancy Index

Установка

Вы можете установить этот модуль в любой дистрибутив на базе RHEL, включая, но не ограничиваясь:

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

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

Включите модуль, добавив следующее в начало файла /etc/nginx/nginx.conf:

load_module modules/ngx_http_fancyindex_module.so;

Этот документ описывает nginx-module-fancyindex v0.6.1, выпущенный 1 марта 2026 года.

Модуль Nginx Fancy Index

Модуль Fancy Index позволяет генерировать списки файлов, как это делает встроенный модуль autoindex, но с добавлением стиля. Это возможно, потому что модуль позволяет определенную степень настройки сгенерированного контента:

Пользовательские заголовки, как локальные, так и хранящиеся удаленно.
Пользовательские подвал, как локальные, так и хранящиеся удаленно.
Добавьте свои собственные правила стилей CSS.
Позволяет выбирать сортировку элементов по имени (по умолчанию), времени изменения или размеру; как по возрастанию (по умолчанию), так и по убыванию.

Этот модуль предназначен для работы с Nginx, высокопроизводительным веб-сервером с открытым исходным кодом, написанным Игорем Сысоевым.

Требования

CentOS, RHEL, Fedora Linux

Для пользователей официального стабильного репозитория Nginx доступен репозиторий дополнительных пакетов с динамическими модулями, в который включен fancyindex.

Установите конфигурацию репозитория, затем пакет модуля:

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

Затем загрузите модуль в /etc/nginx/nginx.conf, используя:

load_module "modules/ngx_http_fancyindex_module.so";

macOS

Пользователи могут установить Nginx на macOS с помощью MacPorts; fancyindex включен:

sudo port install nginx

Другие платформы

В большинстве других случаев вам понадобятся исходные коды для Nginx. Любая версия, начиная с 0.8, должна работать.

Чтобы использовать директивы fancyindex_header_ и fancyindex_footer_, вам также понадобится встроенный в Nginx ngx_http_addition_module.

Сборка

Распакуйте исходные коды Nginx:
```
$ gunzip -c nginx-?.?.?.tar.gz | tar -xvf -
```
Распакуйте исходные коды для модуля fancy indexing:
```
$ gunzip -c nginx-fancyindex-?.?.?.tar.gz | tar -xvf -
```
Перейдите в директорию, содержащую исходные коды Nginx, запустите скрипт конфигурации с желаемыми параметрами и обязательно добавьте флаг --add-module, указывающий на директорию, содержащую исходный код модуля fancy indexing:
```
$ cd nginx-?.?.?
$ ./configure --add-module=../nginx-fancyindex-?.?.? \
   [--with-http_addition_module] [дополнительные желаемые параметры]
```
Начиная с версии 0.4.0, модуль также может быть собран как динамический модуль, используя --add-dynamic-module=… вместо этого и load_module "modules/ngx_http_fancyindex_module.so"; в конфигурационном файле.
Соберите и установите программное обеспечение:
```
$ make
```
А затем, как root:
```
# make install
```
Настройте Nginx, используя директивы конфигурации модулей.

Пример

Вы можете протестировать встроенный стиль по умолчанию, добавив следующие строки в секцию server вашего конфигурационного файла Nginx:

location / {
  fancyindex on;              # Включить fancy индексы.
  fancyindex_exact_size off;  # Выводить размеры файлов в удобочитаемом формате.
}

Темы

Следующие темы демонстрируют уровень настройки, который можно достичь с помощью модуля:

Тема от @TheInsomniac. Использует пользовательский заголовок и подвал.
Тема от @Naereen. Использует пользовательский заголовок и подвал. Заголовок включает поле поиска для фильтрации по имени файла с использованием JavaScript.
Тема от @fraoustin. Адаптивная тема с использованием элементов Material Design.
Тема от @alehaa. Простая, плоская тема на основе Bootstrap 4 и FontAwesome.