2026 年 3 月 11 日，nginx 官方發(fā)布了最新主線版本nginx 1.29.6。本次版本更新不僅在功能和安全性上進行了大量細致優(yōu)化，還正式引入了“上游粘性會話（sticky sessions）”功能，這是對負載均衡能力的里程碑式增強。除了這一重量級改進外，HTTP/2、QUIC、SCGI、IMAP、MP4、Resolver 等模塊也都有實質(zhì)性的修復與提升。本文將詳細解讀此次更新的全部技術(shù)細節(jié)與影響。

一、版本基本信息

• ?版本號：nginx 1.29.6

• ?發(fā)布時間：2026 年 3 月 11 日

• ?版本類型：mainline（主線版本）

• ?發(fā)布來源：github.com/nginx/nginx 與 nginx.org 官方同步

此次更新共計：

• ? 有12 位核心貢獻者參與

• ? 提交31 次 commit

• ? 修改37 個文件

這顯示出該版本不僅是一次常規(guī)維護更新，更是針對新網(wǎng)絡協(xié)議及負載均衡機制的大幅度增強，體現(xiàn)出 nginx 持續(xù)深耕核心性能的方向。

二、總體更新概要

nginx 1.29.6 的更新涵蓋了多個層面，從代理層、協(xié)議支持、會話保持到媒體流處理、解析器與安全機制都有重要改動。
官方更新摘要如下：

• ?版本號更新

• ?修復了啟用緩存的 HTTP/2 上游代理問題

• ?改進了多值請求頭的解析分隔符處理

• ?修復了 SCGI 模塊在非緩沖模式下傳遞 CONTENT_LENGTH 的問題

• ?MP4 模塊增加了同步樣本值驗證

• ?修復了解析器 ngx_resolver_copy() 的越界讀取問題

• ?QUIC 無狀態(tài)重置（Stateless Reset）機制改進

• ?兼容新版 Linux 內(nèi)核的 BPF 編譯問題修復

• ?歡迎頁內(nèi)容更新，添加更多相關(guān)鏈接

• ?QUIC 模塊實現(xiàn)工作進程綁定的無狀態(tài)重置令牌

• ?QUIC 模塊增加了兼容層錯誤回調(diào)處理

• ?構(gòu)建系統(tǒng)支持跳過 F5 CLA 工作流選項

• ?IMAP 郵件模塊多個漏洞修復

• ?上游模塊新增“粘性會話（sticky sessions）”功能

• ?同步更新 zlib（Windows 構(gòu)建使用）

• ?修復若干拼寫錯誤與小問題

這些更新將 nginx 的上游連接管理、QUIC 傳輸層安全邏輯、媒體流驗證、請求頭處理等重要環(huán)節(jié)全面優(yōu)化，使得本版本在穩(wěn)定性、兼容性和負載均衡智能性方面都有顯著增強。

三、核心更新詳解 1. 上游模塊新增“粘性會話（sticky sessions）”支持

這是本次發(fā)布的最重要更新。
粘性會話（sticky sessions）功能允許 nginx 在多臺后端服務器之間進行請求分配時，能夠保持來自同一用戶的會話始終轉(zhuǎn)發(fā)到同一臺后端。這對于使用會話狀態(tài)（如登錄狀態(tài)、購物車信息等）的 Web 應用至關(guān)重要。

新的粘性機制不僅實現(xiàn)了基本的“持久路由”，還引入了多個增強特性：

• ?learn 模式：nginx 可自動學習用戶會話與后端實例的對應關(guān)系，實現(xiàn)自適應會話綁定。

• ?draining 狀態(tài)：在后端服務器下線或維護時，支持平滑退出會話而不影響在線用戶。

• ?cookie 屬性增強：支持httponly、secure屬性以增強安全性。

• ?cookie 域名支持變量化：可以通過變量動態(tài)設置 cookie 域名，以適應多站點或多子域架構(gòu)。

• ?max-age 支持：cookie 可添加過期時間控制，提升會話生命周期精度。

