Web 服务器与网关 / 系统课时
index 指令怎样决定首页文件
index 指令怎样决定首页文件
访问目录地址 /catalog/ 时,客户端没有写出具体文件名,Nginx 要按 index 的候选顺序寻找首页。本篇用两个候选文件观察谁先返回,并解释找到首页后发生的内部跳转与没有首页时的常见 403。
学习目标
- 按 index 列表顺序判断目录首页。
- 区分目录请求与直接请求某个文件。
- 解释首页查找后的内部跳转与缺失首页的行为。
目录首页按配置顺序查找
假设 /srv/index-demo/catalog/home.html 内容为 home-first,同目录的 index.html 内容为 index-second,两个文件均带换行。再准备一个可访问但没有首页文件的 /srv/index-demo/empty/ 目录,作为失败对照。
index 主要处理以斜杠结尾的目录 URI。设置 index home.html index.html; 后,会先找 home.html,不存在才继续尝试 index.html,不是按文件创建时间或字母顺序选择。直接请求 /catalog/index.html 则已经给出了具体文件名,不受候选顺序改写。
配置并观察两个入口
片段示例:以下块加载到 http 上下文,依赖上面的目录和文件;Worker 应有访问权限。
server {
listen 127.0.0.1:8080;
server_name index.test;
root /srv/index-demo;
# 候选从左到右查找,home.html 优先于 index.html。
index home.html index.html;
autoindex off;
location / { }
}检查并重载后,在同一台机器执行:
# 目录地址使用候选顺序,完整文件地址直接读取指定文件。
curl -sS -H 'Host: index.test' http://127.0.0.1:8080/catalog/
curl -sS -H 'Host: index.test' http://127.0.0.1:8080/catalog/index.html
curl -sS -o /dev/null -H 'Host: index.test' -w 'status=%{http_code}\n' http://127.0.0.1:8080/empty/预期输出:
home-first
index-second
status=403前两个响应状态为 200。最后一个结果限定在本例:目录可进入、没有配置的首页、目录列表关闭且没有其他回退。若目录不存在可能是 404,若有额外 location、权限限制或回退逻辑,结果也可能不同,不能把所有 403 都归因于缺少首页。
找到首页后还会内部跳转
index 模块文档说明,使用首页会触发内部跳转。/catalog/ 找到 home.html 后,后续处理 URI 是 /catalog/home.html,它可能命中另一条更具体的路径规则;客户端通常不会因此收到 301,也不会自动改变地址栏。

查找失败时检查实际目录
从错误日志中的磁盘路径开始,确认 root 拼接结果、文件大小写和 Worker 权限。若计划用 index.php,还需要对应的 PHP/FastCGI 处理规则;仅写文件名不会启动解释器,也不应把脚本源文件当普通静态文件公开返回。
不要为了让目录“有东西可看”而随手开启目录列表。若站点本来不应暴露目录内容,补齐预期首页或明确返回错误更符合部署目标;变更后重新请求目录地址与具体文件地址,分别确认行为。