Nginx-ngx_http_gunzip_module

一、引言：当"压缩"遇上"不兼容"

在现代 Web 开发中，Gzip 压缩几乎是标配。它能将文本资源体积减少 60%-80%，极大地提升了网站性能和用户体验。然而，在这个日新月异的互联网世界里，依然存在着一些不支持 Gzip 解压的"老古董"客户端，比如：

一些非常陈旧的浏览器（如 IE6 及更早版本）。
某些定制化的嵌入式设备或 IoT 设备。
部分爬虫或自动化脚本。

对于这些客户端，如果我们直接返回 Gzip 压缩后的内容，它们会将其视为乱码，导致功能完全失效。

那么，我们是否要为了这少数的"老古董"而放弃 Gzip 带来的巨大收益呢？答案是否定的！

Nginx 的 ngx_http_gunzip_module 模块正是为此而生。它像一位智能的"翻译官"，能够自动识别不支持 Gzip 的客户端，并实时将已压缩的内容解压后返回，完美解决了兼容性问题。

💡 核心价值 ：

ngx_http_gunzip_module 让你无需在磁盘上同时存储压缩和未压缩两份文件，就能兼顾性能与兼容性，实现"一套存储，两种服务"！

二、模块定位与工作原理

1. 它是什么？

ngx_http_gunzip_module 是一个 HTTP 过滤器模块。它的主要职责是：

检测客户端是否支持 Gzip（通过检查 Accept-Encoding 请求头）。
如果客户端不支持 ，但 Nginx 获取到的上游响应（或本地文件）已经是 Gzip 压缩格式 （即带有 Content-Encoding: gzip 响应头），那么该模块会在内存中实时解压这份内容。
最终，向客户端返回解压后的明文内容 ，并移除 Content-Encoding 响应头。

2. 典型应用场景

想象这样一个高效且节省成本的架构：

后端/静态文件服务器 ：只存储 Gzip 压缩后的 .gz 文件。这可以显著节省磁盘空间（尤其是对于大型 JS/CSS 库）并降低 I/O 压力。
Nginx ：
- 对于现代浏览器 （支持 Gzip）：直接返回 .gz 文件，并加上 Content-Encoding: gzip 头。
- 对于老旧客户端 （不支持 Gzip）：通过 gunzip 模块，读取 .gz 文件，在内存中解压，然后将原始明文内容返回。

这样，我们只需维护一份压缩文件，就能服务所有类型的客户端。

三、核心配置指令详解

该模块提供了两个主要指令：

1. `gunzip`

作用：开启或关闭 gunzip 功能。
语法：gunzip on | off;
默认值 ：off
上下文 ：http, server, location

2. `gunzip_buffers`

作用：设置用于解压响应的缓冲区数量和大小。
语法：gunzip_buffers number size;
默认值 ：32 4k|16 8k (取决于平台)
上下文 ：http, server, location
说明：通常使用默认值即可，除非处理非常大的压缩文件。

四、实战配置示例

场景一：配合 `gzip_static` 使用（最常见）

这是 gunzip 模块最经典的应用。gzip_static 模块负责查找并返回磁盘上的 .gz 文件，而 gunzip 模块则负责为不支持的客户端解压。

复制代码

server {
    listen 80;
    server_name example.com;
    root /var/www/html;

    location ~ \.css$ {
        # 1. 启用 gzip_static: 如果请求 style.css, 且存在 style.css.gz, 则直接返回 .gz 文件
        gzip_static on;
        
        # 2. 启用 gunzip: 如果客户端不支持gzip，则对返回的 .gz 文件进行解压
        gunzip on;
        
        # 3. 设置正确的 MIME 类型
        add_header Content-Type text/css;
    }

    location ~ \.js$ {
        gzip_static on;
        gunzip on;
        add_header Content-Type application/javascript;
    }
}

工作流程：

现代浏览器 请求 app.js → Nginx 找到 app.js.gz → 直接返回，并附带 Content-Encoding: gzip。
老式浏览器 请求 app.js → Nginx 找到 app.js.gz → gunzip 模块介入 → 在内存中解压 app.js.gz → 返回原始的 app.js 内容，不带 Content-Encoding 头。

场景二：处理来自上游的 Gzip 响应

有时，你的上游应用服务器（如 Tomcat, Node.js）可能已经对响应进行了 Gzip 压缩。如果你希望 Nginx 能为不支持 Gzip 的客户端解压这些响应，也可以使用 gunzip。