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 才生效。
准备系统依赖和基础工具
确保编译环境完整，否则后续步骤会失败：
- CentOS/RHEL：运行
yum groupinstall "Development Tools"，再安装openssl-devel pcre-devel zlib-devel git autoconf automake libtool - Ubuntu/Debian：执行
apt-get install build-essential libssl-dev libpcre3-dev zlib1g-dev git autoconf automake libtool - 宝塔用户额外确认
/www/server/nginx/src目录存在，这是重编译的起点
编译安装 libbrotli 核心库
该库提供编码/解码能力，Nginx 编译时需链接其头文件和动态库，路径默认为 /usr/local：
- 克隆源码：
git clone https://github.com/google/brotli.git && cd brotli - 推荐使用 autotools 方式构建（兼容性更稳）：
./bootstrap && ./configure --prefix=/usr/local && make && sudo make install - 安装后立即执行
sudo ldconfig刷新动态库缓存，确保libbrotlidec.so和libbrotlienc.so可被识别
获取并集成 ngx_brotli 模块到 Nginx
模块本身不带编译逻辑，必须嵌入 Nginx 源码编译流程。两种主流路径：
-
宝塔用户优先用软件商店编译安装：卸载当前 Nginx → 进【软件商店】→【运行环境】→ 选 Nginx → 【编译安装】→ 勾选【自定义模块】→ 输入
--add-module=/www/server/ngx_brotli→ 提交。宝塔会自动处理依赖与参数复用 -
手动编译（通用或定制场景）：先
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；但压缩不会自动开启，必须显式配置：
- 编辑
/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;
- 保存后执行
nginx -t && nginx -s reload，再用curl -I -H "Accept-Encoding: br" https://yoursite.com/test.js检查响应头是否含Content-Encoding: br - 注意：Brotli 与 Gzip 配置互不干扰，可共存；但浏览器只选最优可用算法（支持 Brotli 就不用 Gzip）
