nginx 不支持运行时动态加载第三方模块，必须源码编译集成；因其模块机制为静态链接，configure 阶段即固化模块列表，绝大多数第三方模块不支持动态 abi，仅官方少数模块（≥1.9.11 且含 --with-compat）可通过 load_module 加载 .so 文件。
直接说结论：Nginx 不支持运行时动态加载第三方模块，必须重新编译整个二进制文件；但可以复用原有配置和安装路径，只要不覆盖 conf、html、logs 目录，就不会丢配置或数据。
为什么不能像 Apache 那样加个 LoadModule 就完事？
Nginx 的模块机制是静态链接的 —— configure 阶段决定哪些模块进最终的 objs/nginx，编译后就固定了。没有 .so 插件目录，也没有 load_module 指令（那是 1.9.11+ 才有的动态模块支持，且仅限官方模块，绝大多数第三方模块仍只支持静态编译）。
常见误操作就是：装完 Nginx 后发现缺 ngx_cache_purge 或 headers-more-nginx-module，想直接 make install 第三方源码 —— 这根本不会生效，nginx -V 里也看不到它。
重新编译前必须确认的三件事
重新编译不是重装，核心是「保持原环境不变」：
- 用
/usr/local/nginx/sbin/nginx -V查出原始configure arguments（重点复制整行，包括所有--with-和--add-module=） - 确认第三方模块源码已解压，路径是绝对路径或相对于当前 Nginx 源码目录的相对路径（比如
../ngx_cache_purge） - 确保没动过
/usr/local/nginx/conf/，否则make install会覆盖掉你改过的nginx.conf（它默认只覆盖sbin/和html/等）
重新编译并替换 nginx 二进制文件的实操步骤
假设你已下载好 ngx_cache_purge 到 /root/modules/ngx_cache_purge，原 Nginx 安装在 /usr/local/nginx，源码在 /root/nginx-1.24.0：
进入 Nginx 源码目录：cd /root/nginx-1.24.0
追加模块并重新 configure（注意：必须带上原来所有参数，再加 --add-module=/root/modules/ngx_cache_purge）：./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_v2_module --add-module=/root/modules/ngx_cache_purge
执行编译（不加 install）：make
替换二进制文件（关键！只换 nginx，不动配置）：sudo cp objs/nginx /usr/local/nginx/sbin/nginx
验证是否生效：/usr/local/nginx/sbin/nginx -V 2>&1 | grep cache_purge（有输出即成功）
重载而非重启（避免连接中断）：/usr/local/nginx/sbin/nginx -s reload
容易被忽略的坑：OpenSSL 版本与 HTTP/2 冲突
如果新加的模块依赖较新 OpenSSL（比如 ngx_brotli），而你用的是系统自带旧版 OpenSSL（如 CentOS 7 的 1.0.2k），configure 会静默跳过 --with-http_v2_module，但不会报错。结果是：HTTP/2 看似启用，实际协商失败。
解决办法只有两个：
– 用 --with-openssl= 指向新版 OpenSSL 源码（如 ../openssl-3.0.12），然后重新编译整个链路
– 或干脆放弃该模块，改用纯静态压缩方案（如 gzip_static）
最稳妥的做法是：每次 make 前先跑一遍 ./configure --help | grep http_v2，确认目标模块没被自动禁用。
