fancyindex_show_dotfiles

`fancyindex_show_dotfiles` 指令控制 NGINX 中 Fancy Index 模块生成的目录列表中点文件的可见性。

语法fancyindex_show_dotfiles on | off;
默认值off
上下文http, server, location
参数flag

说明

fancyindex_show_dotfiles 指令在 NGINX Fancy Index 模块中允许用户指定是否在生成的目录列表中显示点文件(以点开头的文件和目录)。默认情况下,点文件被隐藏,这也是大多数 Web 服务器的标准行为。当启用此指令时,它会修改 Fancy Index 模块的列表行为以包含这些文件和目录。

该指令可以在多个上下文中应用:httpserverlocation,使得可以在 NGINX 配置的不同部分灵活地配置目录列表。将该指令设置为 on 将在目录列表中显示点文件,这可能会暴露配置文件或其他敏感项,如果未授权用户访问可能构成安全风险。因此,在公共服务器上应谨慎使用此指令。

该指令接受一个标志作为参数,其中 on 启用点文件显示,off 禁用(也是默认设置)。用户必须确保将该指令策略性地放置,以仅影响预期的目录列表而不降低安全性。

配置示例

location /downloads {
    fancyindex on;
    fancyindex_show_dotfiles on;
}

启用点文件可能会暴露像 .htaccess 这样的敏感文件,如果没有妥善保护。

确保对公开暴露的目录实施适当的访问控制。

检查显示点文件对系统安全最佳实践的影响。

← 返回所有指令