Nginx 的 index 指令不限文件类型，仅按顺序查找指定文件名并返回首个存在的文件；需确保 MIME 类型已定义、文件路径正确、权限可读，且不与 try_files 冲突。
Nginx 的 index 指令默认支持任意文件名，不限于 HTML；只要文件真实存在、权限正确、且被客户端请求路径隐式匹配，就能作为默认文档返回——关键在于 Nginx 能否成功读取并响应，与后缀名本身无关。
index 指令本身不限制文件类型
index 指令只负责在用户访问目录（如 / 或 /api/）时，按顺序查找指定的文件名。它不校验 MIME 类型或内容格式。例如：
-
index index.md index.json index.txt;是完全合法的配置 - 当用户请求
https://example.com/，Nginx 会依次尝试找/usr/share/nginx/html/index.md、index.json等，找到第一个存在的即返回 - 返回时，Nginx 会根据文件扩展名自动设置
Content-Type（依赖types模块和mime.types）
确保对应 MIME 类型已定义
若访问 index.json 却收到 text/plain 或下载行为，大概率是 MIME 类型未注册。需检查或补充 types 块：
（通常在 /etc/nginx/mime.types 或主配置中）
立即学习“前端免费学习笔记（深入）”；
- 确认存在类似
application/json json;的映射（Nginx 1.12+ 默认包含） - 若用自定义后缀如
.md，手动添加：text/markdown md; - 修改后需重载：
nginx -s reload
注意权限与静态服务上下文
index 只在 location 匹配到目录（末尾为 /）且启用 autoindex off（默认）时生效。常见疏漏：
- 目标文件（如
index.json）需位于root或alias指向的物理路径下，且 Nginx 工作进程有读取权限 - 避免与
try_files冲突：若同时配置了try_files $uri $uri/ =404;，则index仍有效；但若写成try_files $uri /index.json;，就绕过了index指令本身 - API 目录常用示例：
location /api/ {<br> root /opt/data;<br> index index.json;<br> }
访问/api/将返回/opt/data/api/index.json
验证是否生效
最直接方式是发起请求并检查响应头：
-
curl -I https://example.com/查看Content-Type和Content-Length - 用
curl https://example.com/看返回内容是否为你期望的 JSON/MD/TXT 文件内容 - 检查 Nginx 错误日志（
error.log）是否有open() "/path/index.json" failed (13: Permission denied)等提示
