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

一、版本基本信息

• ?版本號(hào)：nginx 1.29.6

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

• ?版本類(lèi)型：mainline（主線版本）

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

此次更新共計(jì)：

• ? 有12 位核心貢獻(xiàn)者參與

• ? 提交31 次 commit

• ? 修改37 個(gè)文件

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

二、總體更新概要

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

• ?版本號(hào)更新

• ?修復(fù)了啟用緩存的 HTTP/2 上游代理問(wèn)題

• ?改進(jìn)了多值請(qǐng)求頭的解析分隔符處理

• ?修復(fù)了 SCGI 模塊在非緩沖模式下傳遞 CONTENT_LENGTH 的問(wèn)題

• ?MP4 模塊增加了同步樣本值驗(yàn)證

• ?修復(fù)了解析器 ngx_resolver_copy() 的越界讀取問(wèn)題

• ?QUIC 無(wú)狀態(tài)重置（Stateless Reset）機(jī)制改進(jìn)

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

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

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

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

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

• ?IMAP 郵件模塊多個(gè)漏洞修復(fù)

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

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

• ?修復(fù)若干拼寫(xiě)錯(cuò)誤與小問(wèn)題

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

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

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

新的粘性機(jī)制不僅實(shí)現(xiàn)了基本的“持久路由”，還引入了多個(gè)增強(qiáng)特性：

• ?learn 模式：nginx 可自動(dòng)學(xué)習(xí)用戶會(huì)話與后端實(shí)例的對(duì)應(yīng)關(guān)系，實(shí)現(xiàn)自適應(yīng)會(huì)話綁定。

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

• ?cookie 屬性增強(qiáng)：支持httponly、secure屬性以增強(qiáng)安全性。

• ?cookie 域名支持變量化：可以通過(guò)變量動(dòng)態(tài)設(shè)置 cookie 域名，以適應(yīng)多站點(diǎn)或多子域架構(gòu)。

• ?max-age 支持：cookie 可添加過(guò)期時(shí)間控制，提升會(huì)話生命周期精度。

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

• ?SameSite 屬性支持：支持strict、lax、none三種模式，應(yīng)對(duì)跨域安全需求。

• ?會(huì)話重載修復(fù)：修復(fù)了在 nginx 配置重載后學(xué)習(xí)到的會(huì)話失效問(wèn)題。

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

2. Proxy 模塊：修復(fù)啟用緩存時(shí)的 HTTP/2 上游問(wèn)題

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

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

3. 請(qǐng)求頭解析改進(jìn)：多值 header 的分隔符修復(fù)

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

4. SCGI 模塊修復(fù)：CONTENT_LENGTH 非緩沖傳遞問(wèn)題

SCGI 模塊在非緩沖模式（unbuffered）下對(duì)CONTENT_LENGTH頭的處理存在誤傳問(wèn)題。新的版本已修復(fù)該邏輯，確保 CGI 應(yīng)用在不緩沖輸入流的場(chǎng)景下仍能準(zhǔn)確獲取請(qǐng)求體長(zhǎng)度。

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

5. MP4 模塊增強(qiáng)：同步樣本值驗(yàn)證

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

6. Resolver 修復(fù)：越界讀取問(wèn)題

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

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

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

主要更新包括：

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

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

• ?工作進(jìn)程綁定令牌：每個(gè) worker 綁定獨(dú)立的 stateless reset token，增強(qiáng)安全隔離。

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

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

8. 郵件模塊（Mail）修復(fù)增強(qiáng)

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

• ?更嚴(yán)格的字面量驗(yàn)證：防止 IMAP 請(qǐng)求中不合法的字面量數(shù)據(jù)導(dǎo)致邏輯異常。

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

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

9. 歡迎頁(yè)更新與構(gòu)建改進(jìn)

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

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

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

• ? 版本號(hào)上調(diào)以標(biāo)識(shí)所有新改動(dòng)。

• ? 修復(fù)文檔與源代碼中的若干拼寫(xiě)錯(cuò)誤，提高代碼整潔度。

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

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

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

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

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

2. 2.協(xié)議支持層面
   HTTP/2 與 QUIC 的同時(shí)強(qiáng)化，使 nginx 能更好應(yīng)對(duì)現(xiàn)代瀏覽器與多路復(fù)用場(chǎng)景。

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

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

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

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

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

nginx 1.29.6 是一次極具價(jià)值的更新，尤其適合以下場(chǎng)景升級(jí)使用：

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

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

• ? 使用 nginx 作為媒體服務(wù)分發(fā)節(jié)點(diǎn)的應(yīng)用

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

在升級(jí)時(shí)建議：

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

2. 2. 若涉及負(fù)載均衡場(chǎng)景，評(píng)估是否啟用新粘性模式

3. 3. 確認(rèn)第三方模塊與新版本兼容性

4. 4. 更新后進(jìn)行功能性回歸測(cè)試，尤其代理與緩存功能

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

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

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