index
'index' 指令定义在请求目录时要提供的默认文件。 — NGINX HTTP Core
index
httpserverlocation
语法index file1 [file2 ...];
默认值index.html index.htm
上下文http, server, location
模块NGINX HTTP Core
参数1+
说明
'index' 指令在 NGINX 中指定当用户请求目录时应返回的默认文件。该指令在以下情况下特别有用:当目录中不包含用户指定的 index 文件,或用户直接请求目录路径时。服务器会按列出的顺序查找指定的 index 文件,直到找到其中一个,或所有选项都被耗尽。这允许根据应用需求自定义默认行为。\n\n可以通过空格分隔来指定多个 index 文件,NGINX 会按给定顺序检查每个文件是否存在。如果没有找到任何指定的文件,NGINX 将根据配置设置返回 403 Forbidden 或 404 Not Found 错误。这种灵活性使得 'index' 指令成为 NGINX 无缝提供动态 Web 应用程序和静态内容能力的关键部分。
配置示例
location / {
index index.php index.html index.htm;
}⚠
确保指定的文件确实存在,否则在访问该目录时可能会发生错误。
⚠
请记住,如果未找到索引文件且已启用,可能会显示目录列表;请确认这是期望的行为。
⚠
当使用多个索引文件时,除非带引号,否则它们不应包含空格,因为空格是分隔符。