nginx的index指令必须显式配置在location块内才生效，用于指定目录访问时自动返回的默认文件；它不继承、不默认开启，需配合root或alias及正确路径、权限和文件存在性共同作用。
在 Nginx 的 location 块中配置 index 指令，是让访问目录路径（如 / 或 /admin/）时自动返回指定文件的关键操作。它不是“默认开启”的功能，必须显式声明才生效。
必须写在 location 块内部
index 指令只在 server 或 location 块中有效，且遵循就近优先原则。如果多个 location 匹配同一请求，Nginx 会使用最匹配的那个块里的 index 设置。
- 正确写法（在
location /中）：
location / {
root /var/www/myapp;
index index.html;
}
- 错误写法（写在
server块顶层但没配root，或漏掉location）：Nginx 不知道该去哪找index.html，请求/可能返回 403 或 404。
index 后面可以跟多个文件，按顺序查找
你不必只写一个文件。Nginx 会从左到右检查每个文件是否存在，遇到第一个存在的就直接返回。
- 常见组合：
index index.html index.htm; - 带 PHP 的静态+动态混合站点：
index index.html index.php; - 注意：如果
index.htm存在但内容已过期，Nginx 就不会继续找index.html—— 顺序很重要。
root 路径必须准确指向含 index 文件的目录
index 指令本身不指定文件位置，它只告诉 Nginx “要找什么名字”，真正拼出物理路径靠的是 root（或 alias）指令。
- 假设你的
index.html在/var/www/myapp/index.html，那么root必须设为/var/www/myapp； - 若误写成
root /var/www，Nginx 实际尝试读取的是/var/www/index.html—— 文件不存在，报 404； - 若用
alias，要注意它会完全替换匹配路径，比如location /static { alias /data/assets; }，则请求/static/会查找/data/assets/index.html。
验证是否生效的小技巧
别光靠浏览器刷新判断，用命令快速定位问题：
- 用
curl -I http://localhost/查看响应头，确认是否返回200 OK和Content-Type: text/html； - 打开 Nginx 错误日志：
tail -f /var/log/nginx/error.log，里面会明确写出“open() "/xxx/index.html" failed (2: No such file)”之类的信息； - 检查文件权限：
ls -l /var/www/myapp/index.html，确保 Nginx 工作进程用户（如www-data或nginx）有读取权限。
