编译安装nginx自定义模块的核心是configure参数组合控制启用、链接与依赖：先装对依赖，再确保模块含合法config文件，最后用--add-module等参数精准指定路径与关联选项。
编译安装 Nginx 时自定义模块，核心不是“传参数给模块”，而是通过 configure 脚本的选项组合 控制模块是否启用、如何链接、由谁提供依赖，以及让 Nginx 正确识别并集成你的模块源码。关键在三步：装对依赖、写好模块 config、选准 configure 参数。
确保模块源码自带合法 config 文件
第三方模块（如 echo、headers-more、lua-nginx-module）必须满足硬性前提：
- 根目录下存在可执行的 config 文件（shell 脚本），定义
ngx_addon_name、HTTP_MODULES、NGX_ADDON_SRCS等变量 - 模块路径用绝对路径指定（推荐），例如
--add-module=/opt/ngx_http_echo_module - 多个模块按依赖顺序排列，比如 set-misc 应在 echo 之前，因后者可能调用前者导出的函数
- 若模块依赖外部库（如 LuaJIT、MaxMindDB），对应开发包（
libluajit-5.1-dev、libmaxminddb-dev）必须已安装且头文件可达
configure 中精准控制模块行为
模块本身不接受运行时“参数”，但 configure 阶段可通过以下方式影响其编译与加载逻辑：
- --add-module=PATH：唯一指定第三方模块源码位置；可重复使用添加多个
- --with-http_ssl_module 和 --with-http_v2_module：多数 HTTP 模块（如 auth_request、proxy_cache_purge）隐式依赖 SSL 或 HTTP/2，漏掉会导致功能异常
- --with-openssl=/path/to/openssl-source：当模块需特定 OpenSSL 版本（如修复 TLS 1.3 握手缺陷），指向解压后的源码目录，而非系统 openssl-devel
- --with-ld-opt="-Wl,-rpath,/usr/local/lib"：若模块链接了非标准路径的动态库（如自建的 libluajit.so），强制运行时能找到
- 禁用冲突模块：--without-http_rewrite_module（若你用 Lua 完全替代 rewrite 逻辑），避免指令重名报错
验证模块是否真正生效
安装完成后不能只看启动成功，要分两层确认：
- 执行
/usr/local/nginx/sbin/nginx -V，输出中必须包含完整--add-module=...路径，且configure arguments显示所有你指定的--with-*项 - 在 nginx.conf 中启用该模块的指令（如
echo "hello";），再运行nginx -t—— 若报unknown directive "echo"，说明模块未编译进二进制或 config 文件有语法错误 - 检查
objs/Makefile是否含模块对应的 .o 编译规则；查看objs/nginx_modules.c是否注册了该模块结构体
整个过程不复杂但容易忽略细节，重点是让 configure “看见”模块、“信得过”依赖、“连得上”链接路径。
