Nginx不支持运行时动态加载绝大多数第三方模块，必须源码编译集成；需复用原configure参数并追加--add-module=绝对路径，make后仅替换sbin/nginx二进制文件，避免make install覆盖配置。

Linux 下给 Nginx 集成第三方模块，必须通过源码编译实现——Nginx 默认不支持运行时动态加载绝大多数第三方模块，configure 阶段就已锁定所有模块列表，编译后二进制文件即固定。

确认当前环境与模块兼容性

先查清正在运行的 Nginx 版本和原始编译参数：

• 执行 /usr/local/nginx/sbin/nginx -V，重点复制整行 --configure arguments 输出
• 核对第三方模块的官方文档，确认其支持的 Nginx 主版本范围（如仅支持 1.22–1.26）、是否依赖特定库（如 pcre2、zlib-ng）或要求启用某些基础模块（如 --with-http_realip_module）
• 确保模块目录里有 config 文件，否则 configure 无法识别该模块

准备源码与模块路径

下载与线上版本完全一致的 Nginx 源码包（例如线上是 1.24.0，就必须用 nginx-1.24.0.tar.gz），不要用更高或更低版本替代：

linux-sysadmin

Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...

下载

• 解压 Nginx 源码到固定目录，如 /root/nginx-1.24.0
• 将第三方模块（如 ngx_cache_purge、headers-more-nginx-module）放到独立目录，如 /root/modules/ngx_cache_purge
• --add-module 参数必须使用绝对路径，且指向模块根目录（含 config 文件）

复用原参数并追加模块重新编译

进入 Nginx 源码目录，用原始 configure 命令，再添加 --add-module= 路径：

• 例如：./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_v2_module --add-module=/root/modules/ngx_cache_purge
• 多个模块可连续添加：--add-module=/path/a --add-module=/path/b，顺序无关
• 执行 make（无需 root 权限），完成后只替换二进制文件：sudo cp objs/nginx /usr/local/nginx/sbin/nginx
• 避免执行 make install，否则可能覆盖 conf、html、logs 等目录下的配置和数据

验证与重载

替换完成后立即验证是否集成成功：

• 运行 /usr/local/nginx/sbin/nginx -V 2>&1 | grep cache_purge，有输出即表示模块已编译进二进制
• 检查配置语法：/usr/local/nginx/sbin/nginx -t
• 平滑重载配置：/usr/local/nginx/sbin/nginx -s reload，避免连接中断