2026 年 3 月 11 日nginx 官方发布了最新主线版本nginx 1.29.6。本次版本更新不仅在功能和安全性上进行了大量细致优化还正式引入了“上游粘性会话sticky sessions”功能这是对负载均衡能力的里程碑式增强。除了这一重量级改进外HTTP/2、QUIC、SCGI、IMAP、MP4、Resolver 等模块也都有实质性的修复与提升。本文将详细解读此次更新的全部技术细节与影响。一、版本基本信息版本号nginx 1.29.6发布时间2026 年 3 月 11 日版本类型mainline主线版本发布来源github.com/nginx/nginx 与 nginx.org 官方同步此次更新共计有12 位核心贡献者参与提交31 次 commit修改37 个文件这显示出该版本不仅是一次常规维护更新更是针对新网络协议及负载均衡机制的大幅度增强体现出 nginx 持续深耕核心性能的方向。二、总体更新概要nginx 1.29.6 的更新涵盖了多个层面从代理层、协议支持、会话保持到媒体流处理、解析器与安全机制都有重要改动。官方更新摘要如下版本号更新修复了启用缓存的 HTTP/2 上游代理问题改进了多值请求头的解析分隔符处理修复了 SCGI 模块在非缓冲模式下传递 CONTENT_LENGTH 的问题MP4 模块增加了同步样本值验证修复了解析器 ngx_resolver_copy() 的越界读取问题QUIC 无状态重置Stateless Reset机制改进兼容新版 Linux 内核的 BPF 编译问题修复欢迎页内容更新添加更多相关链接QUIC 模块实现工作进程绑定的无状态重置令牌QUIC 模块增加了兼容层错误回调处理构建系统支持跳过 F5 CLA 工作流选项IMAP 邮件模块多个漏洞修复上游模块新增“粘性会话sticky sessions”功能同步更新 zlibWindows 构建使用修复若干拼写错误与小问题这些更新将 nginx 的上游连接管理、QUIC 传输层安全逻辑、媒体流验证、请求头处理等重要环节全面优化使得本版本在稳定性、兼容性和负载均衡智能性方面都有显著增强。三、核心更新详解1. 上游模块新增“粘性会话sticky sessions”支持这是本次发布的最重要更新。粘性会话sticky sessions功能允许 nginx 在多台后端服务器之间进行请求分配时能够保持来自同一用户的会话始终转发到同一台后端。这对于使用会话状态如登录状态、购物车信息等的 Web 应用至关重要。新的粘性机制不仅实现了基本的“持久路由”还引入了多个增强特性learn 模式nginx 可自动学习用户会话与后端实例的对应关系实现自适应会话绑定。draining 状态在后端服务器下线或维护时支持平滑退出会话而不影响在线用户。cookie 属性增强支持httponly、secure属性以增强安全性。cookie 域名支持变量化可以通过变量动态设置 cookie 域名以适应多站点或多子域架构。max-age 支持cookie 可添加过期时间控制提升会话生命周期精度。header 参数支持允许在 learn 模式下从请求头中学习绑定信息。SameSite 属性支持支持strict、lax、none三种模式应对跨域安全需求。会话重载修复修复了在 nginx 配置重载后学习到的会话失效问题。这些更新意味着 nginx 的负载均衡器在企业级应用场景下的稳定性与用户体验都将显著提升适用于高并发、高状态依赖的业务系统。2. Proxy 模块修复启用缓存时的 HTTP/2 上游问题代理模块在启用缓存同时使用 HTTP/2 协议的场景中以往存在请求处理异常或响应丢失的问题。新版本已修复该问题使得在多维缓存与 HTTP/2 双重特性同时启用时仍能保持数据一致性与稳定高效传输。这对需要利用 HTTP/2 多路复用能力的反向代理场景至关重要如微服务架构、跨节点静态资源缓存分发等。3. 请求头解析改进多值 header 的分隔符修复nginx 修复了在处理含多个值的请求头时分隔符解析错误的情况。这可避免 HTTP 请求中多值头如Cache-Control、Accept-Encoding被错误拆分的问题提高代理与后端通信的兼容性与稳定性。4. SCGI 模块修复CONTENT_LENGTH 非缓冲传递问题SCGI 模块在非缓冲模式unbuffered下对CONTENT_LENGTH头的处理存在误传问题。新的版本已修复该逻辑确保 CGI 应用在不缓冲输入流的场景下仍能准确获取请求体长度。此改进对某些需要实时读取输入的后端应用尤为重要如流式上传接口、持续输入脚本等。5. MP4 模块增强同步样本值验证MP4 模块现在会验证stss atom同步样本表中的值。此前若该表中含无效或越界数据可能导致视频播放异常或解析失败。此修复使 nginx 的视频分发模块更加稳定对使用 nginx 作为媒体 CDN 节点的场景具有积极影响。6. Resolver 修复越界读取问题修复了ngx_resolver_copy()函数中的 off-by-one 读取错误。该问题可能在 DNS 解析或缓存复制过程中导致少量内存越界现在已彻底解决以保障内存安全性与稳定运行。7. QUIC 模块全面优化QUIC 模块在本次版本中得到了系统性改进包括安全性、性能与兼容性方面的细节调优。主要更新包括Stateless Reset 改进调整最小包大小、限制重置包长度、重构地址哈希逻辑、增加速率限制机制。有效防止过多重置包引发潜在资源滥用问题。Linux 内核兼容修复解决新版内核下 BPF 编译失败的情况提升版本兼容性。工作进程绑定令牌每个 worker 绑定独立的 stateless reset token增强安全隔离。OpenSSL 兼容层错误回调处理改善处理 keylog 错误的逻辑提高稳定性与错误可追踪能力。通过这一系列优化QUIC 在 nginx 主线版本中的实现已更为成熟与可用于生产环境。8. 邮件模块Mail修复增强邮件代理模块针对 IMAP 协议做出两项关键修复更严格的字面量验证防止 IMAP 请求中不合法的字面量数据导致逻辑异常。修复类型溢出问题修复 IMAP 字面量长度解析中的类型溢出确保大数据邮件场景安全稳定。这些改进使 nginx 在作为邮件代理或网关时更符合协议规范减少潜在风险。9. 欢迎页更新与构建改进默认欢迎页面更新增加官方链接与更多文档入口让新用户能更快了解 nginx 最新资源。Windows 构建更新升级使用的 zlib 库版本确保压缩模块在 Windows 环境下运行更稳定。构建系统添加可跳过 F5 CLA 工作流选项为企业或社区构建简化流程。10. 其他小更新与修复版本号上调以标识所有新改动。修复文档与源代码中的若干拼写错误提高代码整洁度。优化部分宏定义与状态管理逻辑使代码层级更明确、更易维护。这些看似微调的细节其实是 nginx 长期高质量代码维护体系的重要体现。四、多模块协同改进的意义从上述所有更新可以看到nginx 1.29.6 不仅是一次简单的补丁发布更是一次全栈式的功能深化。它在以下几方面影响深远负载均衡能力新的粘性会话机制彻底解决了传统 nginx 在有状态业务中的瓶颈问题。协议支持层面HTTP/2 与 QUIC 的同时强化使 nginx 能更好应对现代浏览器与多路复用场景。内容传输稳定性从 MP4 到 SCGI修复内容长度与同步验证大幅提升流媒体与数据交互可靠性。系统安全与稳定性Resolver 越界修复、IMAP 验证增强、QUIC 安全令牌隔离等都在底层保证了安全运行。开发友好性新构建选项与更新后的欢迎页让开发者体验进一步优化。这使得 nginx 1.29.6 成为可以放心部署在生产环境中的主线新版本。五、总结与升级建议nginx 1.29.6 是一次极具价值的更新尤其适合以下场景升级使用对用户会话保持敏感的系统如电商、社交、后台管理系统采用 HTTP/2 或 QUIC 的高并发网站使用 nginx 作为媒体服务分发节点的应用需要更稳定 DNS 与邮箱代理能力的服务在升级时建议备份原有配置文件若涉及负载均衡场景评估是否启用新粘性模式确认第三方模块与新版本兼容性更新后进行功能性回归测试尤其代理与缓存功能六、未来展望代码地址github.com/nginx/nginx此次主线版本的发布标志着 nginx 向智能化与安全化负载均衡迈出关键一步。随着 QUIC、HTTP/3 的逐步标准化nginx 很可能在接下来的 1.30 系列进一步完善 QUIC 连接管理和会话学习机制为大规模分布式架构提供更稳健的内核。