# Brotli 这是一组两个模块: - `ngx_brotli_filter` — 用于即时压缩响应。 - `ngx_brotli_static` — 用于提供预压缩文件。 ## 安装 要 [安装](https://cn.angie.software//angie/docs/installation/index.md#install-packages) 该模块,请使用以下软件包之一: - Angie:`angie-module-brotli` - Angie PRO:`angie-pro-module-brotli` ## 加载模块 在 `main{}` 上下文中加载模块: ```nginx load_module modules/ngx_http_brotli_filter_module.so; load_module modules/ngx_http_brotli_static_module.so; ``` ## 动态压缩的配置示例 ```nginx server { listen 80 default_server; brotli on; brotli_comp_level 1; brotli_types text/plain text/css; location / { root /usr/share/angie/html; index index.html; } } ``` ## 演示准备 首先,让我们放置测试文件 `war-and-peace.txt`: ```console $ ls -l /usr/share/angie/html/ total 3292 -rw-r--r-- 1 root root 497 Feb 13 07:40 50x.html -rw-r--r-- 1 root root 543 Feb 13 07:40 index.html -rw-r--r-- 1 root root 3359405 Feb 26 12:47 war-and-peace.txt ``` ```console $ mkdir tmp ``` 请求压缩文件: ```console $ curl -s -H 'Accept-encoding: br' -o tmp/war-and-peace.br localhost/war-and-peace.txt ``` ```console $ ls -l tmp/ total 1092 -rw-r--r-- 1 asv asv 1115616 Feb 26 16:52 war-and-peace.br ``` ## 提供预压缩文件的配置示例 ```nginx server { listen 80 default_server; brotli_static on; brotli_types text/plain text/css; location / { root /usr/share/angie/html; index index.html; } } ``` ## 移动预压缩文件 ```console $ sudo mv tmp/war-and-peace.br /usr/share/angie/html/war-and-peace.txt.br $ ls -l /usr/share/angie/html/ total 4384 -rw-r--r-- 1 root root 497 Feb 13 07:40 50x.html -rw-r--r-- 1 root root 543 Feb 13 07:40 index.html -rw-r--r-- 1 root root 3359405 Feb 26 12:47 war-and-peace.txt -rw-r--r-- 1 root root 1115616 Feb 26 16:57 war-and-peace.txt.br ``` 请求压缩文件: ```console $ curl -s -H 'Accept-encoding: br' -o tmp/war-and-peace.br localhost/war-and-peace.txt ``` ```console $ ls -l tmp/ total 1092 -rw-r--r-- 1 asv asv 1115616 Feb 26 17:13 war-and-peace.br ``` ## 组合动态和静态压缩 在一个配置中,可以组合使用动态压缩(`brotli on`)和静态选择(`brotli_static on`)。在这种情况下,系统将首先查找相应的静态压缩文件。如果找不到这样的文件,将对请求中指定的文件进行动态压缩。 ## 附加信息 指令的完整文档和源代码可在以下位置获取: [https://github.com/google/ngx_brotli](https://github.com/google/ngx_brotli)。