如果你这几年一直在跟进HTTP/3和QUIC,会注意到一个非常反直觉的事实:Nginx——一个Web服务器,居然在自己的C模块里从头手写了一套完整的QUIC传输协议栈,而不是像大多数项目那样调quiche、msquic这种现成库。你打开nginx主线源码的src/event/quic目录,看到的是一大堆ngx_quic_*开头的源文件,它们负责UDP收包、连接管理、帧解析、拥塞控制、连接迁移,每一层都是自己实现的。
这篇文章我想从一个具体切口入手:跟着客户端发出的第一个Initial包,看它在Nginx模块里从UDP收包到ClientHello握手完整走一遍,然后一直聊到连接迁移这个号称“QUIC王牌特性”的实现。以某个主线版本为参照,核心拆解对象是13个源文件,其余几个辅助文件我会顺带提。目标是让读者看完后,再打开这些文件时能知道每段代码在干什么,也搞清楚一个能上生产环境的协议栈,除了收包回包,还要额外考虑哪些东西。适合对Nginx模块开发有基础、或者正在做HTTP/3接入的读者。
1. 先回答一个问题:Nginx为什么非要自己写一套QUIC协议栈
1.1 从quiche分支到主线合并的时间线
很多人知道Nginx支持HTTP/3是最近几年的事,但不知道这个能力最早是从外部开花结果的。2019年前后,Cloudflare用Rust写了quiche库,并基于它给Nginx打了补丁,做成了nginx-quiche这个分支。那套方案能跑,但它本质上是在一个用C写的Web服务器里嵌入了一个Rust协议栈,通过FFI桥接,两边各管各的状态。
Nginx官方团队后来做了一个很重要的决定:不把quiche收编进主线,而是在Nginx的事件框架内用C自研QUIC实现。2022年5月,nginx 1.23.0首次把实验性QUIC支持放进了主线,但当时还比较粗糙。2023年5月的1.25.0正式把HTTP/3和QUIC合并进主线,同年9月的1.25.3做了一次大规模重构,把很多文件打散重排,形成了今天src/event/quic目录下的结构。从这个时间线能看出一个信号:QUIC对Nginx来说不是可选项,而是Web服务器的下一代传输底座。
1.2 为什么不直接调libquiche / msquic
从工程效率角度看,用成熟库是最省事的。可Nginx选择自研,不是因为他们不爱惜头发,而是有几个实际考量。
第一是架构匹配度。Nginx整个生命周期建立在ngx_connection_t和事件驱动上,每个连接都有读写事件、超时定时器、内存池。如果引入quiche,等于在Nginx的进程模型旁边再养一套独立的连接状态机,两边还要互相翻译事件,开发复杂度反而更高。第二是性能控制力。QUIC对收发路径的细节非常敏感,比如批量收包、GSO批量发送、reuseport分流,这些优化要深入到Nginx自己的I/O框架里才做得好。第三是发布节奏。Nginx有自己的维护周期,如果依赖外部库,新版QUIC特性要等库先支持,还会引入ABI绑定问题。
1.3 自研协议栈的隐性成本
当然,自研不是免费的。QUIC协议栈本身包含拥塞控制、丢包重传、流控、密钥更新这些非常复杂的状态机,而且RFC 9000的很多细节是“建议”“可以”,落实成代码时全要靠自己判断。Nginx这一套代码量并不夸张,核心文件加起来也就两三万行,但维护成本极高——每出一个安全公告,可能都要翻一遍加密相关路径。这也是为什么很多公司宁可调库也不自己写。
不过从结果看,Nginx押注在“把QUIC协议栈内嵌到事件框架”这条路上是对的。因为HTTP/3和普通HTTP/2最大的区别,就是传输层和应用层在同一个进程里耦合,Nginx正好是传输层和应用层都抓在手里的服务器。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 13个源文件的完整地图:先搞清楚谁负责什么
2.1 按功能拆成四层
读这一堆ngx_quic_*文件之前,如果按照文件名一个一个啃,很容易迷路。我建议先按功能分层,把13个文件分成四组:包I/O层、连接管理层、帧与流处理层、TLS与密钥适配层。这样你看到某个文件时,能立刻知道它属于哪个环节,读代码时也方便顺着函数调用链往下追。
包I/O层解决的是“UDP数据报怎么收进来、怎么发出去、怎么路由到正确的worker进程和连接对象”。连接管理层解决的是“一条QUIC连接的完整生命周期,包括CID分配、超时关闭、连接迁移”。帧与流处理层是协议栈最大的部分,要解析QUIC帧、维护流状态、处理ACK和丢包。TLS与密钥适配层则把QUIC的握手消息接进TLS库,并管理加密密钥。
2.2 文件与职责对照表
我把13个核心文件按这个逻辑整理成了一张表,列了最关键的结构体或者核心函数方向,读的时候可以拿它当索引。
| 分组 | 源文件 | 核心职责 | 关键入口/结构 |
|---|---|---|---|
| 模块入口 | ngx_quic_module.c | 模块定义、配置指令解析、事件注册 | ngx_quic_module |
| 包I/O | ngx_quic_input.c | UDP收包分发、长包头解析、Initial/Handshake处理 | ngx_quic_input_handler() |
| 包I/O | ngx_quic_output.c | 发送队列调度 |
