Nginx 模块管理怎么查看已加载模块列表

千枫同学_4387

千枫同学_4387

2026-11-20

853人浏览

原创

查看 nginx 已加载模块列表最直接的方法是使用 -v 参数运行 nginx 命令,该操作会输出包含编译配置和模块详情的版本信息。执行后在标准错误输出中查找以 --with- 开头的参数,这些即为当前二进制文件内置的模块。若需确认运行时动态加载的模块状态,可检查 nginx.conf 中的 load_module 指令或查看进程加载的动态库文件。

Nginx 模块管理怎么查看已加载模块列表

如何区分静态编译与动态加载的模块

静态模块在编译时已嵌入 Nginx 二进制文件,无法在不重新编译的情况下移除;动态模块则以 .so 文件形式存在,通过 load_module 指令在启动时加载。要准确识别这两类模块,需要结合 -V 输出的编译参数与系统文件系统中的共享库文件进行交叉验证。静态模块通常以 --with-http_ssl_module 等形式出现在配置日志中,而动态模块则体现为 --add-dynamic-module 编译选项及对应的 .so 文件路径。

Nginx 模块管理怎么查看已加载模块列表

#!/bin/bash
# 获取 nginx 二进制文件路径
NGINX_BIN=$(which nginx)

# 1. 查看静态编译的模块(从 --with- 参数中提取)
echo "=== Static Modules (from compile args) ==="
$NGINX_BIN -V 2>&1 | grep -oP '(?/dev/null || echo "No dynamic modules found in directory."
fi

# 3. 验证特定模块是否生效(以 http_ssl_module 为例)
echo "=== Verification: http_ssl_module ==="
if $NGINX_BIN -V 2>&1 | grep -q 'http_ssl_module'; then
    echo "Static SSL module is present."
else
    # 检查动态加载
    if ls $MODULE_DIR/*ssl*.so &>/dev/null; then
        echo "Dynamic SSL module might be loaded via load_module directive."
    else
        echo "SSL module not found."
    fi
fi

上述脚本首先定位 nginx 可执行文件,接着利用 grep 过滤 -V 输出中的 --with- 参数来列出所有静态编译的模块。随后,脚本检查常见的动态模块目录(如 /etc/nginx/modules),列出其中的 .so 文件。最后,它演示了如何针对特定模块(如 http_ssl_module)进行存在性验证,优先检查静态编译标志,若无则回退到检查动态库文件。这种分层验证方法能确保开发者清楚知道每个模块的来源是编译时固化还是运行时加载。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

基于 load_module 指令的具体问题:动态模块未生效怎么排查

当配置文件中添加了 load_module 指令但模块未生效时,通常是因为动态库文件路径错误、依赖缺失或权限不足。排查的核心在于确认 .so 文件是否存在且能被 Nginx 工作进程读取,同时检查系统日志中是否有相关的加载失败记录。Nginx 主进程在启动时会尝试加载指定的动态库,如果失败,通常会直接报错并拒绝启动,或者在日志中留下明确的错误信息。

Nginx 模块管理怎么查看已加载模块列表

# 假设配置文件片段如下:
# load_module /usr/lib/nginx/modules/ngx_http_geoip_module.so;

# 1. 检查文件是否存在及权限
ls -l /usr/lib/nginx/modules/ngx_http_geoip_module.so

# 2. 检查动态库依赖是否满足(使用 ldd 命令)
ldd /usr/lib/nginx/modules/ngx_http_geoip_module.so

# 3. 测试 Nginx 配置并重载
nginx -t
systemctl reload nginx

# 4. 查看错误日志
journalctl -u nginx.service -e

在排查动态模块未生效的问题时,第一步是验证 load_module 指令中指定的 .so 文件路径是否正确且文件存在。使用 ls -l 命令可以确认文件的权限是否允许 Nginx 用户(通常是 www-data 或 nginx)读取。接下来,使用 ldd 命令检查该动态库是否依赖其他系统库,任何标记为 not found 的依赖项都会导致加载失败。最后,运行 nginx -t 进行配置语法检查,如果动态库加载失败,此命令会立即返回错误信息。通过观察 journalctl 或 error.log 中的具体错误提示,可以快速定位是路径错误、依赖缺失还是权限问题,从而采取相应的修复措施。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

477

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

1020

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

3752

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

1216

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

1089

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

574

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

3476

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

6612

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

987

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习