宝塔面板中Nginx未启用Brotli压缩，需编译安装ngx_brotli模块并配置参数：一、通过软件商店编译安装并勾选自定义模块；二、手动下载编译模块并追加--add-module；三、在http块中配置brotli相关指令；四、通过浏览器开发者工具验证响应头含content-encoding: br。
如果您在宝塔面板中运行Nginx服务，但网页响应未使用Brotli压缩算法，则可能是由于Nginx未编译ngx_brotli模块或未正确配置压缩参数。以下是实现Brotli高性能压缩的多种可行路径：
一、通过宝塔软件商店编译安装（推荐）
该方法利用宝塔内置的编译安装机制，自动处理依赖与模块集成，适合大多数标准环境，无需手动干预configure参数。
1、登录宝塔面板，进入【软件商店】→【已安装】，找到当前运行的Nginx服务。
2、点击右侧【卸载】按钮，操作前请务必创建系统快照或备份nginx配置文件及网站数据。
3、返回【软件商店】→【运行环境】，找到Nginx，点击【安装】，在弹出窗口中选择【编译安装】。
4、勾选【自定义模块】，在输入框中粘贴：--add-module=/www/server/ngx_brotli。
5、点击【提交】开始编译安装，完成后Nginx将自动加载ngx_brotli模块。
二、手动下载并编译ngx_brotli模块
该方式适用于需精确控制Nginx版本、已有定制化编译参数，或宝塔编译安装失败的场景，要求具备基础Linux命令操作能力。
1、通过SSH以root身份登录服务器，执行：cd /www/server && git clone https://github.com/google/ngx_brotli.git。
2、进入模块目录并初始化子模块：cd ngx_brotli && git submodule update --init。
3、查看当前Nginx编译参数：nginx -V 2>&1 | grep "configure arguments:"，复制整行输出内容。
4、下载对应Nginx源码包（版本号须与当前一致），解压后进入目录，执行configure命令——在原有参数末尾追加：--add-module=/www/server/ngx_brotli。
5、执行make && make install完成编译安装，不执行make clean或重新启动服务。
三、配置Nginx启用Brotli压缩
无论采用哪种安装方式，均需在Nginx主配置中显式启用Brotli功能，并设定合理压缩策略，确保br编码可被识别与响应。
1、进入宝塔面板【软件商店】→【Nginx】→【设置】→【配置修改】。
2、在http块内（非server或location块）插入以下配置段：
brotli on;
brotli_comp_level 6;
brotli_min_length 512;
brotli_types text/plain text/javascript text/css text/xml application/javascript application/x-javascript application/xml application/json application/xhtml+xml application/rss+xml application/atom+xml application/x-font-ttf application/vnd.ms-fontobject image/svg+xml image/x-icon font/opentype;
brotli_static always;
3、保存配置后，点击【重载配置】或执行nginx -s reload使设置生效。
四、验证Brotli是否成功启用
配置生效后需通过HTTP响应头确认服务端实际返回br编码，排除浏览器兼容性或HTTPS缺失导致的协商失败。
1、使用Chrome或Edge浏览器打开开发者工具（F12），切换至【Network】标签页。
2、刷新任意网页，点击任一HTML或JS资源，查看【Headers】→【Response Headers】。
3、确认存在content-encoding: br字段；若仅显示gzip或无该字段，则检查是否为HTTP访问——Brotli仅在HTTPS连接下被现代浏览器主动请求。
4、同时检查请求头中的Accept-Encoding值，应包含br。
