完整配置
先看结果,再逐条解释:
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 页, 至少能让走错路的访客知道"这里还是那个网站"。
改完怎么验证
三步,缺一不可:
nginx -t—— 语法检查,错了会直接告诉你第几行;systemctl reload nginx—— 让配置生效(改了上游服务记得用 restart);- 用
curl -I看响应头,确认缓存和状态码真的按预期返回。
curl -I http://你的域名/css/style.css
# 期望看到:HTTP/1.1 200 OK
# Cache-Control: public, immutable
# Expires: ...(30 天后)
小结
这些配置没有一条是"必须"的——不写,网站照样能打开。 但它们决定了这个网站是一个"能用的网站",还是一个"用起来舒服的网站"。 我的原则是:凡是能一次性配好、以后不用再管的事情,就现在做掉。