Nginx 中 Gzip 压缩如何设置 gzip_types 指定需要压缩的 MIME 类型

作者：袖梨 2026-08-27

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 页面就失去压缩，首屏加载明显变慢。

  1. 基础必选（建议直接复制）：text/html text/plain text/css text/javascript application/javascript application/json application/xml text/xml application/xml+rss image/svg+xml
  2. 现代前端可加：text/markdown application/typescript application/font-woff2（注意 woff2 压缩需浏览器支持，且非所有场景都推荐）
  3. 绝对不要写 text/* 或 application/*——Nginx 直接忽略，配置无效

避开已压缩的二进制格式

JPEG、PNG、GIF、MP4、AVIF、ZIP、PDF、WOFF2 等本身已是高压缩编码，再套 Gzip 几乎不省带宽，反而增加 CPU 开销和传输延迟，甚至可能让体积略微变大。

  1. 明确排除：image/jpeg image/png image/gif video/mp4 application/zip application/pdf
  2. SVG 是例外：image/svg+xml 是纯文本 XML，必须且应当压缩
  3. 警惕 application/octet-stream：这是“兜底类型”，常代表未识别资源（如 .md、.log），误加进去会连带压缩图片或 PDF

确保 MIME 类型与文件真实映射一致

你在 gzip_types 里写了 text/markdown，但如果 .md 文件返回的是 application/octet-stream（说明 Nginx 没识别出类型），那也不会压缩。

  1. 先检查 /etc/nginx/mime.types（Linux）或 /usr/local/etc/nginx/mime.types（macOS）
  2. 补充缺失映射，例如：
    types { text/markdown md; application/typescript ts; }
  3. 再在 gzip_types 中加入对应项，名称必须完全一致（区分大小写）

配合必要指令并实测验证

gzip_types 单独存在是无效的，必须和以下指令共存才能起作用：

  1. gzip on;——启用压缩功能
  2. gzip_min_length 1024;——避免压缩过小响应（如空 JSON）
  3. gzip_comp_level 6;——平衡压缩率与 CPU 消耗（1–9，6 是常用值）
  4. 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 是否匹配你配置的类型。

相关文章

精彩推荐