如何从Nginx源码生成ngx_stream_geoip2_module-debug.so文件？

要生成ngx_stream_geoip2_module-debug.so，需确保编译时同时开启Nginx调试模式，并正确指定Stream模块的编译参数——ngx_http_geoip2_module仓库同时支持HTTP和Stream两种GeoIP2模块。以下是具体步骤：

1. 前置准备 #

• 安装libmaxminddb开发依赖：Debian/Ubuntu执行apt install libmaxminddb-dev，RHEL/CentOS执行yum install libmaxminddb-devel，确保编译时能找到对应头文件和库。
• 下载与当前运行版本一致的Nginx源码（版本不匹配可能引发兼容性问题）。
• 克隆leev维护的ngx_http_geoip2_module仓库到本地。

2. 配置编译参数 #

进入Nginx源码目录，执行configure命令，必须包含以下核心参数：

• --with-debug：开启Nginx调试模式，生成带调试符号的二进制文件和模块。
• --add-dynamic-module=../ngx_http_geoip2_module：指定geoip2模块的源码路径（根据实际克隆路径调整）。
• --with-stream：启用Nginx的Stream模块，否则不会生成Stream版本的geoip2模块。

示例configure命令（可按需添加--prefix等其他参数指定安装路径）：

./configure --prefix=/usr/local/nginx-debug --with-debug --with-stream --add-dynamic-module=../ngx_http_geoip2_module

3. 编译生成调试模块 #

执行编译命令：

make

编译完成后，在Nginx源码目录的objs子目录下，即可找到ngx_stream_geoip2_module-debug.so文件。

4. 加载使用 #

• 将生成的.so文件复制到Nginx的模块目录（比如/usr/local/nginx/modules/）。
• 在Nginx配置文件开头添加加载指令：

load_module modules/ngx_stream_geoip2_module-debug.so;

• 启动调试版Nginx，用nginx -t检查配置合法性，无报错则说明模块加载成功。

问题排查 #

• 若configure提示找不到libmaxminddb，确认已安装开发包，或用--with-libmaxminddb=/path/to/libmaxminddb手动指定库路径。
• 确保Nginx版本在模块仓库支持的范围内，可参考仓库文档确认兼容版本。
• 编译失败时检查是否安装了gcc、make等基础编译工具。

内容的提问来源于stack exchange，提问作者vivek saurabh