静态站部署笔记:nginx 的几个小配置
这个博客原来是 WordPress,跑在一台 1GB 内存的小机器上,每次打开都要等两三秒。后来想通了——我根本不需要后台,一年也改不了几篇文章。
于是整个站改成纯静态 HTML,nginx 直接吐文件。这篇记录配置里的几个点。
目录与 try_files 的顺序
root /var/www/blog;
index index.html;
location / {
try_files $uri $uri/index.html $uri.html =404;
}
顺序不能乱。第一项 $uri 处理真实存在的文件;第二项让 /posts/ 这种目录式 URL 找到 index.html;第三项让 /about 找到 about.html。
我一开始只写了 $uri $uri/,结果 /about(不带 .html)一直 404。后来补上 $uri.html 才通。
如果加了$uri/却忘了写index,nginx 会返回目录列表。生产环境千万不要留这个隐患,要么明确写$uri/index.html,要么关掉autoindex。
gzip 只压了 HTML 的坑
默认配置里只有 gzip on;,后面那些 gzip_types 全是注释。也就是 CSS、JS、JSON 都不压缩。
gzip on;
gzip_vary on;
gzip_comp_level 6;
gzip_min_length 256;
gzip_types text/plain text/css text/xml text/javascript
application/json application/javascript
application/xml image/svg+xml;
一个 110KB 的 CSS 压完是 13KB。gzip_vary on 必须加,否则中间缓存可能把压缩版本发给不支持的客户端。
缓存头分两类
带 hash 的资源可以设一年,HTML 不能:
location ~* \.(css|js|woff2|jpg|png|webp|svg)$ {
expires 365d;
add_header Cache-Control "public, immutable";
}
location ~* \.html$ {
add_header Cache-Control "public, max-age=300";
}
HTML 设 5 分钟,改完文章最多等五分钟生效,不用手动清缓存。
如果文件名不带 hash,那 CSS/JS 最好只设 30 天,否则改了用户看不到新样式。
HTTP/2
listen 443 ssl http2;
静态站开 HTTP/2 很划算,几十个小文件能复用一条连接。新版 nginx 提示这个写法要弃用,改成独立的 http2 on;,但老版本还得这么写,看服务器版本。
404 页面要有出路
静态站最容易忽略 404。默认的 nginx 404 页面很硬,用户看到就关掉了。
error_page 404 /404.html;
location = /404.html { internal; }
自己写一个带返回首页链接的 404,成本五分钟,体验差很多。
几个安全头
add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options DENY always;
add_header Referrer-Policy no-referrer always;
静态站本来攻击面就小,但顺手加上没坏处。always 参数别漏,否则 4xx/5xx 响应不带这些头。
改完的收益
| 项目 | WordPress | 静态 |
|---|---|---|
| 内存占用 | 430MB | 约 20MB |
| 首字节 | 200ms | 6ms |
| 后台漏洞 | 要一直升级 | 没有后台 |
| 改文章 | 登录后台写 | 改 HTML 重新上传 |
代价是改内容麻烦一点。对我这种一年写十几篇的人,这个交换很值。
如果你的站有评论、会员、搜索这些动态功能,那就别硬上静态,WordPress 反而合适。
← 返回首页