nginx 通过 location 块配合 autoindex on 可快速启用目录索引页面；需准确配置 root/alias 路径映射、开启 autoindex 及优化参数（如 autoindex_exact_size off）、确保系统权限与 selinux 允许访问，并可选添加认证或样式美化。

Nginx 的 location 块配合 autoindex on 可以快速为某个目录开启 Web 界面索引（即类似文件列表的页面），无需额外脚本。关键在于路径匹配准确、权限配置合理、静态资源可访问。

明确 location 匹配路径与 root / alias 的区别

要让 autoindex 生效，Nginx 必须能正确映射 URL 到服务器上的物理目录。注意：

• 用 root 时：location 路径会自动拼接到 root 后面。例如：
  location /files/ { root /data; autoindex on; }
  访问 /files/test/ 实际查找的是 /data/files/test/
• 用 alias 时：location 路径会被完全替换。更推荐用于目录索引：
  location /files/ { alias /data/shared/; autoindex on; }
  访问 /files/ 直接列出 /data/shared/ 内容，/files/doc/ 对应 /data/shared/doc/

启用并优化 autoindex 行为

基础开启后，建议补充常用配置提升可用性：

• autoindex on; — 必须开启
• autoindex_exact_size off; — 显示 KB/MB 等易读大小，而非精确字节数
• autoindex_localtime on; — 使用服务器本地时间显示修改时间（默认是 GMT）
• autoindex_format html; — 输出 HTML 列表（默认值，也可设为 json 或 xml）

确保目录可读且有索引权限

即使 Nginx 配置正确，若系统层面无权限，仍会返回 403 错误：

• 确认 Nginx 工作进程用户（如 www-data 或 nginx）对目标目录有 rx 权限：
  chmod 755 /data/shared（至少需执行权限才能进入目录）
• 检查 SELinux（如启用）是否阻止访问：
  setsebool -P httpd_read_user_content 1 或临时用 ls -Z 查看上下文
• 避免在 location 中使用正则或过于宽泛的匹配（如 ^~ /），防止意外覆盖其他配置

可选：限制访问或美化界面

生产环境建议加一层控制：

• 用 auth_basic 添加基础认证：
  auth_basic "Restricted Area"; auth_basic_user_file /etc/nginx/.htpasswd;
• 通过 add_header 加载自定义 CSS（需提前准备样式文件）：
  add_header Content-Security-Policy "default-src 'self'";
• 禁用索引功能时，直接删掉 autoindex on 或设为 off 即可

配置完成后重载 Nginx：nginx -t && systemctl reload nginx，然后访问对应 URL 测试效果。不复杂但容易忽略细节。