升级单个动态模块无需重编译Nginx，只需版本兼容（主版本号一致）即可独立替换并重载生效；需确认Nginx≥1.9.11、编译支持动态模块、模块路径存在可写；用相同源码和参数编译新模块（make modules），覆盖旧模块后在配置中声明load_module，语法校验通过再nginx -s reload生效；异常时可快速回退。
升级单个动态模块不需要重新编译整个 Nginx，只要新模块与当前 Nginx 版本兼容（主版本号一致，如都是 1.24.x），就可以独立替换并重载生效。
确认当前环境支持动态模块
运行以下命令检查：
- nginx -v：确认版本 ≥ 1.9.11（否则不支持动态模块）
- nginx -V 2>&1 | grep -- '--add-dynamic-module'：若输出中有该参数，说明原编译支持动态模块加载
-
ls /usr/local/nginx/modules/（或通过 nginx -V 中的 configure arguments 查找
--modules-path=路径）：确认模块存放目录存在且可写
编译新版本动态模块
使用与原 Nginx 完全相同的源码版本和编译参数，仅更新模块源码：
- 下载与当前 Nginx 版本一致的源码包（例如 nginx-1.24.0.tar.gz）并解压
- 获取原始 configure 参数：nginx -V → 复制
configure arguments全部内容 - 在
./configure命令末尾追加：--add-dynamic-module=/path/to/new-module（注意不是--add-module） - 执行 make modules（不是
make install或make），生成.so文件（如ngx_http_echo_module.so）
替换并启用新模块
操作需谨慎，建议先在测试环境验证：
- 备份旧模块：cp /usr/local/nginx/modules/old.so /usr/local/nginx/modules/old.so.bak
- 覆盖新模块：cp objs/ngx_http_echo_module.so /usr/local/nginx/modules/
- 检查配置文件中是否已声明加载：load_module modules/ngx_http_echo_module.so;（该行必须在
events或http块之外、全局层级） - 语法校验：nginx -t → 确保无报错
- 热重载生效：nginx -s reload → 新模块立即加载，旧模块卸载（Nginx 自动处理生命周期）
验证与回退
升级后快速确认是否生效：
- 查看加载日志：tail -n 20 /var/log/nginx/error.log，搜索 "loading module" 或模块名
- 用 curl 或 nginx -V 无法直接显示已加载的动态模块列表，需依赖模块自身暴露的指令（如 echo 模块支持
echo "hello";配置）或功能测试 - 若异常，立刻回退：mv /usr/local/nginx/modules/ngx_http_echo_module.so.bak /usr/local/nginx/modules/ngx_http_echo_module.so → 再次 nginx -s reload
