Nginx源码入口是src/core/nginx.c中的main()函数，它依次执行配置解析、模块初始化、进程模型建立和事件循环启动；核心数据结构ngx_cycle_t贯穿全程，承载配置、模块、日志等运行时资源。

阅读 Nginx 源码，最直接的入口就是 main() 函数。它不长，但像一把钥匙，串起了整个启动流程的关键节点：配置解析、模块初始化、进程模型建立、事件循环启动。抓住它，你就站在了理解 Nginx 架构的起点。

定位 main 函数：从 src/core/nginx.c 开始

Nginx 的主函数定义在 src/core/nginx.c 文件中，是整个程序的唯一入口。它不做具体业务处理，而是按固定顺序调度核心逻辑：

• 调用 ngx_init_cycle() 初始化核心数据结构（如 cycle、conf、log）并加载配置；
• 执行所有模块的 init_module 钩子，完成模块级初始化（如 event 模块注册事件驱动、http 模块构建配置上下文）；
• 根据配置决定是否 fork worker 进程（master-worker 模式），或直接进入单进程事件循环（debug 模式）；
• 最终调用 ngx_master_process_cycle() 或 ngx_single_process_cycle() 启动主循环。

关注 cycle 结构体：Nginx 的“运行时上下文”

ngx_cycle_t * 是贯穿整个生命周期的核心指针，几乎所有关键资源都挂载其下：

• cycle->conf_ctx 存储各模块的配置结构体（如 http 模块的 ngx_http_conf_ctx_t）；
• cycle->modules 是已编译进来的模块数组，启动时按类型（core/event/http/mail）依次调用其初始化函数；
• cycle->log 是全局日志句柄，早期就初始化好，后续所有日志输出都依赖它；
• cycle->files 和 cycle->connections 在事件模块初始化后才被分配，为后续连接管理打基础。

读源码时，看到任意函数接收 ngx_cycle_t *cycle 参数，就说明它正在操作当前运行时环境——这是理解模块协作关系的重要线索。

跟踪配置加载：从 nginx.conf 到内存结构

配置解析不是一次性完成的，而是分两轮：

• 第一轮（预解析）：在 ngx_init_cycle() 中调用 ngx_conf_parse()，仅构建模块配置框架（conf_ctx），不填充具体指令值；
• 第二轮（正式解析）：遍历配置文件每一行，对每个指令调用对应模块的 set 回调函数（如 ngx_http_core_server），将文本配置转为 C 结构体字段；
• HTTP 配置有三级上下文（main → server → location），通过 ngx_http_conf_ctx_t 中的三个指针分别指向，解析时靠栈式嵌套维护作用域。

调试时可在 ngx_conf_handler() 下断点，观察每条配置如何触发模块回调，这是理清配置生效路径最直观的方式。

理解进程与事件循环的分工

Nginx 的并发模型由 master/worker 进程 + epoll/kqueue/eventport 驱动构成，启动后逻辑分流清晰：

• master 进程：只负责管理 worker 生命周期（启动、平滑重启、优雅退出）、信号处理、共享内存维护，不处理网络请求；
• worker 进程：每个独立调用 ngx_worker_process_cycle()，内部进入 for(;;) { ngx_process_events_and_timers() } 循环；
• 事件分发：由 event 模块（如 ngx_epoll_module）实现 process_events 接口，把就绪事件交给对应的 handler（如 ngx_http_init_request 处理新连接）。

注意：所有 worker 共享监听 socket（通过 SO_REUSEPORT 或 master accept 后 sendmsg 传递），但各自维护独立的连接池和内存池，这是高并发低锁的关键设计。

读源码不必逐行通读，从 main 出发，沿着配置加载、模块初始化、进程派生、事件循环四条主线深入，配合 gdb 跟踪关键函数调用和结构体填充，很快就能看清 Nginx 如何把一行配置变成一个高效 Web 服务器。