静态资源放哪里?按项目类型说清目录位置与访问路径
静态资源放哪里,先看它由谁对外提供访问。
纯静态站点(HTML、CSS、JS、图片)通常直接放在 Nginx 的站点根目录;
前后端分离项目把打包产物放在 Nginx 单独目录,通过 location 或独立域名暴露;
后端框架项目则放进框架约定的静态目录,由应用自己处理。
下面按这三种常见情况说清目录位置、配置和验证方式。
纯静态站点:放在 Nginx 的 root 目录
如果整站都是静态文件,最直接的做法是把文件放到 Nginx 配置里 root 指向的目录。
常见路径是 /usr/share/nginx/html 或 /var/www/你的域名。
操作前先确认 Nginx 配置中的 root 路径:
nginx -T | grep -E "server_name|root"
假设站点配置为:
server {
listen 80;
server_name example.com;
root /var/www/example.com;
index index.html;
}
把静态文件上传到 /var/www/example.com,确保 index.html 位于该目录下,然后检查权限并重载 Nginx:
chown -R www-data:www-data /var/www/example.com
chmod -R 755 /var/www/example.com
nginx -t && systemctl reload nginx
访问 http://example.com,页面能正常打开、浏览器开发者工具里 CSS 和 JS 请求返回 200,就说明位置正确。
如果返回 403,优先检查目录权限和 index 文件是否存在;
返回 404 则检查 root 路径是否写错。
前后端分离:静态资源单独放一个目录
前端项目打包后通常生成 dist 目录,里面是 index.html、assets 等文件。
不要把它和后端代码混在一起,建议单独放,例如 /var/www/frontend。
Nginx 配置可以按路径区分:
server {
listen 80;
server_name example.com;
root /var/www/frontend;
index index.html;
location /api/ {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
}
}
这样静态资源从 /var/www/frontend 读取,接口请求转发给后端。
上传后同样执行 nginx -t 和 systemctl reload nginx 验证。
如果静态资源访问量大或需要 CDN,可以把 dist 上传到对象存储,Nginx 只保留 HTML 入口。
判断条件很简单:资源更新频率低、访问量大、希望减轻服务器带宽时,对象存储更合适;
否则先放本机目录,维护成本更低。
后端框架项目:用框架约定的静态目录
使用 Spring Boot、Django、Flask 等框架时,静态资源一般放在框架默认目录,由应用直接返回。
例如 Spring Boot 默认从 src/main/resources/static 读取,Django 在开发阶段使用 STATICFILES_DIRS 配置的目录。
这类场景不要手动改 Nginx 的 root 去指向框架目录,否则可能绕过应用逻辑。
正确做法是查框架文档确认静态目录,把文件放进去,再按框架要求配置访问前缀。
上线时如果前面有 Nginx,通常让 Nginx 把静态请求直接转发到应用,或者把静态文件收集到独立目录后由 Nginx 提供。
具体用哪种,取决于框架是否已经处理好缓存和版本控制。
容易踩的坑:权限、路径和缓存
静态资源放错位置后,最常见的问题是 403 和 404。
403 多由目录权限不足或 SELinux 限制引起,可以先用 namei -l /var/www/example.com/index.html 逐级检查路径权限。
404 则要核对 Nginx 的 root 和实际文件路径是否一致,注意结尾斜杠和大小写。
另一个常见问题是浏览器缓存。
替换同名静态文件后页面没变化,不一定是位置错了,可能是缓存未过期。
验证时可以强制刷新,或在开发者工具中禁用缓存后重新请求。
生产环境建议给静态资源文件名加哈希,而不是依赖手动清缓存。
放好之后怎么确认生效
无论选哪种位置,最后都用三个检查收尾:
- 用
curl -I http://你的域名/静态文件路径看返回状态码是否为 200; - 查看 Nginx 错误日志
tail -f /var/log/nginx/error.log,确认没有权限或路径报错; - 在浏览器开发者工具的 Network 面板确认 CSS、JS、图片请求的 URL 和实际文件路径对应。
静态资源放哪里,本质上是由访问入口决定的:谁对外提供 HTTP 服务,文件就放到谁配置的目录里。
先确认入口,再按上面的目录和配置操作,最后用状态码和日志验证,就能避免大部分位置错误。