启用autoindex需正确配置root/alias、权限、selinux上下文、charset utf-8、autoindex_localtime on、autoindex_exact_size off,并确保请求url以/结尾。

直接启用 autoindex on 就能出列表,但默认 HTML 样式简陋、中文乱码、时间不对、大小不友好——这些问题不是“配不配得出来”,而是“配得对不对”。
autoindex on 必须配合 location 使用,且 root 路径要真实存在
很多人加了 autoindex on 却返回 403 或 404,根本原因是没配对 root 或 alias。Nginx 不会自动把 location /files 映射到磁盘上某个目录,必须显式声明:
-
root是拼接路径:若root /data,location /files→ 实际访问/data/files -
alias是替换路径:若alias /data/files/,location /files→ 实际访问/data/files/(注意末尾斜杠) - 目录需有读取权限,且 Nginx 工作进程(如
www-data或nginx)能进入该目录和其父目录 - SELinux 启用时,需确认上下文为
httpd_sys_content_t,否则即使权限全开也拒绝访问
中文文件名乱码?加 charset utf-8 并检查文件系统编码
浏览器显示 “” 或方块,大概率是响应头缺字符集或文件名本身含非 UTF-8 字节。Nginx 不负责转码文件名,只负责声明编码:
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq(Cortex‑A9/A53 + FPGA)Linux 环境,调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查,支持 PetaLinux 开发。
- 在
location块内加charset utf-8;,确保响应头含Content-Type: text/html; charset=utf-8 - Linux 文件系统(如 ext4)默认存储文件名为原始字节,若文件是 Windows 传入的 GBK 编码名,Nginx 无法识别——应统一用 UTF-8 命名,或用
convmv批量转换 - 不要在
http块全局设charset,避免干扰 API 接口等非 HTML 响应
时间显示 UTC 而非本地时间?用 autoindex_localtime 控制
默认所有时间按 UTC 渲染,看着像“比实际早 8 小时”。这不是时区没设好,而是模块默认关本地化:
- 加
autoindex_localtime on;即可显示服务器本地时间(如 CST) - 该指令不影响日志或 access log,只作用于 autoindex 生成的 HTML 表格中的
Modified列 - 若服务器时区本身未设对(
timedatectl status查看),开启也没用;先运行timedatectl set-timezone Asia/Shanghai
文件大小显示为字节太不直观?关掉 autoindex_exact_size
默认 autoindex_exact_size on,12345678 字节直接写成 “12345678”,没人想心算换算。关掉它就自动转单位:
-
autoindex_exact_size off;→ 显示 “11.8M”、“2.1G” 等 - 这个开关只影响 HTML 输出,XML/JSON 格式仍返回原始字节数(不受影响)
- 注意:该指令不能和
autoindex_format json同时用于同一 location,否则 JSON 输出里大小字段语义混乱
真正容易被忽略的点是:autoindex 只响应以 / 结尾的请求;访问 /files(无尾斜杠)会 301 跳转到 /files/,而跳转依赖 index 指令是否匹配——如果同时配了 index index.html,又没这个文件,就会 403。所以要么确保 URL 带尾斜杠,要么删掉冲突的 index 指令。










