Nginx 配置中的核心模块架构是怎样

Nginx核心模块架构是“主控—执行—扩展”三级分层设计：核心模块（ngx_core_module）负责进程管理、配置解析等基础服务；事件模块（ngx_event_module）封装epoll等I/O多路复用机制；HTTP核心模块（ngx_http_core_module）定义11个处理阶段并调度各HTTP模块；标准及第三方模块按阶段注册处理器，形成阶段化流水线协作。

Nginx 的核心模块架构是其高性能和高可靠性的底层支撑，不是松散拼凑的组件集合，而是围绕“主控—执行—扩展”三级职责清晰、耦合度低的分层设计。

核心模块按功能层级划分为五类

• 核心模块（ngx_core_module）
  是整个 Nginx 运行的基石，不处理业务逻辑，只负责进程管理、配置解析、信号处理、日志初始化、错误处理等基础服务。比如 worker_processes、user、pid 等全局指令均由它解析并驱动。没有它，其他模块无法加载。

• 事件模块（ngx_event_module）
  封装操作系统底层 I/O 多路复用机制（Linux 下默认用 epoll，BSD 用 kqueue），为所有网络请求提供统一的异步非阻塞事件调度能力。它不直接处理 HTTP，但决定了每个 worker 进程如何高效监听、接收、分发连接事件。

• HTTP 核心模块（ngx_http_core_module）
  是 HTTP 功能的总调度中心，定义了 server、location、if 等关键配置块语法，并组织 HTTP 请求处理的 11 个阶段（如 NGX_HTTP_POST_READ_PHASE、NGX_HTTP_CONTENT_PHASE）。它本身不实现具体功能，而是按阶段挂载其他 HTTP 模块（如 rewrite、access、proxy）的处理器。

• 标准 HTTP 模块（如 ngx_http_rewrite_module、ngx_http_access_module）
  在 HTTP 核心模块划定的阶段内注册回调函数，完成具体任务：

  • rewrite 模块在 NGX_HTTP_SERVER_REWRITE_PHASE 执行 URL 重写；
  • access 模块在 NGX_HTTP_ACCESS_PHASE 做 IP 黑白名单判断；
  • proxy 模块在 NGX_HTTP_CONTENT_PHASE 转发请求到上游服务器。

• 可选/第三方模块（如 ngx_http_ssl_module、ngx_http_v2_module、ngx_lua_module）
  通过编译时启用或动态加载方式集成，扩展协议支持（HTTPS/HTTP/2）、脚本能力（Lua）、认证鉴权等高级功能。它们遵循相同阶段模型，与标准模块协作无感。

模块协作靠“阶段化流水线”驱动
一个 HTTP 请求进入后，并非由某个模块独立处理到底，而是像流水线一样依次经过各阶段，每个阶段可能触发多个模块的 handler。例如访问 /api/user：

• 先由 core 模块解析配置并匹配到对应 server 和 location；
• event 模块把已就绪的 socket 交给 http core；
• http core 按顺序调用 rewrite → access → auth_basic → proxy 等模块；
• 最终由 proxy 模块发起 upstream 请求，结果再经 filter 模块（如 gzip、headers）加工后返回。

这种设计让功能解耦、职责分明，增删模块不影响整体流程，也便于定位问题发生在哪个阶段。