Nginx中配置默认首页需在最内层匹配的location块中使用index指令，按空格分隔顺序查找文件；必须配合正确的root路径、权限及location匹配，必要时用try_files协同兜底。
在 Nginx 中配置默认首页文件，核心是用好 index 指令，并确保它与 root（或 alias）配合正确、作用域清晰。它本身不重定向，也不调用后端，只在用户访问目录（如 / 或 /blog/）时，按顺序查找并返回第一个存在的文件。
index 指令该写在哪一级？
它可出现在 http、server 或 location 块中，但生效以**最内层匹配的 location 块为准**：
- 多站点场景下，推荐在每个
server块内直接配置，避免继承全局值造成意外 - 若某路径需特殊处理（如
/admin/只认admin.php），就在对应location块中单独写index admin.php; - 不建议把
index放在http块做“统一设置”，容易被覆盖且难以调试
怎么写 index 才能按顺序生效？
语法很简单，但顺序和存在性决定行为：
- 格式为：
index index.html index.htm index.php;（多个文件名用空格分隔，结尾必须有分号） - Nginx 从左到右检查：先找
index.html，存在就返回；不存在则查index.htm，依此类推 - 如果只写
index index.php;，就不会自动 fallback 到index.html，必须显式列出所有候选 - 文件名可以是相对路径（如
login.html），但不能是绝对路径
为什么配置了 index 还是显示欢迎页或 403？
绝大多数问题不出在 index 本身，而在于支撑条件未满足：
-
root 路径没配对：比如
root /var/www/myapp;，那就要确认/var/www/myapp/index.html真实存在 -
权限不对：Nginx 工作用户（如
www-data或nginx）必须对root目录及其中的 index 文件有读取权限 -
location 匹配失效：确保请求实际进入了你写了
index的那个location块（可用curl -I http://localhost/看状态码和Content-Type判断） -
别用 alias 配 index：
alias不拼接 URI，容易导致路径计算错误；统一用root + 标准目录结构更可靠
如何搭配 try_files 实现更健壮的首页逻辑？
纯 index 只解决“目录访问时选哪个文件”，无法兜底“文件不存在时怎么办”。这时需要 try_files：
- 单页应用（SPA）常用：
try_files $uri $uri/ /index.html;—— 先找真实文件，再触发index查目录，最后回退到前端路由入口 - PHP 应用常用：
try_files $uri $uri/ /index.php?$query_string;，此时仍需保留index index.php;，否则$uri/匹配目录时无法确定默认文件 - 注意：
try_files和index是协同关系，不是替代关系
