nginx gzip配置参数解读

序

本文主要解析一下nginx ngx_http_gzip_module以及ngx_http_gzip_static_module中的gzip相关配置参数。

gzip

名称	默认配置	作用域	官方说明	中文解读	模块
gzip	gzip off;	http, server, location, if in location	Enables or disables gzipping of responses.	设置是否开启对后端响应的gzip压缩，然后返回压缩内容给前端	ngx_http_gzip_module
gzip_buffers	gzip_buffers 32 4k或16 8k;	http, server, location	Sets the number and size of buffers used to compress a response. By default, the buffer size is equal to one memory page. This is either 4K or 8K, depending on a platform.	设置用于压缩后端response的buffer的数量和每个的大小，默认每个buffer大小为一个内存页，根据平台不同可能是4k或8k	ngx_http_gzip_module
gzip_comp_level	gzip_comp_level 1;	http, server, location	Sets a gzip compression level of a response. Acceptable values are in the range from 1 to 9.	指定gzip压缩的级别，默认为1，该值可设置的范围是1-9，1为最小化压缩(处理速度快),9为最大化压缩(处理速度慢)，数字越大压缩的越好，也越占用CPU时间	ngx_http_gzip_module
gzip_disable	没有默认值	http, server, location	Disables gzipping of responses for requests with User-Agent header fields matching any of the specified regular expressions.	正则匹配User-Agent中的值，匹配上则不进行gzip	ngx_http_gzip_module
gzip_min_length	gzip_min_length 20;	http, server, location	Sets the minimum length of a response that will be gzipped. The length is determined only from the Content-Length response header field.	设定进行gzip压缩的阈值，当后端response的Content-Length大小小于该值则不进行gzip压缩	ngx_http_gzip_module
gzip_http_version	gzip_http_version 1.1;	http, server, location	Sets the minimum HTTP version of a request required to compress a response.	设定进行gzip压缩的最小http版本	ngx_http_gzip_module
gzip_proxied	gzip_proxied off;	http, server, location	Enables or disables gzipping of responses for proxied requests depending on the request and response. The fact that the request is proxied is determined by the presence of the "Via" request header field.	根据request或响应的相关header的值来决定是否进行gzip	ngx_http_gzip_module
gzip_types	gzip_types text/html;	http, server, location	Enables gzipping of responses for the specified MIME types in addition to "text/html". The special value "*" matches any MIME type (0.8.29). Responses with the "text/html" type are always compressed.	指定哪些mime types启用gzip压缩，默认text/html	ngx_http_gzip_module
gzip_vary	gzip_vary off;	http, server, location	Enables or disables inserting the "Vary: Accept-Encoding" response header field if the directives gzip, gzip_static, or gunzip are active.	是否往response header里头写入Vary: Accept-Encoding	ngx_http_gzip_module
gzip_static	gzip_static off;	http, server, location	Enables ("on") or disables ("off") checking the existence of precompressed files. The following directives are also taken into account: gzip_http_version, gzip_proxied, gzip_disable, and gzip_vary.	开启之后，接到(静态文件)请求会到url相同的路径的文件系统去找扩展名为".gz"的文件，如果存在直接把它发送出去，如果不存在，则进行gzip压缩，再发送出去	ngx_http_gzip_static_module

实例

http {
    gzip on;
    gzip_buffers 8 16k; ## 这个限制了nginx不能压缩大于128k的文件
    gzip_comp_level 2;
    gzip_disable "MSIE [1-6]\.(?!.*SV1)";
    gzip_min_length 512; ##单位byte
    gzip_http_version 1.0;
    gzip_proxied expired no-cache no-store private auth;
    gzip_types   text/plain application/x-javascript text/css application/xml;
    gzip_vary on;
    gzip_static  on;
    //......
}

doc

• nngx_http_gzip_module
• 加速nginx: 开启gzip和缓存
• mozilla Vary
• HTTP 协议中 Vary 的一些研究
• Nginx中gzip_static模块的使用