• ?header 參數(shù)支持：允許在 learn 模式下從請求頭中學習綁定信息。

• ?SameSite 屬性支持：支持strict、lax、none三種模式，應對跨域安全需求。

• ?會話重載修復：修復了在 nginx 配置重載后學習到的會話失效問題。

這些更新意味著 nginx 的負載均衡器在企業(yè)級應用場景下的穩(wěn)定性與用戶體驗都將顯著提升，適用于高并發(fā)、高狀態(tài)依賴的業(yè)務系統(tǒng)。

2. Proxy 模塊：修復啟用緩存時的 HTTP/2 上游問題

代理模塊在啟用緩存同時使用 HTTP/2 協(xié)議的場景中，以往存在請求處理異?；蝽憫獊G失的問題。新版本已修復該問題，使得在多維緩存與 HTTP/2 雙重特性同時啟用時仍能保持數(shù)據(jù)一致性與穩(wěn)定高效傳輸。

這對需要利用 HTTP/2 多路復用能力的反向代理場景至關(guān)重要，如微服務架構(gòu)、跨節(jié)點靜態(tài)資源緩存分發(fā)等。

3. 請求頭解析改進：多值 header 的分隔符修復

nginx 修復了在處理含多個值的請求頭時，分隔符解析錯誤的情況。
這可避免 HTTP 請求中多值頭（如Cache-Control、Accept-Encoding）被錯誤拆分的問題，提高代理與后端通信的兼容性與穩(wěn)定性。

4. SCGI 模塊修復：CONTENT_LENGTH 非緩沖傳遞問題

SCGI 模塊在非緩沖模式（unbuffered）下對CONTENT_LENGTH頭的處理存在誤傳問題。新的版本已修復該邏輯，確保 CGI 應用在不緩沖輸入流的場景下仍能準確獲取請求體長度。

此改進對某些需要實時讀取輸入的后端應用尤為重要，如流式上傳接口、持續(xù)輸入腳本等。

5. MP4 模塊增強：同步樣本值驗證

MP4 模塊現(xiàn)在會驗證stss atom（同步樣本表）中的值。此前若該表中含無效或越界數(shù)據(jù)，可能導致視頻播放異?；蚪馕鍪　?br/>此修復使 nginx 的視頻分發(fā)模塊更加穩(wěn)定，對使用 nginx 作為媒體 CDN 節(jié)點的場景具有積極影響。

6. Resolver 修復：越界讀取問題

修復了ngx_resolver_copy()函數(shù)中的 off-by-one 讀取錯誤。
該問題可能在 DNS 解析或緩存復制過程中導致少量內(nèi)存越界，現(xiàn)在已徹底解決，以保障內(nèi)存安全性與穩(wěn)定運行。

7. QUIC 模塊全面優(yōu)化

QUIC 模塊在本次版本中得到了系統(tǒng)性改進，包括安全性、性能與兼容性方面的細節(jié)調(diào)優(yōu)。

主要更新包括：

• ?Stateless Reset 改進：調(diào)整最小包大小、限制重置包長度、重構(gòu)地址哈希邏輯、增加速率限制機制。有效防止過多重置包引發(fā)潛在資源濫用問題。

• ?Linux 內(nèi)核兼容修復：解決新版內(nèi)核下 BPF 編譯失敗的情況，提升版本兼容性。

• ?工作進程綁定令牌：每個 worker 綁定獨立的 stateless reset token，增強安全隔離。

• ?OpenSSL 兼容層錯誤回調(diào)處理：改善處理 keylog 錯誤的邏輯，提高穩(wěn)定性與錯誤可追蹤能力。

通過這一系列優(yōu)化，QUIC 在 nginx 主線版本中的實現(xiàn)已更為成熟與可用于生產(chǎn)環(huán)境。

8. 郵件模塊（Mail）修復增強

郵件代理模塊針對 IMAP 協(xié)議做出兩項關(guān)鍵修復：

