gzip

gzip

Summary

Name
Attributes
How To Enable
Test Plugin
Disable Plugin

Name

The gzip plugin dynamically set the gzip behavior of Nginx.

This plugin requires APISIX to run on APISIX-OpenResty.

Attributes

Name	Type	Requirement	Default	Valid	Description
types	array[string] or ““	optional	[“text/html”]		dynamically set the `gzip_types` directive, special value `““` matches any MIME type
min_length	integer	optional	20	>= 1	dynamically set the `gzip_min_length` directive
comp_level	integer	optional	1	[1, 9]	dynamically set the `gzip_comp_level` directive
http_version	number	optional	1.1	1.1, 1.0	dynamically set the `gzip_http_version` directive
buffers.number	integer	optional	32	>= 1	dynamically set the `gzip_buffers` directive
buffers.size	integer	optional	4096	>= 1	dynamically set the `gzip_buffers` directive
vary	boolean	optional	false		dynamically set the `gzip_vary` directive

How To Enable

Here’s an example, enable this plugin on the specified route:

curl -i http://127.0.0.1:9080/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '{    "uri": "/index.html",    "plugins": {        "gzip": {            "buffers": {                "number": 8            }        }    },    "upstream": {        "type": "roundrobin",        "nodes": {            "127.0.0.1:1980": 1        }    }}'

Test Plugin

Use curl to access:

curl http://127.0.0.1:9080/index.html -i -H "Accept-Encoding: gzip"HTTP/1.1 404 Not FoundContent-Type: text/html; charset=utf-8Transfer-Encoding: chunkedConnection: keep-aliveDate: Wed, 21 Jul 2021 03:52:55 GMTServer: APISIX/2.7Content-Encoding: gzip
Warning: Binary output can mess up your terminal. Use "--output -" to tellWarning: curl to output it to your terminal anyway, or consider "--outputWarning: <FILE>" to save to a file.

Disable Plugin

When you want to disable this plugin, it is very simple, you can delete the corresponding JSON configuration in the plugin configuration, no need to restart the service, it will take effect immediately:

curl http://127.0.0.1:9080/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '{    "uri": "/index.html",    "upstream": {        "type": "roundrobin",        "nodes": {            "127.0.0.1:1980": 1        }    }}'

This plugin has been disabled now. It works for other plugins.