Nginx 中 Brotli 压缩如何编译安装第三方模块实现更高效的数据压缩

Nginx启用Brotli需源码编译集成ngx_brotli模块并依赖libbrotli库，配置brotli on等指令后生效；其压缩率比Gzip高15%–20%，尤其适用于HTML/CSS/JS，须验证nginx -V含模块且响应头返回Content-Encoding: br。

Brotli 压缩在 Nginx 中无法通过包管理器直接启用，必须通过源码编译集成最新 ngx_brotli 模块，并依赖底层 libbrotli 库。它比 Gzip 平均多压缩 15%–20%，尤其对 HTML、CSS、JS 等文本资源效果显著，但需注意：模块不兼容动态加载（除非显式加 --with-compat），且配置必须手动写入 nginx.conf 才生效。

准备系统依赖和基础工具

确保编译环境完整，否则后续步骤会失败：

1. CentOS/RHEL：运行 yum groupinstall "Development Tools"，再安装 openssl-devel pcre-devel zlib-devel git autoconf automake libtool
2. Ubuntu/Debian：执行 apt-get install build-essential libssl-dev libpcre3-dev zlib1g-dev git autoconf automake libtool
3. 宝塔用户额外确认 /www/server/nginx/src 目录存在，这是重编译的起点

编译安装 libbrotli 核心库

该库提供编码/解码能力，Nginx 编译时需链接其头文件和动态库，路径默认为 /usr/local：

1. 克隆源码：git clone https://github.com/google/brotli.git && cd brotli
2. 推荐使用 autotools 方式构建（兼容性更稳）：./bootstrap && ./configure --prefix=/usr/local && make && sudo make install
3. 安装后立即执行 sudo ldconfig 刷新动态库缓存，确保 libbrotlidec.so 和 libbrotlienc.so 可被识别

获取并集成 ngx_brotli 模块到 Nginx

模块本身不带编译逻辑，必须嵌入 Nginx 源码编译流程。两种主流路径：

1. 宝塔用户优先用软件商店编译安装：卸载当前 Nginx → 进【软件商店】→【运行环境】→ 选 Nginx → 【编译安装】→ 勾选【自定义模块】→ 输入 --add-module=/www/server/ngx_brotli → 提交。宝塔会自动处理依赖与参数复用
2. 手动编译（通用或定制场景）：先 cd /www/server/nginx/src（宝塔）或 cd nginx-1.24.0（自建），再运行 nginx -V 2>&1 | grep "configure arguments:" 复制原有参数，在末尾追加 --add-dynamic-module=../ngx_brotli --with-compat；然后 make（不 make install），最后替换二进制：cp objs/nginx /www/server/nginx/sbin/nginx

启用 Brotli 并验证配置有效性

模块加载成功后，nginx -V 输出中应出现 --add-module=...ngx_brotli；但压缩不会自动开启，必须显式配置：

1. 编辑 /www/server/nginx/conf/nginx.conf（宝塔）或主配置文件，在 http 块内添加：

brotli on;

brotli_comp_level 6;

brotli_types text/plain text/css text/javascript application/javascript application/json application/xml+rss;

1. 保存后执行 nginx -t && nginx -s reload，再用 curl -I -H "Accept-Encoding: br" https://yoursite.com/test.js 检查响应头是否含 Content-Encoding: br
2. 注意：Brotli 与 Gzip 配置互不干扰，可共存；但浏览器只选最优可用算法（支持 Brotli 就不用 Gzip）