Nginx不生成静态文件，仅高效分发已存在资源；关键在于用root（拼接URI）或alias（替换前缀）精准映射路径，确保权限可读、动静分流不冲突，并配置缓存与安全策略。
Nginx 本身不生成文件，只负责高效分发已存在的静态资源。配置静态资源路径的核心是让请求 URL 能准确映射到服务器上真实的文件位置，关键在 root 和 alias 的正确选用、路径一致性、权限可读，以及避免与动态接口冲突。
明确 root 和 alias 的适用场景
root 用于拼接路径：location 中的 URI 会追加到 root 指定目录后；alias 用于替换路径：location 前缀被完全移除，剩余部分直接拼接到 alias 目录后。
- 用
root时，末尾不要加/（如root /var/www/html;），Nginx 会自动拼接 - 用
alias时，末尾必须加/（如alias /data/reports/;），否则路径解析错误 - 例如，想通过
/assets/js/app.js访问/opt/myapp/dist/js/app.js，应写：location /assets/ { alias /opt/myapp/dist/; } - 若用
root实现相同效果，则需把文件实际放在/opt/myapp/dist/assets/js/app.js，再配置：location /assets/ { root /opt/myapp/dist; }
按路径或扩展名精准分流，防止误代理
动静分离时，静态资源不能被通用 proxy_pass 规则捕获，需优先匹配静态路径或扩展名。
- 优先使用前缀匹配（
^~）定位明确产出目录：location ^~/reports/ { alias /data/reports/; } - 再用正则兜底常见静态类型（注意顺序，正则优先级低于前缀匹配）：
location ~ \.(html|json|svg|xml|txt|css|js)$ { root /data/generated-content; } - 确保 API 路径（如
/api/）有更高优先级的location ^~ /api/并指向proxy_pass，避免被静态规则拦截
确保 Nginx 进程有权限读取文件
即使路径配置正确，权限不足也会返回 403 错误。
- 检查目录属主和权限：
ls -ld /data/reports应显示 Nginx 工作用户（如www-data或nginx）有r-x权限 - 子目录和文件也需可读：
find /data/reports -type f ! -readable -o -type d ! -executable可排查问题路径 - 确认 Nginx 配置语法无误：
nginx -t，再执行nginx -s reload
补充实用配置提升可用性
静态服务不只是路径通，还需兼顾缓存、安全和健壮性。
- 启用
try_files避免 404 泛滥：location / { try_files $uri $uri/ =404; } - 设置合理缓存头：
expires 1h;或对不变资源设为expires 1y; add_header Cache-Control "public, immutable"; - 禁止访问敏感文件：
location ~ /\. { deny all; } - 禁用符号链接防止目录穿越：
location /downloads/ { alias /data/files/; disable_symlinks on; }
