静态站上线前,我的 Nginx 配置清单

一个能打开网站的配置,和一个「跑得好」的配置,中间隔着七八个细节。 这篇把我自己的 server 块拆开讲,每一条都说明为什么加。

完整配置

先看结果,再逐条解释:

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;

    root /var/www/blog;
    index index.html;
    charset utf-8;
    client_max_body_size 64m;

    location ~* \.(css|js|jpg|jpeg|png|gif|webp|svg|ico|woff2?|ttf)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
        access_log off;
    }

    location / {
        try_files $uri $uri/ $uri.html =404;
    }

    error_page 404 /404.html;

    location ~ /\. { deny all; }
}

① try_files:让 /about 也能打开 about.html

try_files $uri $uri/ $uri.html =404; 的意思是依次尝试: 原路径的文件、原路径的目录、 路径加上 .html 后缀,全都没有才返回 404。

有了它,访问 /about 和 /about.html 效果一样, 网址看起来更干净。最后那个 =404 一定要写—— 不写的话 Nginx 默认会返回状态码 200,搜索引擎会把这些不存在的页面都当成正常页收录。

② 静态资源长缓存:让回头客几乎零加载

CSS、JS、图片这些文件内容不会变,完全可以让浏览器缓存 30 天:

expires 30d;
add_header Cache-Control "public, immutable";

第二次访问时浏览器直接读本地缓存,连请求都不发。 immutable 是告诉浏览器"这 30 天里它绝对不会变,别来问了"。

反过来说:HTML 不要设置长缓存,否则你更新了文章,访客看到的还是旧页面。 所以我的缓存规则只匹配具体的扩展名,不碰 .html。

③ gzip:文本能压掉七成体积

我的 HTML 大概 10KB,压缩后 3KB 左右。这行通常写在 nginx.conf 的 http 块里:

gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/javascript application/json image/svg+xml;

gzip_min_length 1024 是别压缩太小的文件——压完可能反而更大,还多耗 CPU。

④ client_max_body_size:以后传图不会莫名 413

Nginx 默认只允许 1MB 的请求体。哪天你想在页面上放张高清图, 上传时就会收到 413 Request Entity Too Large。提前调到 64MB 省得以后排查。

⑤ 隐藏文件拦截

location ~ /\. { deny all; }

防止别人直接访问 /.git/config、/.env 这类文件。 静态站的根目录下如果放了 Git 仓库,这条规则能挡住最常见的一种信息泄露。

⑥ 自己的 404 页面

error_page 404 /404.html;

默认的 404 页面很丑,而且没有任何引导。做一个和站点风格一致的 404 页, 至少能让走错路的访客知道"这里还是那个网站"。

改完怎么验证

三步,缺一不可:

  1. nginx -t —— 语法检查,错了会直接告诉你第几行;
  2. systemctl reload nginx —— 让配置生效(改了上游服务记得用 restart);
  3. 用 curl -I 看响应头,确认缓存和状态码真的按预期返回。
curl -I http://你的域名/css/style.css
# 期望看到:HTTP/1.1 200 OK
#           Cache-Control: public, immutable
#           Expires: ...(30 天后)

小结

这些配置没有一条是"必须"的——不写,网站照样能打开。 但它们决定了这个网站是一个"能用的网站",还是一个"用起来舒服的网站"。 我的原则是:凡是能一次性配好、以后不用再管的事情,就现在做掉。

← 上一篇:28 倍的提速 返回技术分享 →