Nginx autoindex 详解

autoindex 是 Nginx 的一个指令，用于控制是否在请求目录时自动生成目录列表页面。

基本功能

当客户端请求一个目录（如 http://example.com/files/）时： - 如果目录中包含 index 文件（如 index.html），Nginx 会默认返回该文件 - 如果没有 index 文件且启用了 autoindex，Nginx 会生成一个包含该目录下所有文件和子目录的 HTML 列表页面

配置指令

主要相关指令：

autoindex on | off;  # 开启或关闭目录列表功能
autoindex_exact_size on | off;  # 显示文件确切大小(字节)或近似大小(KB/MB)
autoindex_format html | xml | json | jsonp;  # 设置列表格式
autoindex_localtime on | off;  # 使用本地时间而非UTC显示文件时间

典型配置示例

server {
    listen 80;
    server_name example.com;

    location /downloads/ {
        alias /path/to/your/files/;
        autoindex on;
        autoindex_exact_size off;
        autoindex_localtime on;
    }
}

安全注意事项

1. 谨慎使用：公开目录列表可能暴露敏感文件
2. 限制访问：建议结合认证或IP限制使用
3. 替代方案：考虑使用专门的Web文件管理器如h5ai替代原生autoindex

高级用法

可以结合其他指令美化或限制目录列表：

location /files/ {
    autoindex on;
    add_before_body /autoindex/header.html;
    add_after_body /autoindex/footer.html;

    # 限制某些文件不显示
    autoindex_filter "*.zip *.gz *.tar";
}

希望这个解释对您有帮助。如需更具体的配置示例或问题解答，请随时提问。