nginx原生不支持目录一键下载，仅提供html文件列表；需配合静态zip、第三方模块或后端api实现打包下载，并注意权限控制与安全防护。
在 Nginx 中启用目录浏览（Autoindex）本身只提供 HTML 格式的文件列表，不直接支持“一键下载整个目录”。但你可以通过合理配置 autoindex 模块 + 配合简单前端逻辑或外部工具，实现类似效果。关键在于：Nginx 原生 不提供 ZIP 打包下载功能，需明确区分“浏览”和“下载”两个行为。
启用基础目录浏览（autoindex）
确保 Nginx 已编译并启用了 ngx_http_autoindex_module（默认开启）。在 server 或 location 块中添加：
location /downloads/ {
alias /var/www/files/;
autoindex on;
autoindex_exact_size off;
autoindex_format html;
autoindex_localtime on;
}
访问 https://example.com/downloads/ 即可看到带时间、大小的可点击文件列表——点击单个文件即可下载。
让目录链接支持“下载整个文件夹”（需额外处理）
Nginx 不生成 ZIP，但可通过以下方式模拟该体验：
-
用静态 ZIP 文件代替目录：将常用目录提前压缩为
archive.zip，放在对应路径下，并在页面中显式提供下载链接（如用index.html替代 autoindex 页面）。 - 借助第三方模块（如 nginx-http-autoindex-zh）：部分社区模块扩展了 autoindex，支持点击目录名触发 ZIP 打包（依赖后端脚本），但需自行编译，稳定性与安全性需评估。
-
配合后端 API：Nginx 反向代理到一个轻量服务（如 Python Flask），当请求
/downloads/archive?dir=xxx时，服务动态打包并返回 ZIP 流。Nginx 仅做路由转发，不参与打包逻辑。
增强可用性与安全建议
开启 autoindex 后，注意规避常见风险：
- 禁止列出敏感路径：确保
alias指向专用目录，且该目录不含.htaccess、.env等文件；可用location ~ \.(env|git|svn|log)$ { deny all; }屏蔽。 - 限制 IP 或加认证：对下载目录启用 basic auth：
auth_basic "Restricted"; auth_basic_user_file /etc/nginx/.htpasswd; - 关闭 autoindex 对上级目录的遍历：
autoindex off在根 location，仅在明确子路径中开启。
替代方案：更实用的下载管理
若目标是让用户便捷获取一批文件，推荐更可控的方式：
- 用
rsync或curl -O批量下载（适合技术用户）； - 部署轻量文件服务（如 fileserver 或 WebDAV），原生支持目录 ZIP 下载；
- 生成带
download属性的 HTML 列表页（非 autoindex），用 JS 调用后端打包接口并触发下载。