• ?更嚴格的字面量驗證：防止 IMAP 請求中不合法的字面量數(shù)據(jù)導致邏輯異常。

• ?修復類型溢出問題：修復 IMAP 字面量長度解析中的類型溢出，確保大數(shù)據(jù)郵件場景安全穩(wěn)定。

這些改進使 nginx 在作為郵件代理或網(wǎng)關(guān)時更符合協(xié)議規(guī)范，減少潛在風險。

9. 歡迎頁更新與構(gòu)建改進

• ?默認歡迎頁面更新：增加官方鏈接與更多文檔入口，讓新用戶能更快了解 nginx 最新資源。

• ?Windows 構(gòu)建更新：升級使用的 zlib 庫版本，確保壓縮模塊在 Windows 環(huán)境下運行更穩(wěn)定。

• ?構(gòu)建系統(tǒng)添加可跳過 F5 CLA 工作流選項：為企業(yè)或社區(qū)構(gòu)建簡化流程。

• ? 版本號上調(diào)以標識所有新改動。

• ? 修復文檔與源代碼中的若干拼寫錯誤，提高代碼整潔度。

• ? 優(yōu)化部分宏定義與狀態(tài)管理邏輯，使代碼層級更明確、更易維護。

這些看似微調(diào)的細節(jié)其實是 nginx 長期高質(zhì)量代碼維護體系的重要體現(xiàn)。

四、多模塊協(xié)同改進的意義

從上述所有更新可以看到，nginx 1.29.6 不僅是一次簡單的補丁發(fā)布，更是一次全棧式的功能深化。
它在以下幾方面影響深遠：

1. 1.負載均衡能力
   新的粘性會話機制徹底解決了傳統(tǒng) nginx 在有狀態(tài)業(yè)務中的瓶頸問題。

2. 2.協(xié)議支持層面
   HTTP/2 與 QUIC 的同時強化，使 nginx 能更好應對現(xiàn)代瀏覽器與多路復用場景。

3. 3.內(nèi)容傳輸穩(wěn)定性
   從 MP4 到 SCGI，修復內(nèi)容長度與同步驗證，大幅提升流媒體與數(shù)據(jù)交互可靠性。

4. 4.系統(tǒng)安全與穩(wěn)定性
   Resolver 越界修復、IMAP 驗證增強、QUIC 安全令牌隔離等，都在底層保證了安全運行。

5. 5.開發(fā)友好性
   新構(gòu)建選項與更新后的歡迎頁讓開發(fā)者體驗進一步優(yōu)化。

這使得 nginx 1.29.6 成為可以放心部署在生產(chǎn)環(huán)境中的主線新版本。

五、總結(jié)與升級建議

nginx 1.29.6 是一次極具價值的更新，尤其適合以下場景升級使用：

• ? 對用戶會話保持敏感的系統(tǒng)（如電商、社交、后臺管理系統(tǒng)）

• ? 采用 HTTP/2 或 QUIC 的高并發(fā)網(wǎng)站

• ? 使用 nginx 作為媒體服務分發(fā)節(jié)點的應用

• ? 需要更穩(wěn)定 DNS 與郵箱代理能力的服務

在升級時建議：

1. 1. 備份原有配置文件

2. 2. 若涉及負載均衡場景，評估是否啟用新粘性模式

3. 3. 確認第三方模塊與新版本兼容性

4. 4. 更新后進行功能性回歸測試，尤其代理與緩存功能

代碼地址：github.com/nginx/nginx

此次主線版本的發(fā)布標志著 nginx 向智能化與安全化負載均衡邁出關(guān)鍵一步。隨著 QUIC、HTTP/3 的逐步標準化，nginx 很可能在接下來的 1.30 系列進一步完善 QUIC 連接管理和會話學習機制，為大規(guī)模分布式架構(gòu)提供更穩(wěn)健的內(nèi)核。

我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業(yè)洞察。 歡迎關(guān)注“福大大架構(gòu)師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來發(fā)展。