Nginx 1.24 默认内置 ngx_http_gzip_module,无需编译加载,只需在 http 块中配置 gzip on 等指令即可启用;验证用 nginx -V | grep with-http_gzip_module,推荐配置包括 gzip_min_length 1024、gzip_comp_level 6 和 gzip_types 文本类型列表。

确认 gzip 模块可用
运行以下命令验证模块是否存在:
nginx -V 2>&1 | grep -o with-http_gzip_module
若输出 with-http_gzip_module,说明支持正常。Nginx 1.24 全版本默认包含该模块。
推荐的全局 gzip 配置(写在 http 块内)
这是最常用、最稳妥的方式,适用于所有站点。编辑 /etc/nginx/nginx.conf,在 http { ... } 区域中添加:
- gzip on; —— 必须开启,否则其他参数无效
- gzip_http_version 1.1; —— 兼容现代客户端,避免 HTTP/1.0 下的潜在问题
- gzip_min_length 1024; —— 小于 1KB 的响应不压缩(如 tiny JSON、空 HTML),防止越压越大
- gzip_comp_level 6; —— 平衡 CPU 开销与压缩率,1.24 版本实测 6 是最优值
- gzip_buffers 16 8k; —— 匹配多数系统内存页大小,避免缓冲区不足告警
-
gzip_types 列出常用文本类型,建议包含:
text/plain text/css application/javascript application/json text/xml application/xml application/xml+rss text/javascript image/svg+xml
注意:text/html不必显式写出,它始终被压缩 - gzip_vary on; —— 让 CDN 和代理缓存区分压缩/未压缩版本,避免错发
按需禁用或微调的场景
某些情况需要针对性处理,避免副作用:
- 对已压缩资源(如
.jpg、.png、.woff2)不加 gzip:不用额外配置,因为gzip_types中未包含它们,Nginx 自动跳过 - 老旧客户端兼容(如 IE6):gzip_disable "MSIE [1-6]\."; (可选,当前基本可省略)
- 反向代理后端返回的内容需压缩:gzip_proxied any;(若上游不带
Via头,需设为any才生效) - 想进一步降 CPU 开销:把
gzip_comp_level改为 4 或 5,压缩率略低但更轻量
验证是否生效
配置保存后,务必执行两步:
sudo nginx -t —— 检查语法
sudo nginx -s reload —— 平滑重载(不中断请求)
然后用 curl 测试:
curl -H "Accept-Encoding: gzip" -I https://yoursite.com/style.css
若响应头中出现:
Content-Encoding: gzip
Vary: Accept-Encoding
说明配置成功。
也可在浏览器开发者工具的 Network 标签页中查看任意 JS/CSS 请求的响应头。


















