分类： nginx

nginx中文文档-ngx_http_gzip_static_module

ngx_http_gzip_static_module模块允许发送文件扩展名为“.gz”的预压缩文件。

该模块默认不会构建，需要通过–with-http_gzip_static_module参数启用。

示例配置

gzip_static  on;
gzip_proxied expired no-cache no-store private auth;

gzip_static

语法：gzip_static on | off | always
默认：gzip_static off
上下文：http, server, location

启用或禁用检查预压缩文件功能。下面的指令也会被考虑：gzip_http_version、gzip_proxied、gzip_disable以及gzip_vary。
“always”值（1.3.6+），不检查客户端是否支持，直接使用gzip文件。当在磁盘上没有未压缩的文件或使用了ngx_http_gunzip_module模块时很有效。
文件可以通过gzip命令压缩，或使用其他的命令。建议原始文件和压缩文件的修改时间保持一致。

nginx中文文档-ngx_http_gzip_module

此页面版本：2016-06-08
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 on | off
默认：gzip off
上下文：http, server, location, if in location

启用或禁用gzip压缩功能。

gzip_buffers

语法：gzip_buffers number size
默认：gzip_buffers 32 4k|16 8k
上下文：http, server, location

设置用于压缩响应的缓冲区大小和数量。默认情况下，缓冲区大小为一页内存。4k或8k取决于平台。
直到0.7.28版本之前，默认是4个4k或8k的缓冲区。

gzip_comp_level

语法：gzip_comp_level level
默认：gzip_comp_level 1
上下文：http, server, location

设置响应的gzip压缩等级，可以是1~9.

gzip_disable

语法：gzip_disable regex …
默认：—
上下文：http, server, location
版本：0.6.23+

为指定正则表达式匹配的“User-Agent”发来的请求，关闭gzip功能。
特殊的标记“msie6”（0.7.12+）相当于正则表达式“MSIE [4-6]\.”，但速度更快。从0.8.11版本起，“MSIE 6.0; … SV1”不再包含于此标记中。

gzip_min_length

语法：gzip_min_length length
默认：gzip_min_length 20
上下文：http, server, location

设置需要gzip压缩的响应的最小长度。长度只决定“Content-Length”响应头。

gzip_http_version

语法：gzip_http_version 1.0 | 1.1
默认：gzip_http_version 1.1
上下文：http, server, location

设置需要压缩的响应的最小HTTP版本。

gzip_proxied

语法：gzip_proxied off | expired | no-cache | no-store | private | no_last_modified | no_etag | auth | any …
默认：gzip_proxied off
上下文：http, server, location

根据请求和响应为代理请求启用或禁用gzip功能。实际上判断代理请求根据请求头中的“Via”字段。指令接受多个参数：
off
禁用所有的代理请求的压缩，忽略其他参数。

expired
如果响应头包含“Expires”字段，且值是禁用缓存，则启用压缩。

no-cache
如果响应头包含“Cache-Control”且值为“no-cache”，则启用压缩。

no-store
如果响应头包含“Cache-Control”且值为“no-store”，则启用压缩。

private
如果响应头包含“Cache-Control”且值为“private”，则启用压缩。

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

no_etag
如果响应头不包含“ETag”字段，启用压缩。

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

any
为所有代理请求启用压缩。

gzip_types

语法：gzip_types mime-type …
默认：gzip_types text/html
上下文：http, server, location

为“text/html”类型之外的指定MIME类型的响应启用压缩。特殊值“*”匹配任何MIME类型（0.8.29+）。“text/html”类型的响应总是会被压缩。

gzip_vary

语法：gzip_vary on | off
默认：gzip_vary off
上下文：http, server, location

当gzip、gzip_static或gunzip启用时，启用或禁用添加头域“Vary: Accept-Encoding”到响应头中的功能。

内嵌变量

$gzip_ratio
最终压缩比，计算原响应与压缩后的响应大小的比率。