模块 ngx_http_gzip_module

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

在使用 SSL/TLS 协议时，压缩的响应可能会受到 BREACH 攻击。

gzip            on;
gzip_min_length 1000;
gzip_proxied    expired no-cache no-store private auth;
gzip_types      text/plain application/xml;

$gzip_ratio 变量可用于记录达到的压缩比率。

gzip off;

启用或禁用响应的 gzip 压缩。

gzip_buffers 32 4k|16 8k;

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

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

gzip_comp_level 1;

设置响应的 gzip 压缩 level。可接受的值在 1 到 9 之间。

对于“User-Agent”标头字段与任何指定正则表达式匹配的请求，禁用响应的 gzip 压缩。

特殊掩码“msie6”（0.7.12）对应于正则表达式“MSIE [4-6]\.”，但运行速度更快。从 0.8.11 版本开始，“MSIE 6.0; ... SV1”被排除在此掩码之外。

gzip_http_version 1.1;

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

gzip_min_length 20;

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

gzip_proxied off;

根据请求和响应，启用或禁用对代理请求的响应进行 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

如果请求头包含“Authorization”字段，则启用压缩；

any

对所有代理请求启用压缩。

gzip_types text/html;

除了“text/html”之外，启用对指定 MIME 类型的响应进行 Gzip 压缩。特殊值“*”匹配任何 MIME 类型 (0.8.29)。类型为“text/html”的响应始终被压缩。

gzip_vary off;

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

$gzip_ratio

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