在 nginx 中结合 root 和 autoindex 实现目录浏览，需要在对应的 location 块中同时配置这两项指令。设置 root 指定文件系统的绝对路径，开启 autoindex on 启用列表功能，并建议添加 autoindex_exact_size off 以优化显示效果。这样当访问该路径且未找到默认索引文件时，nginx 会自动生成 html 表格展示目录内容。
如何配置 location 块以启用自动索引
要实现目录浏览，必须在处理请求的 location 块中显式开启 autoindex。仅设置 root 是不够的，因为默认情况下 Nginx 会尝试寻找 index.html 等文件，若不存在则返回 403 或 404。通过添加 autoindex on，Nginx 会在找不到索引文件时转而读取目录结构并生成动态页面。同时，使用 alias 而非 root 可以改变 URL 路径与文件系统路径的映射关系，这在某些场景下更灵活，但 root 是更基础且常用的方式。
server {
listen 80;
server_name localhost;
# 定义根目录路径
root /var/www/html;
location /files/ {
# 开启目录浏览
autoindex on;
# 关闭精确文件大小显示（KB/MB）
autoindex_exact_size off;
# 使用本地时间显示日期
autoindex_localtime on;
}
}
上述配置中，/var/www/html 是服务器上的实际目录。当用户访问 http://localhost/files/ 时，如果该目录下没有 index.html，Nginx 将列出 /var/www/html/files/ 下的所有文件和子目录。注意 location /files/ 后的斜杠很重要，它确保了路径匹配的正确性。
autoindex 指令有哪些关键参数影响显示效果
autoindex 模块提供几个关键参数来控制生成的目录列表页面的外观和行为。除了基础的 on/off 开关外，autoindex_exact_size 决定文件大小是以字节显示还是转换为 KB/MB/GT 等单位。默认为 on，显示精确字节数；设为 off 后更直观。另一个重要参数是 autoindex_localtime，默认为 off，此时显示的是 UTC 时间；设为 on 后显示服务器所在时区的本地时间，便于用户理解文件修改时间。这些参数共同决定了最终呈现给用户的目录列表的易读性和准确性。
# 对比两种配置的效果
# 配置 A: 默认行为
location /dir_a/ {
root /data;
autoindex on;
}
# 配置 B: 优化显示
location /dir_b/ {
root /data;
autoindex on;
autoindex_exact_size off;
autoindex_localtime on;
}
在配置 A 中，文件大小将以字节为单位显示，例如 1024，时间为 UTC。在配置 B 中，文件大小将显示为 1.0K，时间为服务器本地时间。对于公开的文件分享服务，配置 B 通常提供更好的用户体验。确保 /data/dir_a/ 和 /data/dir_b/ 目录存在且有可读权限，否则即使配置正确也会返回 403 Forbidden。
当目录中包含隐藏文件时 autoindex 如何处理
Nginx 的 autoindex 模块默认会列出目录中的所有条目，包括以点（.）开头的隐藏文件，如 .git、.htaccess 或 .DS_Store。这意味着如果直接暴露整个项目目录，敏感信息可能会泄露。Nginx 本身没有内置的“排除隐藏文件”参数来过滤 autoindex 的输出。要实现这一目的，通常需要借助 try_files 或 if 指令进行复杂判断，或者更推荐的做法是在文件系统层面管理权限，或使用反向代理配合其他工具（如 Python 的 SimpleHTTPServer 带过滤）来实现更精细的控制。但在纯 Nginx 方案中，无法直接通过配置项隐藏特定模式的文件。
