在 linux 中查看 nginx 已编译安装的模块，最直接且准确的方法是使用 -v 参数（大写）运行 nginx 可执行文件。该命令会输出 nginx 的版本信息以及完整的编译配置参数，从中可以识别出所有静态编译的模块。如果使用的是通过包管理器安装的版本，通常只包含核心功能，而自定义编译的版本则可能包含如 ngx_http_ssl_module、ngx_http_gzip_module 等第三方或额外模块。
如何从编译参数中区分动态加载与静态编译模块
通过 -V 输出的配置列表，可以明确区分哪些模块是静态编译进二进制文件的，哪些是作为动态共享对象（DSO）存在的。在较新的 Nginx 版本（1.9.0+）中，支持动态模块加载。静态模块直接出现在 --with- 或 --add-module 参数中，而动态模块通常以 --load-module 或在编译时指定 --with-http_xxx_module=dynamic 的形式出现。理解这一区别有助于在后续配置 nginx.conf 时使用 load_module 指令正确加载非核心模块。
# 假设我们有一个自定义编译的 Nginx # 执行以下命令查看配置 nginx -V # 输出示例： # nginx version: nginx/1.24.0 # built by gcc 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04) # built with OpenSSL 3.0.2 15 Mar 2022 # TLS SNI support enabled # configure arguments: --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 --with-http_gzip_static_module --with-http_v2_module --add-dynamic-module=/path/to/ngx_http_geoip2_module
在上述输出中，--with-http_ssl_module 表示 SSL 模块是静态编译的，始终可用。而 --add-dynamic-module 指向的路径表明该模块被编译为动态库，需要在运行时通过 load_module 指令加载。如果没有看到 --add-dynamic-module 或 --with-xxx=dynamic，则说明所有模块均为静态编译，无需额外加载步骤。
如何验证特定模块是否在当前运行的 Nginx 中生效
仅仅知道编译时包含了某个模块还不够，开发者需要确认该模块在当前正在运行的 Nginx 实例中是否实际生效。对于静态模块，它们总是可用的，除非在 nginx.conf 中被显式禁用。对于动态模块，必须检查配置文件顶部是否有对应的 load_module 语句，并且确保指定的 .so 文件路径正确且存在。此外，可以通过检查 Nginx 的错误日志或使用 nginx -t 测试配置语法来验证模块加载状态。如果模块加载失败，Nginx 会在启动时报错并拒绝服务。
# 1. 检查动态模块配置文件 # 通常在 /etc/nginx/modules-enabled/ 或主配置文件中 head -n 10 /etc/nginx/nginx.conf # 2. 测试配置并尝试重启 sudo nginx -t sudo systemctl reload nginx # 3. 查看错误日志以确认模块加载情况 sudo tail -f /var/log/nginx/error.log # 预期结果： # 如果配置正确，nginx -t 会显示 "syntax is ok" 和 "test is successful" # 如果模块缺失或路径错误，错误日志中会出现类似 "module ... not found" 或 "cannot load module" 的错误信息
在实际操作中，如果发现某个功能未生效，首先应检查 nginx.conf 中是否正确引用了模块。例如，对于 ngx_http_geoip2_module，除了加载模块外，还需要在 http 块中配置相应的 GeoIP2 数据源。静态模块如 http_ssl_module 则无需额外配置即可使用，只需在服务器块中启用 ssl 即可。通过这种方式，可以系统地排查模块相关的问题。
基于 Nginx 编译参数中的 --with-http_ssl_module 条件，如何判断 HTTPS 支持是否内置
当我们在 nginx -V 的输出中看到 --with-http_ssl_module 时，这明确表示 Nginx 在编译阶段已经静态集成了 OpenSSL 支持，从而原生具备处理 HTTPS 请求的能力。这意味着不需要任何额外的动态模块加载步骤，只要配置文件中启用了 listen 443 ssl; 并提供了有效的证书和密钥，Nginx 就能立即处理加密流量。反之，如果输出中没有此参数，但系统安装了 OpenSSL 开发库，可能需要重新编译 Nginx 并添加此标志，或者确认是否使用了动态模块方式集成 SSL。对于大多数标准发行版的 Nginx 包，SSL 模块通常是默认静态编译的，以确保安全性和稳定性。
