在nginx源码编译时自定义模块名称标识，核心做法是在配置阶段通过--add-module指定路径后，修改对应模块源码中的ngx_module_t结构体实例，将name字段改为期望的字符串。这样做能改变nginx -v输出及内部日志标识，便于区分定制版本或调试特定功能。
如何修改标准HTTP模块的名称标识
以常见的ngx_http_stub_status_module为例，直接修改其源码中的模块定义即可生效。找到该模块对应的C文件（通常在src/http/modules/目录下），定位到static ngx_module_t ngx_http_stub_status_module;这一行附近的初始化代码，修改其中的.name = "custom_status"部分。重新编译后，运行./nginx -V可以看到新的名称标识，且该模块在运行时仍保持原有功能逻辑不变。
# 假设在 nginx-1.24.0 源码根目录 # 1. 进入模块源码目录 src/http/modules$ grep -n 'ngx_module_t' ngx_http_stub_status_module.c # 2. 使用 sed 修改 name 字段为自定义名称 sed -i 's/name = "ngx_http_stub_status_module"/name = "my_custom_status"/' ngx_http_stub_status_module.c # 3. 返回根目录重新编译 ../configure --prefix=/usr/local/nginx --with-http_stub_status_module make sudo make install # 4. 验证结果 /usr/local/nginx/sbin/nginx -V
预期结果：nginx -V输出中包含built by gcc ...之后的模块列表里，原ngx_http_stub_status_module变为my_custom_status。模块功能完全一致，仅标识改变。
如何为第三方动态模块设置自定义名称
对于通过--add-dynamic-module加载的第三方模块，同样需要修改其源码中的ngx_module_t结构体。例如一个名为ngx_http_auth_request_module的第三方模块，其源码中通常有一个全局变量ngx_module_t ngx_http_auth_request_module;。在编译前，编辑该模块的C源文件，找到.name = "ngx_http_auth_request_module"并替换为如.name = "auth_v2"。注意，动态模块的.so文件名由构建系统决定，但内部标识符由源码控制，修改后加载的模块在nginx -V和错误日志中将显示新名称。
# 假设第三方模块源码位于 /path/to/ngx_http_auth_request_module/ cd /path/to/ngx_http_auth_request_module/ # 查看当前模块名 grep -n 'ngx_module_t' src/ngx_http_auth_request_module.c # 修改名称 sed -i 's/name = "ngx_http_auth_request_module"/name = "auth_v2"/' src/ngx_http_auth_request_module.c # 回到 Nginx 主源码目录重新配置和编译 ../configure --prefix=/usr/local/nginx --add-dynamic-module=/path/to/ngx_http_auth_request_module make sudo make install # 验证动态模块加载后的名称 /usr/local/nginx/sbin/nginx -V
预期结果：编译安装后，nginx -V输出中显示auth_v2而非原始模块名。动态模块加载行为不受影响，仅标识变更。
基于修改后模块名称的日志输出问题
当模块名称被自定义后，该模块产生的错误日志、访问日志或调试信息中的标识符会随之改变。例如，若将ngx_http_stub_status_module重命名为my_custom_status，则其触发的错误日志中将出现[error] my_custom_status: ...而非原名。这有助于在多模块环境中快速定位是哪个定制模块引发了问题，但也可能导致依赖原名进行日志过滤或监控的工具失效，需同步调整监控规则。
