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 应有访问权限。

nginx
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 / { }
}

检查并重载后,在同一台机器执行:

bash
# 目录地址使用候选顺序,完整文件地址直接读取指定文件。
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/

预期输出:

text
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 处理规则;仅写文件名不会启动解释器,也不应把脚本源文件当普通静态文件公开返回。

不要为了让目录“有东西可看”而随手开启目录列表。若站点本来不应暴露目录内容,补齐预期首页或明确返回错误更符合部署目标;变更后重新请求目录地址与具体文件地址,分别确认行为。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

index 指令怎样决定首页文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通