Nginx启用autoindex时，root必须指向目标目录的父级目录而非目标目录本身，因真实路径= root + location匹配的URI；需确保Nginx用户对目录有rx权限，并推荐启用autoindex_format html等美化选项。
在 Nginx 中启用目录浏览（autoindex）时，root 指令的路径设置直接影响能否正确显示文件列表，稍有偏差就会返回 403 或 404。关键在于：root 路径必须指向包含目标目录的父级目录，而非目标目录本身；同时需确保系统权限与 Nginx 用户可读。
root 路径要指向“上级目录”，不是目标目录
Nginx 的 autoindex on 是基于 location 匹配路径 + root 拼接出真实文件系统路径的。它不是把 root 当作根目录直接映射，而是拼接：
真实路径 = root + location 匹配到的 URI 路径。
例如，想通过 https://example.com/files/ 列出 /data/web/files/ 下的内容：
- ✅ 正确配置：
location /files/ {
root /data/web;
autoindex on;
autoindex_format html;
}
→ 请求/files/时，Nginx 拼出/data/web/files/，刚好是目标目录。 - ❌ 错误写法：
root /data/web/files;
→ 请求/files/会拼成/data/web/files/files/，多了一层，导致 404。
启用美化功能：autoindex_format 和 autoindex_exact_size
默认 autoindex 输出纯文本，开启 HTML 格式并优化显示更友好：
-
autoindex_format html;：生成带链接、图标的 HTML 列表（Nginx 1.7.9+） -
autoindex_exact_size off;：显示 KB/MB 等易读单位，而非字节数 -
autoindex_localtime on;：用服务器本地时间（非 GMT），更符合直觉
基础安全与权限注意事项
即使配置正确，仍可能因权限失败：
- 确认 Nginx 工作用户（如
www-data或nginx）对/data/web/files/及其父目录有x（执行/遍历）和r（读取）权限 - 避免在生产环境无限制开放 autoindex，建议加
auth_basic或限制 IP - 若启用了
alias，注意它与root行为不同——alias是完全替换路径，不拼接，此时不能混用 autoindex
完整可运行示例
将以下配置放入 server 块中，重启 Nginx 即可访问 /dl/ 查看 /srv/downloads/ 目录：
location /dl/ {
root /srv;
autoindex on;
autoindex_format html;
autoindex_exact_size off;
autoindex_localtime on;
# 可选：添加图标支持（需提前下载 nginx-autoindex.css 和 icons）
# autoindex_css "/css/autoindex.css";
}
如需图标和样式增强，可搭配第三方 CSS（如 nginx-autoindex-css），但原生 HTML 已足够清晰实用。
