在 nginx 中配置目录浏览结构，需要在 `location` 块中开启 `autoindex on` 并设置 `autoindex_exact_size` 和 `autoindex_localtime` 参数。默认情况下，nginx 会显示原始字节大小且使用 utc 时间，通过调整这两个参数可以优化展示效果，使其更符合用户阅读习惯。
如何启用目录列表并控制文件大小显示格式
要启用目录列表功能，只需在对应的 `location` 块中添加 `autoindex on;` 指令。默认情况下，`autoindex_exact_size` 为 `on`，这意味着对于小于 1MB 的文件，Nginx 会显示精确的字节数；而对于大于等于 1MB 的文件，则显示 KB、MB 等人类可读单位。如果希望所有文件都显示精确字节数，或者统一显示人类可读单位，可以通过修改该参数来实现。
server {
listen 80;
server_name example.com;
location /files/ {
alias /var/www/files/;
autoindex on;
autoindex_exact_size off;
autoindex_localtime on;
}
}
上述配置中，`alias` 指令将 URL 路径映射到服务器文件系统路径。`autoindex_exact_size off;` 使得所有文件大小都以 KB、MB 等单位显示，提升可读性。`autoindex_localtime on;` 则让显示的时间转换为服务器本地时区时间，而非默认的 UTC 时间。重启 Nginx 后，访问 `/files/` 路径即可看到格式化后的目录列表。
如何自定义目录列表的 HTML 样式
Nginx 生成的目录列表页面是纯 HTML 结构，没有内置 CSS 样式，因此默认看起来较为简陋。虽然 Nginx 本身不支持直接注入 CSS，但可以通过 HTTP 响应头或前端代理方式间接实现样式定制。更常见且推荐的做法是在客户端通过 JavaScript 或外部 CSS 文件对页面进行美化。
// 示例：通过添加一个 index.html 文件来覆盖默认行为
// 在 /var/www/files/ 目录下创建 index.html
<title>Files</title><style>
body { font-family: Arial, sans-serif; margin: 20px; }
table { border-collapse: collapse; width: 100%; }
th, td { padding: 8px; text-align: left; border-bottom: 1px solid #ddd; }
th { background-color: #f4f4f4; }
a { text-decoration: none; color: #0366d6; }
a:hover { text-decoration: underline; }
</style><h1>File Directory</h1>
<!-- Nginx autoindex 会自动在此处插入表格 -->
通过在目标目录放置自定义的 `index.html`，可以完全接管页面结构。但注意，当 `autoindex on` 时，Nginx 会忽略 `index.html` 并动态生成内容。因此，若需完全自定义样式，应关闭 `autoindex` 并使用反向代理或脚本动态生成目录列表。另一种折中方案是使用 `try_files` 结合静态资源服务，但这超出了 `autoindex` 的直接配置范围。对于大多数场景，保持默认 HTML 结构并通过浏览器扩展或用户端脚本美化是更实用的选择。
当目录中包含特殊字符文件名时，autoindex 如何处理编码
Nginx 的 `autoindex` 模块在处理包含非 ASCII 字符（如中文、emoji）的文件名时，会自动将其转换为 UTF-8 编码并在 HTML 中以实体形式或直接以 UTF-8 字节序列输出。现代浏览器通常能正确解码并显示这些字符，无需额外配置。然而，在某些旧版浏览器或特定客户端环境下，可能会出现乱码。此时，确保 Nginx 配置的 `charset utf-8;` 生效是关键。
例如，若目录中存在名为 `报告.pdf` 的文件，`autoindex` 会在 HTML 中生成类似 `报告.pdf` 的链接，其中文件名部分以 UTF-8 编码传输。只要服务器响应头中包含 `Content-Type: text/html; charset=utf-8`，浏览器就能正确渲染。若发现乱码，检查 Nginx 全局或 `location` 块中是否设置了 `charset utf-8;`，并确保客户端请求头中的 `Accept-Charset` 支持 UTF-8。
