Nginx静态文件服务需协同优化目录浏览与缓存：启用安全的autoindex、正确选用root/alias映射路径、按资源类型分层设置expires与Cache-Control、关闭访问日志，并全局配置open_file_cache提升小文件并发性能。
启用安全可控的目录索引（autoindex）
默认情况下 Nginx 不开放目录列表，需显式开启，但必须限制范围并避免敏感路径暴露：
- 只在明确需要浏览的 location 中启用，例如
location /files/ { autoindex on; autoindex_exact_size off; autoindex_format html; } -
autoindex_exact_size off用 KB/MB 显示大小，提升可读性；autoindex_format html输出标准 HTML 列表（支持现代浏览器） - 禁用根路径或配置目录遍历防护：
location / { autoindex off; }，防止意外暴露整个网站结构 - 配合
auth_basic或 IP 白名单（如allow 192.168.1.0/24; deny all;）保护私有资源目录
正确映射静态路径：root 与 alias 的选用逻辑
路径映射出错是 404 最常见原因，本质区别在于拼接方式：
-
用 root 时：请求
/static/js/app.js→ 实际查找/var/www/html/static/js/app.js（URI 全路径拼接） -
用 alias 时：请求
/static/js/app.js→ 实际查找/var/www/assets/js/app.js（URI 中匹配前缀被完全替换） - 推荐对版本化资源目录（如
/v1.2.0/）用alias，便于平滑切换；对通用子路径（如/images/）用root更直观 - 避免在同一个 location 同时配置 root 和 alias，Nginx 会忽略 root
分类型设置 HTTP 缓存头（expires 与 Cache-Control）
缓存策略必须按文件特性差异化，而非“一刀切”：
- 带哈希指纹的资源（如
main.a1b2c3.js、style.f4e5d6.css）→ 强缓存：expires 1y; add_header Cache-Control "public, immutable"; - 无版本号的通用资源（如
logo.png、robots.txt）→ 短期缓存 + 协商缓存：expires 1h; add_header ETag "W/\"$(md5sum $request_filename | cut -d' ' -f1)\""; - HTML 页面（尤其 SPA 的 index.html）→ 禁用强缓存，但允许协商：
expires -1; add_header Cache-Control "no-cache"; - 所有静态 location 均建议关闭访问日志：
access_log off;，减少 I/O 压力
启用 open_file_cache 提升元数据访问效率
这是常被忽略却对高并发小文件场景至关重要的内核级优化：
- 放在
http{}块中全局启用：open_file_cache max=10000 inactive=60s; - 配套指令不可省略：
open_file_cache_valid 30s;（每 30 秒验证缓存有效性）、open_file_cache_min_uses 2;（至少被访问 2 次才进缓存）、open_file_cache_errors on;（缓存 404/403 等错误，防恶意扫描反复触发 stat） - 不建议在 server 或 location 块中重复配置，该缓存是 worker 进程共享的，嵌套易导致行为异常
- 配合
sendfile on;和tcp_nopush on;可进一步减少内核态拷贝与网络包碎片
