Linux上为Nginx添加第三方模块需根据其编译方式选择动态或静态方案：若支持动态模块（nginx -V含--add-dynamic-module），可仅编译生成.so文件并load_module加载；否则须重编译整个Nginx，确保版本、依赖及configure参数一致。
Linux 上给已安装的 Nginx 编译添加第三方模块，核心在于「重新编译」而非「热插拔」——Nginx 默认不支持运行时加载未内置的模块（除明确标记为 dynamic 的模块外）。是否能加、怎么加，取决于你当前 Nginx 是如何安装的，以及目标模块是否支持动态编译。
确认当前 Nginx 是否支持动态模块
执行以下命令查看 Nginx 编译参数：
nginx -V 2>&1 | grep "configure arguments"如果输出中包含 --with-dynamic-module=... 或看到类似 --add-dynamic-module=...，说明它原本就启用了动态模块支持；若只有 --add-module=...（无 dynamic），则该 Nginx 是静态编译的，无法直接加载 .so 模块，必须重编译。
方式一：动态模块（推荐，无需替换主程序）
适用于 Nginx ≥ 1.9.11 且原始编译启用了 --with-dynamic-module 或你愿意重编译一次来启用它。流程如下：
- 下载并解压目标第三方模块源码（如
ngx_http_sub_module、nginx-rtmp-module） - 进入 Nginx 源码目录（必须与当前运行版本一致，例如 nginx-1.24.0）
- 用原 configure 参数追加动态模块选项，例如：
./configure --with-dynamic-module=/path/to/your/module --add-dynamic-module=/path/to/another/module - 执行 make（注意：只运行 make，不要 make install）
- 生成的
.so文件位于objs/目录下（如ngx_http_sub_module.so） - 将 .so 文件复制到 Nginx 模块目录（如
/usr/local/nginx/modules/），并在nginx.conf开头添加：
load_module modules/ngx_http_sub_module.so;
方式二：静态模块（完全重编译）
当目标模块不支持动态编译，或你当前 Nginx 是静态构建的，就必须完整重编译整个 Nginx：
- 获取与当前
nginx -v输出版本号完全一致的源码包（如 1.24.0） - 确保系统已装好依赖：
zlib-devel、openssl-devel、pcre-devel、gcc等 - 在 configure 命令中加入原有参数 + 新模块，例如：
./configure $(nginx -V 2>&1 | grep "configure arguments" | sed 's/.*arguments: //') --add-module=/path/to/your/module - 执行 make && sudo make install（覆盖安装）
- 验证：
nginx -t测试配置，nginx -V确认新模块已出现在 configure args 中
关键注意事项
模块路径必须准确；动态模块的 .so 文件需与 Nginx 主程序 ABI 兼容（即同版本、同架构、同编译器）；重编译前务必备份原 conf/ 和证书等重要文件；生产环境建议先在测试机验证模块功能与稳定性。
