Linux怎样配置Nginx开启目录索引

作者：袖梨 2026-06-18

autoindex on 配置不生效主要因 location 块位置错误、路径映射不当（root/alias 拼接逻辑混淆）或权限不足（目录缺少 x 权限、SELinux 限制、文件名编码非 UTF-8）；需确保指令置于精确匹配的 location 块内、URL 以 / 结尾、补全 charset utf-8 等四参数，并验证系统层权限与编码一致性。

autoindex on 配置不生效，基本就是 location 块位置、路径映射或权限三处出了问题。

autoindex 必须写在匹配路径的 location 块里

很多人把 autoindex on 放在 server 或 http 块顶层，结果访问目录仍是 403 或跳转到 index.html —— 因为 Nginx 只在**最精确匹配的 location 块内**读取该指令。

想让 /downloads/ 可浏览，就得写：location /downloads/ { autoindex on; }
若同时存在 location / 和 location /downloads/，前者里的 autoindex off 不会覆盖后者里的 on，但后者必须存在且路径完全匹配（注意末尾 /）
浏览器访问时 URL 必须以 / 结尾（如 http://x.x.x.x/downloads/），否则 Nginx 不触发 autoindex，而是尝试找文件或返回 404

root 和 alias 路径配置错误会导致 403/404

alias 和 root 的拼接逻辑完全不同，配错一个字符就进不了目录。

用 alias /var/www/files/; + location /files/ → 实际读取 /var/www/files/
用 root /var/www/; + location /files/ → 实际读取 /var/www/files/（自动拼接）
alias 值末尾必须有 /，否则路径会被错误截断；root 末尾加不加 / 影响不大，但建议统一不加
检查磁盘路径是否真实存在：ls -ld /var/www/files/，确认输出含 r-x（至少 group 或 other 有执行位）

中文乱码、时间不准、大小难读——这些不是“没开启”，是参数没配齐

默认的 autoindex HTML 简陋且反人类：UTC 时间、字节单位、无 UTF-8 声明。补全以下四行才能正常用：

charset utf-8; —— 必须放在 location 块内，否则中文文件名显示为 %E6%96%87%E4%BB%B6 或方块
autoindex_localtime on; —— 否则 Modified 列全是 UTC，比本地时间早 8 小时（除非服务器时区本身设错，先运行 timedatectl status 确认）
autoindex_exact_size off; —— 否则 12345678 字节直接写数字，不换算成 MB/GB
autoindex_format html; —— 1.7.9+ 版本才支持，缺了它可能返回纯文本或 JSON，浏览器打不开

403 Forbidden？别急着改 Nginx 配置，先看系统层

配置全对却报 403，八成是 Linux 权限或 SELinux 拦住了。

Nginx worker 进程（如 www-data 或 nginx 用户）需要对目标目录及其所有父目录都有 x 权限（进入权限），对文件有 r 权限（读取权限）
运行 chmod o+x /var/www/files（或更安全的 chmod g+x + chgrp www-data /var/www/files）
CentOS/RHEL 默认启用 SELinux，临时验证：执行 setenforce 0，再刷新页面；若恢复访问，说明需修复上下文：chcon -R -t httpd_sys_content_t /var/www/files