静态站最大的坑不在写文章,在上线之后:改了一条 Nginx 配置,全站 403;换了个域名,HTTPS 报错;缓存没刷,用户看到的还是半年前的页面。
这篇把静态站部署到 Nginx 的完整流程和常见故障列清楚,照着做能少走弯路。
一、先明确一件事:运行目录
静态站的网站根目录不等于「构建产物目录」。很多人把整个项目(含源码、node_modules)丢进站点目录,结果首页 404。
正确做法是让站点根目录指向 编译输出目录:
- Hugo →
public/ - Vite / Vue / React →
dist/ - Next.js 静态导出 →
out/ - 纯手写 → 直接放 HTML 的目录
如果不想改站点目录,可以在面板里把「运行目录」设成 /dist 这类子目录。
二、验证文件真的在
部署完先别开浏览器,先在服务器上确认:
ls -lh /www/wwwroot/你的站点/index.html
curl -I http://127.0.0.1
返回 200 说明 Nginx 能找到文件,问题在浏览器侧(缓存/域名);返回 403/404 说明是目录或权限问题。
三、权限是最高频的坑
Nginx 以 www 用户运行,文件属主要对上:
chown -R www:www /www/wwwroot/你的站点
chmod -R 755 /www/wwwroot/你的站点
如果是从 Windows 上传的压缩包解压,权限经常是 777 或 root,直接导致 403。
四、SPA 刷新 404 怎么修
单页应用的路由是前端接管的,用户直接访问 /article/123 时,Nginx 会去找同名文件,找不到就 404。
在伪静态里加回退规则:
location / {
try_files $uri $uri/ /index.html;
}
注意:这条规则会让所有 404 都返回首页,SEO 上要配合 <meta name="robots"> 或服务端渲染处理。
五、缓存导致的「改了没生效」
三个层级的缓存,挨个排查:
- 浏览器缓存:Ctrl+F5 强刷,或无痕窗口
- Nginx 缓存:静态资源通常设了
expires 30d,改文件名或加版本参数 - CDN 缓存:去 CDN 控制台刷新 URL,别只刷新目录
HTML 文件建议不缓存或短缓存,JS/CSS 用文件名哈希做长缓存 —— 这是最稳的组合。
六、HTTPS 之后的混合内容
站点上了 HTTPS,但页面里的图片、脚本还是 http:// 开头,浏览器会拦截,页面显示不全。
两个办法:
- 全站搜一遍
http://批量替换成https:// - 或者加一行 CSP 指令
upgrade-insecure-requests,让浏览器自动升级
七、上线检查清单
- 首页 200,且内容是最新的
- 随便点三个内页,都能打开
- 强刷新一次,确认不是缓存
- 手机 4G 访问一次,确认外网可达
- 看 Nginx 错误日志尾部有没有报错
tail -50 /www/wwwlogs/你的站点.error.log
静态站的运维成本低,但低不等于没有。把上面七条走一遍,90% 的「打不开」都能当场定位。





















暂无评论内容