Nginx 全局 index 指令与虚拟主机内 index 指令的覆盖规则是什么

Nginx的index指令遵循就近覆盖原则，仅由最匹配的location块中最近定义的生效，不继承不叠加；只对以斜杠结尾的请求起作用，且需配合root/alias和真实目录存在才触发文件查找。

Nginx 的 index 指令不继承、不叠加，生效与否只看最匹配的 location 块中最近定义的那个。全局（http 块）和虚拟主机（server 块）里的 index 只是备选，一旦某个 location 显式写了 index，它就完全接管该路径下的索引行为。

server 块中的 index 会覆盖 http 块中的全局设置

只要在某个 server 块里写了 index，它就只对该站点生效，且优先级高于 http 块里的同名指令。比如：

http {index index.htm;# 全局默认，仅当所有 server 都没设时才可能起效}server {server_name example.com;root /var/www/site;index index.html;# 这个生效，覆盖 http 块的 index.htm}

location 块中的 index 会覆盖 server 块中的设置

哪怕 server 里已定义 index index.html，只要某个 location 内写了 index admin.php，那么访问该路径（如 /admin/）时，只查 admin.php，完全忽略 server 级的配置：

server {index index.html;location /admin/ {index admin.php;# 生效：访问 /admin/ 时只找 admin.php}location /blog/ {# 没写 index → 回退使用 server 级的 index.html}}

未定义 index 的 location 不会自动继承父级值

index 属于 Normal 类型指令，支持继承，但前提是子块没声明。如果 location 里没写 index，Nginx 就用上一级（server）的；如果 server 也没写，才用 http 级的。但一旦写了，就是彻底替换，不是追加或合并。

1. ✅ location /api/ { } → 无 index → 使用 server 中的 index
2. ❌ location /static/ { index ""; } → 显式禁用，默认页功能关闭
3. ⚠️ location ~ .php$ { index index.php; } → 正则 location 也生效，且优先级高于前缀匹配

生效前提：请求 URI 必须以斜杠结尾

无论哪一级的 index，都只对 /、/about/ 这类目录式请求起作用。访问 /about（无尾斜杠）不会触发任何 index 查找——这点常被误认为“配置没生效”，实际是请求方式不匹配。

要统一处理裸路径，得靠 try_files：

location / {index index.html;try_files $uri $uri/ /index.html;}

这样 / 和 / 以外的路径（如域名根）也能正确加载首页。