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）加工后返回。
这种设计让功能解耦、职责分明，增删模块不影响整体流程，也便于定位问题发生在哪个阶段。
