Nginx 中如何配置 Nginx 的静态资源路径-Nginx-PHP中文网

nginx不生成静态文件，仅高效分发已存在资源；关键在于用root（拼接uri）或alias（替换前缀）精准映射路径，确保权限可读、动静分流不冲突，并配置缓存与安全策略。

nginx 中如何配置 nginx 的静态资源路径

Nginx 本身不生成文件，只负责高效分发已存在的静态资源。配置静态资源路径的核心是让请求 URL 能准确映射到服务器上真实的文件位置，关键在 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 规则捕获，需优先匹配静态路径或扩展名。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

优先使用前缀匹配（^~）定位明确产出目录：
location ^~/reports/ { alias /data/reports/; }
再用正则兜底常见静态类型（注意顺序，正则优先级低于前缀匹配）：
location ~ \.(html|json|svg|xml|txt|css|js)$ { root /data/generated-content; }
确保 API 路径（如 /api/）有更高优先级的 location ^~ /api/ 并指向 proxy_pass，避免被静态规则拦截

即使路径配置正确，权限不足也会返回 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; }