Nginx 1.29.6 发布：新增上游粘性会话支持，性能与稳定性全面提升

这些更新意味着 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 不仅是一次简单的补丁发布，更是一次全栈式的功能深化。它在以下几方面影响深远：

1. 负载均衡能力：新的粘性会话机制彻底解决了传统 nginx 在有状态业务中的瓶颈问题。
2. 协议支持层面：HTTP/2 与 QUIC 的同时强化，使 nginx 能更好应对现代浏览器与多路复用场景。
3. 内容传输稳定性：从 MP4 到 SCGI，修复内容长度与同步验证，大幅提升流媒体与数据交互可靠性。
4. 系统安全与稳定性：Resolver 越界修复、IMAP 验证增强、QUIC 安全令牌隔离等，都在底层保证了安全运行。
5. 开发友好性：新构建选项与更新后的欢迎页让开发者体验进一步优化。

这使得 nginx 1.29.6 成为可以放心部署在生产环境中的主线新版本。

五、总结与升级建议

nginx 1.29.6 是一次极具价值的更新，尤其适合以下场景升级使用：

• 对用户会话保持敏感的系统（如电商、社交、后台管理系统）
• 采用 HTTP/2 或 QUIC 的高并发网站
• 使用 nginx 作为媒体服务分发节点的应用
• 需要更稳定 DNS 与邮箱代理能力的服务

在升级时建议：

1. 备份原有配置文件
2. 若涉及负载均衡场景，评估是否启用新粘性模式
3. 确认第三方模块与新版本兼容性
4. 更新后进行功能性回归测试，尤其代理与缓存功能

六、未来展望

代码地址：GitHub

此次主线版本的发布标志着 nginx 向智能化与安全化负载均衡迈出关键一步。随着 QUIC、HTTP/3 的逐步标准化，nginx 很可能在接下来的 1.30 系列进一步完善 QUIC 连接管理和会话学习机制，为大规模分布式架构提供更稳健的内核。