要让nginx自动列出目录下静态文件，需在server或location块中启用autoindex on，并配合root或alias正确指向目标目录；root拼接uri路径，alias直接映射目录；还可通过autoindex_exact_size、autoindex_format、autoindex_localtime等指令优化显示；务必确保权限正确、限制访问范围并禁用敏感文件显示，最后nginx -t测试后reload生效。
要让 Nginx 自动列出目录下的静态文件，需启用 autoindex 指令，并确保相关路径可访问、索引功能已开启且无其他规则干扰。
开启 autoindex 并指定目录
在 server 或 location 块中添加 autoindex on;，并用 root 或 alias 正确指向目标目录。注意：root 拼接 URI 路径，alias 直接映射到指定目录，二者行为不同，选错会导致 403 或 404。
- 使用
root示例（请求/files/时，实际查找/var/www/html/files/）：
location /files/ {<br> root /var/www/html;<br> autoindex on;<br>}
- 使用
alias示例（请求/files/时，直接对应/data/static/）：
location /files/ {<br> alias /data/static/;<br> autoindex on;<br>}
控制显示格式与额外选项
可通过以下指令优化列表体验：
-
autoindex_exact_size off;：文件大小以 KB/MB 显示，而非精确字节数 -
autoindex_format html | json | xml;：指定输出格式，默认 html；设为json可用于前端解析 -
autoindex_localtime on;：时间显示本地时区，而非 UTC
确保权限与安全限制
Nginx 工作进程必须有读取目录及其中文件的权限（如 ls /data/static 可执行）。同时建议：
- 避免在根 location 启用 autoindex，防止整站目录泄露
- 配合
deny all;或 IP 限制，限制访问范围 - 禁用敏感文件显示：通过
location ~ \.(htaccess|htpasswd|ini|log)$ { deny all; }
验证配置并重载
修改后运行 nginx -t 测试语法，确认无误再执行 nginx -s reload。访问对应 URL（如 http://your-domain.com/files/），看到带链接的文件列表即成功。
