在 nginx 中开启 brotli 压缩,需要编译安装带有 brotli 模块的 nginx 版本,并在配置文件中添加 brotli on;、brotli_comp_level 和 brotli_types 等指令。启用后,nginx 会在客户端支持的情况下优先使用 brotli 算法对响应内容进行压缩,从而减小传输体积。

Nginx 如何编译安装 Brotli 模块
要使用 Brotli,必须从源码编译 Nginx 并加载 ngx_brotli 模块。首先获取 Nginx 源码和 Brotli 库,然后使用 --add-module 参数指定模块路径进行配置和编译。这一步是基础,确保二进制文件包含 Brotli 支持。

git clone https://github.com/google/ngx_brotli.git wget http://nginx.org/download/nginx-1.24.0.tar.gz tar -zxvf nginx-1.24.0.tar.gz cd ngx_brotli && git submodule update --init && cd .. cd nginx-1.24.0 ./configure --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --with-http_ssl_module --with-http_v2_module --with-http_gzip_static_module --add-module=../ngx_brotli make sudo make install
上述命令会下载 Nginx 1.24.0 源码和 ngx_brotli 模块,初始化子模块后进入 Nginx 目录。配置时添加了 SSL、HTTP/2 和 Gzip 静态模块,并通过 --add-module 指向 Brotli 模块目录。编译完成后,Nginx 二进制文件将包含 Brotli 功能。
Brotli 模块的具体配置项有哪些
在 Nginx 配置文件中,主要使用 brotli on; 启用压缩,brotli_comp_level 设置压缩级别(1-11),brotli_types 指定需要压缩的 MIME 类型。此外,还可以配置 brotli_static 控制是否查找预压缩文件,以及 brotli_buffers 调整缓冲区大小。

server {
listen 443 ssl;
server_name example.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
brotli on;
brotli_comp_level 6;
brotli_types text/plain application/json text/css application/javascript image/svg+xml;
brotli_static on;
brotli_buffers 16 8k;
location / {
root /var/www/html;
index index.html;
}
}
该配置片段展示了在 HTTPS 服务器块中启用 Brotli 的典型设置。开启 brotli on; 后,设置压缩级别为 6,平衡速度与压缩率。通过 brotli_types 指定文本、JSON、CSS、JS 和 SVG 等类型进行压缩。brotli_static on; 允许 Nginx 先检查是否存在 .br 后缀的预压缩文件,若存在则直接发送,否则动态压缩。最后,brotli_buffers 设置为 16 个 8KB 缓冲区,以应对较大文件的压缩需求。
当请求头 Accept-Encoding 不包含 br 时 Brotli 模块的行为是什么
当客户端的请求头 Accept-Encoding 中不包含 br 标识时,Brotli 模块不会对该请求应用压缩,而是返回原始未压缩的内容。这是 HTTP 协议的标准行为,确保兼容性,只有明确声明支持的客户端才会接收压缩数据。
,











