fancyindex_show_dotfiles

Директива `fancyindex_show_dotfiles` контролирует видимость скрытых файлов (dotfiles) в списках каталогов, сгенерированных модулем Fancy Index в NGINX.

Синтаксисfancyindex_show_dotfiles on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументыflag

Описание

Директива fancyindex_show_dotfiles в модуле Fancy Index для NGINX позволяет пользователям указать, должны ли dotfiles (файлы и каталоги, начинающиеся с точки) отображаться в сгенерированных списках каталогов. По умолчанию dotfiles скрыты, что является стандартным поведением большинства веб-серверов. Когда эта директива включена, она изменяет поведение формирования списка модуля Fancy Index, чтобы включать эти файлы и каталоги.

Эту директиву можно применять в разных контекстах: http, server и location, что даёт гибкость в настройке отображения списков каталогов в разных частях конфигурации NGINX. Установка директивы в значение 'on' покажет dotfiles в списке каталогов, что может привести к раскрытию файлов конфигурации или других чувствительных элементов, представляющих риск безопасности при доступе неавторизованных пользователей. Поэтому важно использовать эту директиву с осторожностью, особенно на публичных серверах.

Директива принимает флаг в качестве аргумента, где on включает отображение dotfiles, а off отключает его (что также является настройкой по умолчанию). Пользователям следует убедиться, что директива размещена таким образом, чтобы влиять только на нужные списки каталогов и не подвергать систему риску.

Пример конфига

location /downloads {
    fancyindex on;
    fancyindex_show_dotfiles on;
}

Включение dotfiles может привести к раскрытию конфиденциальных файлов, таких как .htaccess, если они не будут должным образом защищены.

Убедитесь, что для публично доступных директорий настроены надлежащие механизмы контроля доступа.

Проверьте последствия отображения dotfiles в контексте лучших практик системной безопасности.

← Ко всем директивам