fancyindex_header
`fancyindex_header` 指令允许自定义由 NGINX Fancy Index 模块生成的目录列表的头部。
NGINX Fancy Index module
·
httpserverlocation
语法fancyindex_header string | file;
默认值none
上下文http, server, location
参数1-2
说明
fancyindex_header 指令用于在使用 NGINX Fancy Index 模块时自定义目录列表的外观。默认情况下，与 NGINX 的内置 autoindex 功能相比，该模块为目录内容提供了更美观的显示。通过 fancyindex_header 指令，用户可以直接以字符串值指定自定义头部，或通过引用包含头部内容的本地文件路径来指定，从而在目录页面的展示上提供更大的灵活性。
该指令可以接受一到两个参数。第一个参数是必需的，用于指定头部内容；可选的第二个参数允许采用另一种包含头部的方法，例如指向某个特定文件。当未提供自定义头部时，模块会为生成的索引页面生成默认头部，确保在显示目录列表时始终有可见的头部。作为更广泛自定义框架的一部分，该指令可通过允许对目录列表的外观和感觉进行更多控制来显著提升用户体验。
配置示例
location /files {
fancyindex on;
fancyindex_header 'Welcome to the Files Directory
';
fancyindex_footer '/path/to/footer.html';
}⚠
请确保为头部指定的文件对 NGINX 进程可访问；否则可能会发生错误。
⚠
不支持为头部使用远程文件；路径必须是本地。请确保提供正确的文件路径。