直接编译nginx并集成自定义模块需先安装gcc、make、perl及pcre/zlib/openssl等开发依赖，再将含config文件的模块源码置于统一目录，通过--add-module按序指定路径，配合--with-http_ssl_module等启用项及--with-ld-opt处理链接，最后make编译安装，并用nginx -v和-vt验证模块加载与配置正确性。
直接编译 Nginx 并集成自定义模块，核心在于理清依赖关系、控制模块加载顺序、正确传递编译参数。官方源码不自带第三方模块，所有扩展需手动引入并确保头文件与库可用。
准备依赖环境与基础工具
编译前必须安装系统级依赖：gcc、make、perl、libpcre3-dev（或 pcre-devel）、zlib1g-dev（或 zlib-devel）、libssl-dev（或 openssl-devel）。这些是 Nginx 核心功能（正则、gzip、HTTPS）所必需的。若自定义模块用到其他库（如 Lua、GeoIP2、Brotli），对应开发包（如 libluajit-5.1-dev、libmaxminddb-dev、libbrotli-dev）也需提前安装。验证方式是检查 /usr/include 下是否存在模块所需的头文件，/usr/lib 或 /usr/lib/x86_64-linux-gnu 下是否有对应 .so 或 .a 文件。
获取并组织模块源码路径
将自定义模块源码放在统一目录（如 /opt/nginx-modules/echo），确保每个模块根目录含 config 文件（用于 configure 识别）和 ngx_http_echo_module.c 类似主源文件。若模块无 config 文件，需手写一个，内容参考官方模块格式，声明 MODULE_TYPE、CONFIGURE_ARGS、CORE_INCS 等变量。多个模块可并列存放，编译时通过 --add-module= 多次指定路径，顺序影响模块 init 阶段调用优先级，一般把基础工具类模块（如 set-misc）放前面，业务逻辑模块放后面。
configure 参数关键组合
执行 configure 时需显式启用所需功能，并挂载模块：
- --prefix=/usr/local/nginx：指定安装路径，避免覆盖系统包
- --with-http_ssl_module --with-http_v2_module：启用 HTTPS 和 HTTP/2（若模块依赖 SSL，则此项不可省）
- --with-openssl=/path/to/openssl-source：若需特定 OpenSSL 版本（如修复 CVE），指向解压后的源码目录，而非系统库
- --add-module=/opt/nginx-modules/echo --add-module=/opt/nginx-modules/headers-more：逐个添加自定义模块路径
- --with-ld-opt="-Wl,-rpath,/usr/local/lib"：当模块链接非标准路径的动态库时，强制运行时查找路径
编译与验证模块是否生效
运行 make -j$(nproc) 编译，完成后 sudo make install。启动前先检查：
- /usr/local/nginx/sbin/nginx -V：输出中应包含 --add-module= 的路径，且 configure arguments 完整显示
- /usr/local/nginx/sbin/nginx -t：确认配置语法正确，同时会加载模块并初始化，若模块依赖缺失（如找不到 .so 或符号未定义），此处会报错
- 在 nginx.conf 中启用模块指令（如 echo "hello";），再请求测试接口，观察响应是否符合预期
