Nginx 中 index 指令在 location 块内不能直接覆盖 server 级设置来单独指定默认首页，它仅在请求目录路径（如 /blog/）时生效，按顺序查找指定文件；真正可靠的做法是用 try_files 显式控制，如 try_files $uri $uri/ /blog/index.html =404。
在 Nginx 的 location 块中，index 指令不能直接“覆盖”全局或 server 级别的设置来单独为该 location 指定默认首页——它本身是**作用于匹配到的目录路径**，且只在请求以 / 结尾（即访问目录）时生效。但你可以通过合理组合 location、index 和 try_files 实现“为特定路径指定默认首页”的效果。
index 指令的实际行为
index 不是“重写 URL”或“跳转”，而是当用户请求一个**目录路径**（如 /blog/）时，Nginx 会按顺序查找该目录下是否存在指定的文件（如 index.html、index.php），找到第一个存在的就返回它；如果都不存在，且未配置 try_files 或 autoindex on，则返回 403 或 404。
注意：index 在 location 块中定义是有效的，但它的作用范围仍是该 location 匹配到的**文件系统路径下的目录**，不是逻辑路径。
为特定 location 设置专属默认首页（推荐方式）
更可靠、更常用的做法是用 try_files 显式控制：它能明确指定“请求这个 location 时，优先尝试哪些文件”，不受限于是否为目录结尾，也支持 fallback。
- 把
index放在location中仅作补充（例如配合autoindex），不建议单独依赖它做“默认页路由” - 用
try_files $uri $uri/ /blog/index.html =404;这类写法，才能真正实现“访问/blog或/blog/都返回/blog/index.html” - 若需 PHP 支持，可写成
try_files $uri $uri/ /blog/index.php?$args;
实际配置示例
假设你想让所有对 /docs 路径的请求（无论带不带斜杠）都返回 /var/www/docs/home.html：
location /docs {
alias /var/www/docs/;
index home.html;
try_files $uri $uri/ home.html;
}
说明：
-
alias确保路径映射正确（注意末尾斜杠） -
index home.html是可选的，仅在用户显式访问/docs/（带尾斜杠）且该目录存在时起作用 -
try_files $uri $uri/ home.html是关键：先找精确文件，再找目录，最后回退到home.html（相对于 alias 路径）
常见误区提醒
以下写法是无效或容易出错的：
-
location /api { index index.php; }——/api通常不是目录，index完全不触发 -
location / { index /custom.html; }——index后面只能跟文件名，不能带路径 - 混用
root和alias与index：用alias时，index查找的是 alias 指向的目录；用root时，是 root + location 路径拼接后的目录
