Nginx压缩与静态缓存:用实际响应验证是否生效

适用:Ubuntu 24.04 LTS上的Nginx静态资源服务,目标是减少公开CSS、JavaScript等文件的传输量。示例不用于登录页、购物车或含个人信息的动态响应。先备份当前站点配置,确认正在使用哪一套Nginx和配置文件;面板管理的站点应在原站点配置中调整。

一、先测一份真实静态文件

从页面真实引用中选一份大于1KB的CSS或JS。确认它返回200、类型正确,而且内容确实来自静态文件,先记录不压缩时的下载量:

curl -sS -H 'Accept-Encoding: identity' \
  -o /dev/null -w 'HTTP=%{http_code} bytes=%{size_download}\n' \
  'https://www.example.com/assets/app.css'

网址换成自己的文件。返回404、403或HTML错误页时,先修好路径和类型,不要拿错误页的字节数当成资源优化结果。

二、只调整对应的静态资源规则

在该站点已有的静态资源location中合并下列设置,不要同时新增多份互相覆盖的CSS/JS规则。下面是静态站点的完整示例片段,root沿用站点实际目录:

location ~* \.(css|js|svg)$ {
    try_files $uri =404;

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

    expires 1h;
}

这里的缓存时间是示例,按发布方式选择。经常覆盖同一个文件名时,不适合一开始就缓存一年;使用内容哈希文件名的构建资源可以另行制定更长周期。JPEG、PNG、ZIP等已经压缩的文件通常不应靠重复gzip处理。

如果相同路径实际需要反向代理、鉴权或应用生成,不能直接用这段try_files覆盖原逻辑。本示例优先处理公开静态文件,动态响应的压缩和缓存需要单独考虑敏感数据及业务行为。

三、检查配置后重载

sudo nginx -t
sudo systemctl reload nginx

只有检查通过才执行重载。实际服务名称或Nginx二进制路径不同,应沿用现有环境的管理方式;不要安装另一套Nginx来解决命令路径问题。重载后检查错误日志及原有页面是否正常。

四、对照响应头和下载量

请求同一份资源,允许gzip并输出响应头:

curl -sS --compressed -D - -o /dev/null \
  -w 'HTTP=%{http_code} bytes=%{size_download}\n' \
  'https://www.example.com/assets/app.css'

检查返回200、Content-Type匹配,并按实际编码查看Content-Encoding。由本次Nginx规则压缩时通常为gzip;Vary应包含Accept-Encoding。再比较相同内容在identity与压缩请求下的下载字节数。

查看缓存相关响应头,确认Cache-Control及过期时间与配置一致。在浏览器“网络”中首次加载时停用缓存验证网络响应,再恢复缓存重复访问,检查是否命中缓存或条件请求。一直勾着停用缓存,不能用来证明浏览器缓存失效。

五、遇到没变化,先检查哪一层响应

文件太小、类型不匹配、请求未声明接受压缩,都会影响结果。前面接了代理或加速服务时,实际返回可能由该层处理;比较响应头和源站配置,不能只重复改Nginx参数。文件更新后出现旧内容时,检查实际资源URL与缓存,不要直接对全站加上最长缓存。

确认首页、内页和主要功能没有变化后,记录配置及测试资源。出问题时恢复本次站点配置备份,检查通过后重载。

相关教程:缓存旧内容排查、JS/CSS类型错误、Nginx配置未生效。