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

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

#!/bin/bash
# 获取 nginx 二进制文件路径
NGINX_BIN=$(which nginx)
# 1. 查看静态编译的模块(从 --with- 参数中提取)
echo "=== Static Modules (from compile args) ==="
$NGINX_BIN -V 2>&1 | grep -oP '(?<=--with-)[^ ]+'
# 2. 查看动态加载的模块(假设 load_module 指向 /etc/nginx/modules/)
MODULE_DIR="/etc/nginx/modules"
if [ -d "$MODULE_DIR" ]; then
echo "=== Dynamic Modules (in $MODULE_DIR) ==="
ls -l $MODULE_DIR/*.so 2>/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)进行存在性验证,优先检查静态编译标志,若无则回退到检查动态库文件。这种分层验证方法能确保开发者清楚知道每个模块的来源是编译时固化还是运行时加载。
基于 load_module 指令的具体问题:动态模块未生效怎么排查
当配置文件中添加了 load_module 指令但模块未生效时,通常是因为动态库文件路径错误、依赖缺失或权限不足。排查的核心在于确认 .so 文件是否存在且能被 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 中的具体错误提示,可以快速定位是路径错误、依赖缺失还是权限问题,从而采取相应的修复措施。


















