GZip Static#

Allows sending precompressed files with the “.gz” filename extension instead of regular files.

When building from the source code, this module isn’t built by default; it should be enabled with the ‑‑with‑http_gzip_static_module build option.

In packages and images from our repos, the module is included in the build.

Configuration Example#

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

Directives#

gzip_static#

Syntax

gzip_static on | off | always;

Default

gzip_static off;

Context

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.

With the always, gzipped file is used in all cases, without checking if the client supports it. It is useful if there are no uncompressed files on the disk anyway or the GunZIP is used.

The files can be compressed using the gzip command, or any other compatible one. It is recommended that the modification date and time of original and compressed files be the same.