查看“Ngx http gzip module”的源代码

该ngx_http_gzip_module模块是使用“gzip”方法压缩响应的过滤器。这通常有助于将传输数据的大小减少一半甚至更多。

示例配置
 gzip            on;
 gzip_min_length 1000;
 gzip_proxied    expired no-cache no-store private auth;
 gzip_types      text/plain application/xml;
该$gzip_ratio变量可用于记录实现的压缩比率。


 句法：gzip 开启 | 关闭;
 
 默认：gzip off;
 
 语境：http，服务器，位置，如果在指定位置

启用或禁用回应的gzip。

 句法：gzip_buffers数字大小;
 
 默认：gzip_buffers 32 4k | 16 8k;
 
 语境：http，服务器，位置

设置number和size用于压缩的响应缓冲区。默认情况下，缓冲区大小等于一个内存页面。这是4K或8K，取决于平台。

在版本0.7.28之前，默认使用4个4K或8K缓冲区。

 句法：gzip_comp_level level;
 
 默认：gzip_comp_level 1;
 
 语境：http，服务器，位置

设置level响应的gzip压缩。可接受的值在1到9的范围内。

句法：
 gzip_disable正则表达式...;
 
 默认：—
 
 语境：http，服务器，位置

禁用具有与任何指定正则表达式匹配的“用户代理”标题字段的请求响应的gzip。

特殊掩码“ msie6”（0.7.12）对应于正则表达式“ MSIE [4-6]\.”，但工作更快。从版本0.8.11开始，“ MSIE 6.0; ... SV1”将从此掩码中排除。

 句法：gzip_min_length长度;
 
 默认：gzip_min_length 20;
 
 语境：http，服务器，位置

设置将被压缩的响应的最小长度。该长度仅由“Content-Length”响应标题字段确定。

 句法：gzip_http_version 1.0 | 1.1;
 
 默认：gzip_http_version 1.1;
 
 语境：http，服务器，位置

设置压缩响应所需的最小HTTP请求版本。

 句法：gzip_proxied off | expired | no-cache | no-store | private | no_last_modified | no_etag | auth | any ...;
 
 默认：gzip_proxied off;
 
 语境：http，服务器，位置

取决于请求和响应，启用或禁用针对代理请求的响应gzip。请求被代理的事实取决于“Via”请求头字段的存在。该指令接受多个参数：

off禁用所有代理请求的压缩，忽略其他参数;

expired如果响应标题包含“Expires”字段并且其值为禁用缓存，则启用压缩;

no-cache如果响应头包含带有“ no-cache”参数的“Cache-Control”字段，则启用压缩;

no-store如果响应头包含带有“ no-store”参数的“Cache-Control”字段，则启用压缩;

private如果响应头包含带有“ private”参数的“Cache-Control”字段，则启用压缩;

no_last_modified如果响应头不包含“Last-Modified”字段，则启用压缩;

no_etag如果响应头不包含“ETag”字段，则启用压缩;auth如果请求标题包含“授权”字段，则启用压缩; any为所有代理请求启用压缩。

 句法：gzip_types mime-type ...;
 
 默认：gzip_types text / html;
 
 语境：http，服务器，位置

除了“ text/html” 之外，还可以针对指定的MIME类型启用gzip的响应。特殊值“ *”匹配任何MIME类型（0.8.29）。“ text/html”类型的响应总是被压缩。

 句法：gzip_vary开启| 关闭;
 
 默认：gzip_vary关闭;
 
 语境：http，服务器，位置


如果指令gzip，gzip_static或gunzip处于活动状态，则启用或禁用插入“Vary：Accept-Encoding”响应标头字段。

嵌入式变量

$gzip_ratio实现压缩比率，计算为原始压缩响应大小与压缩响应大小之间的比率。