# ngx\_http\_gzip\_static\_module

* [示例配置](#example_configuration)
* [指令](#directives)
  * [gzip\_static](#gzip_static)

`ngx_http_gzip_static_module` 模块允许发送以 **.gz** 结尾的预压缩文件替代普通文件。 该模块默认不会被构建到 nginx 中，需要在编译时加入 `--with-http_gzip_static_module` 配置参数启用。

## 配置示例 <a href="#example_configuration" id="example_configuration"></a>

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

## 指令 <a href="#directives" id="directives"></a>

### gzip\_static

| -       | 说明                                          |
| ------- | ------------------------------------------- |
| **语法**  | **gzip\_static** `on` \| `off` \| `always`; |
| **默认**  | gzip\_static off;                           |
| **上下文** | http、server、location                        |

开启(**on**)或禁用(**off**)会检查预压缩文件是否存在。下列指令也会被影响到 [gzip\_http\_verson](https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/ngx_http_gzip_module#gzip_http_version)， [gzip\_proxied](https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/ngx_http_gzip_module#gzip_proxied)， [gzip\_disable](https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/ngx_http_gzip_module#gzip_disable)， [gzip\_vary](https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/ngx_http_gzip_module#gzip_vary)。

值为 **always** (1.3.6)，在所有情况下都会使用压缩文件，不检查客户端是否支持。如果磁盘上没有未被压缩的文件或者 [ngx\_http\_gunzip\_module](https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/http/ngx_http_gunzip_module) 模块被启用，这个参数非常有用。

文件可以使用`gzip`命令，或者任何兼容文件进行压缩。建议压缩文件和源文件的修改日期和时间保持一致。