需手动修改宝塔Nginx编译参数以添加官方未预编译模块：一、查版本与configure参数；二、下载模块至指定目录并确认config文件；三、修改nginx.sh脚本追加--add-module=路径；四、手动执行configure/make/make install并验证；五、配置启用指令、语法检测、重载及curl验证响应头。
如果您希望在宝塔面板中使用官方未预编译的 Nginx 模块（例如 ngx_brotli、nginx-vts-module 或 lua-nginx-module），则需绕过默认的一键安装流程，通过手动修改编译参数重新编译 Nginx。以下是实现该目标的具体步骤：
一、确认当前 Nginx 版本与编译环境
重新编译前必须获取当前运行 Nginx 的版本号、原始 configure 参数及依赖状态，避免因参数缺失或冲突导致编译失败。宝塔默认将源码和编译记录保存在固定路径，需从中提取关键信息。
1、执行 nginx -V 查看当前 Nginx 的完整 configure 参数，重点关注以 --prefix=、--add-module= 开头的选项。
2、进入宝塔源码缓存目录：cd /www/server/panel/install，查找对应 Nginx 版本的 .sh 安装脚本（如 nginx.sh）。
3、运行 cat nginx.sh | grep "configure\|MODULE" 提取原始编译命令结构及已启用模块列表。
二、下载并准备目标模块源码
新增模块必须与当前 Nginx 版本兼容，且源码需放置于可被 configure 脚本引用的路径。宝塔编译流程默认从 /www/server/nginx/src/modules/ 下读取模块，因此需按规范组织目录结构。
1、创建模块存放目录：mkdir -p /www/server/nginx/src/modules/ngx_brotli（以 brotli 为例）。
2、进入该目录并克隆模块仓库：git clone https://github.com/google/ngx_brotli.git .。
3、同步子模块（若模块依赖 submodules）：git submodule update --init。
4、确认模块根目录下存在 config 文件（Nginx 编译识别模块的必要条件）。
三、修改宝塔 Nginx 编译脚本
宝塔在执行 Nginx 升级或重装时调用 /www/server/panel/install/nginx.sh 中的 compile_nginx() 函数。需在此函数的 configure 命令末尾追加 --add-module= 参数，指向新模块路径。
1、备份原始脚本：cp /www/server/panel/install/nginx.sh /www/server/panel/install/nginx.sh.bak。
2、使用 sed 或编辑器定位 configure 行（通常含 --with-http_ssl_module 等参数），在其后添加：--add-module=/www/server/nginx/src/modules/ngx_brotli \。
3、确保换行符为反斜杠+回车，且末尾无空格或不可见字符，否则 shell 执行会中断。
4、验证修改后的 configure 命令是否语法正确，可通过复制整行到终端执行 echo 测试输出。
四、执行自定义编译并替换二进制文件
宝塔不提供直接调用编译函数的接口，需模拟其环境变量与工作路径手动触发编译流程，完成后将生成的 nginx 二进制文件覆盖原安装位置。
1、切换至宝塔 Nginx 源码目录：cd /www/server/nginx/src。
2、加载宝塔编译环境变量：source /www/server/panel/install/lib.sh。
3、运行修改后的编译命令（从 nginx.sh 中复制 configure 行并追加 make && make install）。
4、确认新二进制文件已生成：ls -l /www/server/nginx/sbin/nginx，检查时间戳是否更新。
5、校验模块是否载入：/www/server/nginx/sbin/nginx -V 2>&1 | grep -o ngx_brotli，应返回模块名。
五、验证配置并重启服务
仅编译成功不代表模块可用，还需在 Nginx 配置中启用对应指令，并通过语法检测与热重载验证运行时有效性。宝塔 Web 界面可能无法自动识别新增指令，需手动编辑配置文件。
1、在站点配置或全局 http 块中添加模块特有指令，例如 brotli 模块需写入：brotli on; 和 brotli_comp_level 6;。
2、执行配置语法检查：/www/server/nginx/sbin/nginx -t，确保返回 success。
3、向主进程发送重载信号：kill -s HUP $(cat /www/server/nginx/logs/nginx.pid)。
4、访问站点并用 curl 检查响应头：curl -I -H "Accept-Encoding: br" https://your-site.com，确认包含 Content-Encoding: br。
