需为宝塔Nginx手动编译加载第三方模块：先查版本与编译参数，再下载匹配源码，整合模块源码后追加--add-module重新编译，最后验证语法、检查模块并重载服务。
如果您在宝塔面板中需要使用Nginx原生不包含的高级功能（如ngx_brotli、ngx_http_substitutions_filter、echo-nginx-module等），则需在保留当前运行环境的前提下，为已安装的Nginx手动编译并加载个性化模块。以下是具体操作步骤：
一、确认Nginx版本与编译参数
为确保模块兼容性，必须获取当前Nginx的准确版本号及原始编译参数，用于后续重新编译时复用基础配置。宝塔默认Nginx由源码编译安装，其构建信息保留在可执行文件中。
1、通过SSH登录服务器，执行命令查看Nginx版本及编译参数：
/www/server/nginx/sbin/nginx -V
2、记录输出中的configure arguments:后全部内容，该字符串是重编译必需的核心参数。
3、执行命令确认Nginx主程序路径是否为宝塔标准路径：
which nginx，预期返回/www/server/nginx/sbin/nginx。
二、下载并解压Nginx源码包
必须使用与当前运行版本完全一致的Nginx源码，否则模块加载将失败或引发段错误。宝塔官网提供对应版本源码镜像，优先从官方渠道获取。
1、进入Nginx源码存放目录：
cd /www/server/nginx/src
2、清除可能存在的旧源码：
rm -rf nginx-*
3、根据第一步查得的版本号（例如1.24.0），下载匹配源码包：
wget http://nginx.org/download/nginx-1.24.0.tar.gz
4、解压并进入源码目录：
tar -zxvf nginx-1.24.0.tar.gz && cd nginx-1.24.0
三、获取并整合第三方模块源码
每个待添加模块需独立下载、解压，并确保其源码目录位于Nginx源码树外部且路径固定，以便configure脚本引用。模块间无依赖冲突时可同时集成。
1、创建模块存放父目录：
mkdir -p /www/server/modules
2、以Brotli压缩模块为例，下载并解压：
cd /www/server/modules && git clone https://github.com/google/ngx_brotli.git
3、进入ngx_brotli子模块目录，更新其依赖子模块：
cd ngx_brotli && git submodule update --init
4、以Substitutions Filter模块为例，下载指定稳定版本：
cd /www/server/modules && wget https://codeload.github.com/calio/substitutions4nginx/tar.gz/v0.6.5 -O substitutions4nginx-0.6.5.tar.gz && tar -zxf substitutions4nginx-0.6.5.tar.gz
四、执行带模块的重新编译
在原始configure参数基础上，追加--add-module指向各第三方模块源码路径。所有模块路径必须为绝对路径，且顺序不影响最终结果。编译过程不覆盖原二进制文件，仅生成新nginx对象。
1、回到Nginx源码根目录：
cd /www/server/nginx/src/nginx-1.24.0
2、执行configure命令（请将下方示例中的“[original_args]”替换为第一步实际获取的完整参数，并补全模块路径）：
./configure [original_args] --add-module=/www/server/modules/ngx_brotli --add-module=/www/server/modules/substitutions4nginx-0.6.5
3、开始编译（不安装）：
make
4、备份原Nginx二进制文件：
mv /www/server/nginx/sbin/nginx /www/server/nginx/sbin/nginx.bak
5、复制新编译的nginx到运行位置：
cp objs/nginx /www/server/nginx/sbin/nginx
五、验证模块加载与语法检查
新二进制文件需通过语法校验并确认模块已注册，才能安全重载服务。任何配置错误或模块缺失都将导致Nginx启动失败，此时需立即回滚。
1、检查Nginx配置语法是否正确：
/www/server/nginx/sbin/nginx -t
2、列出当前Nginx已加载的模块（输出中应包含brotli_static、subs_filter等关键词）：
/www/server/nginx/sbin/nginx -V 2>&1 | grep -o 'brotli\|subs_filter\|echo'
3、若语法检查通过且模块关键词存在，执行平滑重载：
/etc/init.d/nginx reload
4、观察宝塔面板首页Nginx状态是否显示“正在运行”，并检查站点访问是否正常。
