最新下载
热门教程
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
Nginx 中 Gzip 压缩如何设置 gzip_types 指定需要压缩的 MIME 类型
时间:2026-08-27 11:35:49 编辑:袖梨 来源:一聚教程网
Nginx gzip_types需显式列出MIME类型,覆盖默认仅压缩text/html的行为;必选text/html等基础类型,禁用通配符和已压缩二进制格式;须配合gzip on等指令,并确保mime.types映射正确、响应头Content-Type匹配。
直接在 http、server 或 location 块中写明要压缩的 MIME 类型即可。Nginx 不看文件后缀(比如 .js 或 .css),只认响应头里的 Content-Type——配置写对了但没生效,大概率是类型没匹配上,或者根本没启用压缩。
必须显式列出所有要压缩的类型
gzip_types 是覆盖式配置:一旦设置,就会完全替代 Nginx 默认仅压缩 text/html 的行为。漏掉 text/html,整个 HTML 页面就失去压缩,首屏加载明显变慢。
- 基础必选(建议直接复制):
text/html text/plain text/css text/javascript application/javascript application/json application/xml text/xml application/xml+rss image/svg+xml - 现代前端可加:
text/markdown application/typescript application/font-woff2(注意 woff2 压缩需浏览器支持,且非所有场景都推荐) - 绝对不要写
text/*或application/*——Nginx 直接忽略,配置无效
避开已压缩的二进制格式
JPEG、PNG、GIF、MP4、AVIF、ZIP、PDF、WOFF2 等本身已是高压缩编码,再套 Gzip 几乎不省带宽,反而增加 CPU 开销和传输延迟,甚至可能让体积略微变大。
- 明确排除:
image/jpeg image/png image/gif video/mp4 application/zip application/pdf - SVG 是例外:
image/svg+xml是纯文本 XML,必须且应当压缩 - 警惕
application/octet-stream:这是“兜底类型”,常代表未识别资源(如 .md、.log),误加进去会连带压缩图片或 PDF
确保 MIME 类型与文件真实映射一致
你在 gzip_types 里写了 text/markdown,但如果 .md 文件返回的是 application/octet-stream(说明 Nginx 没识别出类型),那也不会压缩。
- 先检查
/etc/nginx/mime.types(Linux)或/usr/local/etc/nginx/mime.types(macOS) - 补充缺失映射,例如:
types { text/markdown md; application/typescript ts; } - 再在
gzip_types中加入对应项,名称必须完全一致(区分大小写)
配合必要指令并实测验证
gzip_types 单独存在是无效的,必须和以下指令共存才能起作用:
-
gzip on;——启用压缩功能 -
gzip_min_length 1024;——避免压缩过小响应(如空 JSON) -
gzip_comp_level 6;——平衡压缩率与 CPU 消耗(1–9,6 是常用值) -
gzip_vary on;——让缓存系统知道响应可能被压缩
改完配置后,用 curl 实测是否真生效:
curl -I -H "Accept-Encoding: gzip" https://yoursite.com/main.js
确认响应头含 Content-Encoding: gzip 和 Vary: Accept-Encoding,同时核对 Content-Type: application/javascript 是否匹配你配置的类型。