我的数字人生

静态站部署笔记:nginx 的几个小配置

2026 年 9 月 8 日 · 约 6 分钟读完

这个博客原来是 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
首字节200ms6ms
后台漏洞要一直升级没有后台
改文章登录后台写改 HTML 重新上传

代价是改内容麻烦一点。对我这种一年写十几篇的人,这个交换很值。

如果你的站有评论、会员、搜索这些动态功能,那就别硬上静态,WordPress 反而合适。

← 返回首页