fancyindex
`fancyindex` 指令在 NGINX 中启用增强的目录列表显示,支持自定义外观。
NGINX Fancy Index module
·
httpserverlocation
语法fancyindex on | off;
默认值off
上下文http, server, location
参数flag
说明
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 服务器访问。