卸载 nginx 动态模块的唯一方法是重新编译 nginx 并移除对应的 --load-module 配置,因为 nginx 在启动时加载这些模块后无法在运行时动态卸载。你需要从源码构建一个不包含该模块的新二进制文件,替换掉现有的 nginx 程序,然后重启服务以生效。

如何确认当前加载了哪些动态模块
在开始卸载之前,必须确认目标模块的名称以及它是否被正确加载。可以通过运行 nginx -V 命令查看当前的编译参数和已加载的模块列表。输出中会包含 loaded modules 部分,列出所有静态和动态加载的模块。如果模块不在列表中,说明它未被加载,无需卸载;如果在列表中,则需要记录其确切名称以便后续处理。

# 查看当前 Nginx 版本及已加载模块 nginx -V # 示例输出片段: # nginx version: nginx/1.24.0 # built by gcc 11.4.0 ... # configured --with-http_ssl_module --load-module=/usr/lib/nginx/modules/ngx_http_geoip2_module.so # loaded modules: # ngx_http_geoip2_module (dynamic)
执行上述命令后,关注 loaded modules 下方的列表。找到需要卸载的模块名,例如 ngx_http_geoip2_module。同时,记录下 configure arguments 中的 --load-module 路径,这有助于定位模块源文件。如果使用的是包管理器安装的 Nginx,可能没有直接提供源码编译选项,此时需下载对应版本的源码包进行重新编译。
如何重新编译 Nginx 以移除指定模块
重新编译是移除动态模块的核心步骤。首先,下载与当前运行版本一致的 Nginx 源码。解压后,进入源码目录,使用 ./configure 配置编译选项。关键点是:不要包含指向该动态模块的 --load-module 参数,并确保其他所需模块(如 http_ssl_module)仍被正确配置。编译完成后,用新生成的 nginx 二进制文件替换旧文件,最后重启 Nginx 服务。

# 1. 下载源码(以 1.24.0 为例)
cd /tmp
wget http://nginx.org/download/nginx-1.24.0.tar.gz
tar -zxvf nginx-1.24.0.tar.gz
cd nginx-1.24.0
# 2. 配置编译选项(移除目标模块)
# 注意:此处省略了其他必要模块的配置,实际需根据原 nginx -V 输出补充
./configure --prefix=/etc/nginx \
--sbin-path=/usr/sbin/nginx \
--modules-path=/usr/lib/nginx/modules \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log \
--with-http_ssl_module \
# 注意:未添加 --load-module=.../ngx_http_geoip2_module.so
# 3. 编译(仅编译,不安装)
make
# 4. 备份旧二进制文件并替换
sudo cp /usr/sbin/nginx /usr/sbin/nginx.bak
sudo cp objs/nginx /usr/sbin/nginx
# 5. 验证新二进制文件
/usr/sbin/nginx -V
# 6. 重启 Nginx
sudo systemctl restart nginx
完成替换后,再次运行 nginx -V 确认目标模块已从 loaded modules 列表中消失。如果重启失败,检查 /var/log/nginx/error.log 排查配置或权限问题。此过程要求对 Nginx 编译有一定了解,务必确保所有必需模块都被保留,否则可能导致服务功能缺失。
卸载模块后如何验证服务正常运行
重新编译并重启 Nginx 后,必须验证服务是否按预期运行,特别是确认目标模块已不再影响任何请求处理。通过发送测试请求并检查响应头、错误日志以及模块特定功能是否失效来综合判断。例如,若卸载的是 GeoIP 模块,应检查原本依赖该模块的地理位置相关逻辑是否停止工作,同时确保其他正常功能不受影响。
# 1. 检查 Nginx 进程状态 systemctl status nginx # 2. 发送测试请求并观察响应 curl -I http://localhost/ # 3. 检查错误日志是否有异常 sudo tail -f /var/log/nginx/error.log # 4. 验证特定功能是否失效(以 GeoIP 为例) # 假设原配置中有 $geoip_country_code 变量,现在应返回空值或默认值 curl -s http://localhost/test | grep "country"
如果 systemctl status nginx 显示 active (running),且 curl 请求返回正常 HTTP 状态码(如 200),则基本表明服务已恢复。重点检查 error.log 中是否出现与已卸载模块相关的错误信息,如 “module not found” 或 “unknown directive”。若发现此类错误,说明配置文件仍引用了该模块,需编辑 nginx.conf 或相关 include 文件,注释或删除对应的 load_module 指令或模块相关配置块。最终,通过功能测试确认目标模块的影响已被彻底清除,且其他服务功能完好无损。


















