nginx目录索引核心是区分autoindex（自动生成目录列表）与index指令（按序查找默认文件），二者互斥：先匹配index文件，全不存且autoindex on才列目录；需正确配置root/alias、权限及安全限制。
Nginx 处理静态资源的目录索引，核心在于区分两种行为：自动列出目录内容（autoindex） 和 返回默认索引文件（index）。两者互斥且逻辑清晰，选错会导致 403、404 或空白页。
自动列出目录内容（启用 autoindex）
当用户访问一个以 / 结尾的路径（如 /downloads/），且该路径对应真实目录但无 index.html 等默认页时，可让 Nginx 自动生成带链接的 HTML 文件列表。
- 在
location块中添加autoindex on;，并确保root或alias正确指向该目录 - 推荐用
alias避免路径拼接歧义：例如location /files/ { alias /data/public/; autoindex on; }→ 请求/files/直接映射到/data/public/ - 优化显示：加
autoindex_localtime on;显示本地时间，autoindex_exact_size off;用 KB/MB 显示大小 - 输出格式可设为
json或xml，方便前端程序解析
返回默认索引文件（使用 index 指令）
这是更常见的方式：用户访问目录路径（如 / 或 /blog/），Nginx 尝试按顺序查找并返回指定的默认文件。
- 在
server或location中配置index index.html index.htm;，按从左到右顺序匹配 -
root决定查找起点：比如root /var/www/site;+ 请求/about/→ 查找/var/www/site/about/index.html - 若目录下没有匹配的索引文件，且未启用
autoindex，Nginx 默认返回 403（禁止访问）或 404（取决于权限和配置）
关键注意事项
两者不能同时“隐式生效”，需明确配置意图；否则行为不可控。
-
root和alias行为不同：root会拼接完整 URI 路径，alias是直接替换前缀 —— 混用易导致 403（权限拒绝）或 404（路径不存在） - 目录必须有执行权限（
x位），Nginx 才能进入并读取内容；文件至少需 644，目录至少需 755 - 安全起见，避免在根
location /启用autoindex；建议限定子路径，并配合 IP 限制或基础认证 - 禁用敏感文件访问：用
location ~ \.(htaccess|htpasswd|ini|log|env)$ { deny all; }防止泄露
验证是否生效
改完配置别急着 reload，分三步确认：
- 运行
nginx -t检查语法是否正确 - 用
curl -I http://localhost/files/看响应头和状态码（200 表示成功，403/404 需查日志） - 查看错误日志（通常是
/var/log/nginx/error.log），里面会明确提示 “directory index of … is forbidden” 或 “No such file or directory”
