<!-- review: finished -->

<a id="http-gzip-static"></a>

# GZip Static

允许发送带有".gz"文件扩展名的预压缩文件，而不是常规文件。

当从源码 [构建](https://cn.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) 时，该模块默认未构建；它应通过 `‑‑with‑http_gzip_static_module` [构建选项](https://cn.angie.software//angie/docs/installation/sourcebuild.md#configure) 启用。

在从 [我们的仓库](https://cn.angie.software//angie/docs/installation/index.md#install-packages) 中的包和镜像中，该模块已包含在构建中。

<a id="configuration-example-21"></a>

## 配置示例

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

<a id="directives-22"></a>

## 指令

<a id="index-0"></a>

<a id="id3"></a>

### gzip_static

| [语法](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)   | `gzip_static` `on` | `off` | `always`;   |
|--------------------------------------------------------------------------------------|------------------------------------------|
| 默认值                                                                                  | `gzip_static off;`                       |
| [上下文](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)  | http, server, location                   |

启用 (`on`) 或禁用 (`off`) 检查预压缩文件的存在。以下指令也会被考虑：[gzip_http_version](https://cn.angie.software//angie/docs/configuration/modules/http/http_gzip.md#gzip-http-version)、[gzip_proxied](https://cn.angie.software//angie/docs/configuration/modules/http/http_gzip.md#gzip-proxied)、[gzip_disable](https://cn.angie.software//angie/docs/configuration/modules/http/http_gzip.md#gzip-disable) 和 [gzip_vary](https://cn.angie.software//angie/docs/configuration/modules/http/http_gzip.md#gzip-vary)。

使用 `always` 时，压缩文件在所有情况下都会被使用，而无需检查客户端是否支持。这在磁盘上没有未压缩文件或者使用了 [GunZIP](https://cn.angie.software//angie/docs/configuration/modules/http/http_gunzip.md#http-gunzip) 模块时很有用。

文件可以通过 gzip 命令或任何其他兼容命令进行压缩。建议原始文件和压缩文件的修改日期和时间相同。
