如何开启宝塔面板Nginx的Brotli压缩_编译安装替换默认Nginx版本-php教程-PHP中文网

宝塔面板默认Nginx不支持Brotli，需手动编译添加ngx_brotli模块；验证需检查编译参数含ngx_http_brotli_filter_module或响应头有content-encoding: br；启用前须停用并备份原Nginx，编译时必加--with-compat，配置后重载并排除gzip冲突。

如何开启宝塔面板nginx的brotli压缩_编译安装替换默认nginx版本

确认当前 Nginx 是否支持 Brotli

宝塔面板默认的 Nginx（尤其是 1.20+ 版本）不带 Brotli 支持，nginx -V 2>&1 | grep brotli 几乎总是返回空。别信面板里“已开启 Brotli”的勾选项——那只是前端开关，后端没模块照样不生效。真正要验证，得看 ngx_http_brotli_filter_module 是否在编译参数里，或者直接请求响应头有没有 content-encoding: br。

编译前必须停用宝塔内置 Nginx 并备份

宝塔会监控 /www/server/nginx 目录，擅自替换二进制或 conf 可能触发自动恢复。操作前务必：

在宝塔「软件商店」中点击 Nginx →「停止」，再点「卸载」（仅卸载，不删配置）
备份原二进制：cp /www/server/nginx/sbin/nginx /www/server/nginx/sbin/nginx.bak
备份关键配置：cp -r /www/server/nginx/conf /www/server/nginx/conf.bak
确认 /www/server/nginx 下没有正在运行的 nginx 进程（ps aux | grep nginx）

下载含 Brotli 的 Nginx 源码并编译

官方 Nginx 不支持 Brotli，必须用第三方模块。推荐使用 Google 官方维护的 ngx_brotli（https://www.php.cn/link/2a085e05b575fb1e26aed5121433ecfd），但注意它只兼容 Nginx 1.19–1.25，且需同步编译 libbrotli。

以宝塔常用 Nginx 1.22.1 为例（请先查 nginx -v 确认版本）：

cd /www/server/nginx/src
wget https://nginx.org/download/nginx-1.22.1.tar.gz
tar zxvf nginx-1.22.1.tar.gz
cd nginx-1.22.1
<h1>克隆模块（注意 submodule）</h1><p>git clone <a href="https://www.php.cn/link/2a085e05b575fb1e26aed5121433ecfd.git">https://www.php.cn/link/2a085e05b575fb1e26aed5121433ecfd.git</a>
cd ngx_brotli && git submodule update --init && cd ..</p><h1>编译前获取原宝塔 Nginx 的 configure 参数（关键！）</h1><p>/www/server/nginx/sbin/nginx -V 2>&1 | grep -o 'configure arguments:.*' | sed 's/configure arguments: //'</p><h1>在上面输出的参数末尾追加：</h1><h1>--add-module=/www/server/nginx/src/ngx_brotli --with-compat</h1><h1>执行 configure（把上一步得到的完整参数粘贴过来，末尾加上新增项）</h1><p>./configure --user=www --group=www --prefix=/www/server/nginx ... --add-module=/www/server/nginx/src/ngx_brotli --with-compat</p><p>make && make install</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting"><img
														src="https://img.php.cn/upload/skill/000/000/081/179116929868126.jpg" alt="Nginx Hosting" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="overflowclass">Nginx Hosting</a>
													<p class="overflowclass">通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>

⚠️ 常见坑：

--with-compat 必须加，否则模块加载失败（unknown directive "brotli" ）
不要用 make upgrade，它会跳过模块检查；必须用 make install
如果报 libbrotlienc.so.1: cannot open shared object file，说明系统没装运行时库，执行 ln -s /usr/lib64/libbrotlienc.so.1 /usr/lib64/libbrotlienc.so（路径按实际调整）

启用 Brotli 并验证生效

编辑主配置：/www/server/nginx/conf/nginx.conf，在 http{} 块内添加：

brotli on;
brotli_comp_level 6;
brotli_types text/plain text/css text/xml text/javascript application/javascript application/x-javascript application/xml application/xml+rss application/json image/svg+xml;

然后重载：/www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload

验证方式（任选其一）：

curl -I -H 'Accept-Encoding: br' https://yourdomain.com/js/app.js | grep encoding
浏览器 DevTools → Network → 刷新 → 查看响应头是否含 content-encoding: br
访问 https://www.php.cn/link/3316d81092ede6ad999c632bc1b57e4b 输入域名检测

Brotli 对文本类资源压缩率明显优于 Gzip，但 CPU 开销略高；生产环境建议 brotli_comp_level 控制在 4–6，别盲目设 11。

最易被忽略的是：宝塔「网站」→「设置」→「配置文件」里若手动加了 gzip off 或冲突指令，会覆盖全局配置；Brotli 生效的前提是该站点未禁用压缩且 MIME 类型匹配。