在 Kubernetes 裡,Ingress 控制器負責把外部的網址請求轉送到對應的服務。社群維護的 ingress-nginx 是其中最普及的一個,Kubernetes 官方引述 Datadog 的研究,約有一半的雲原生環境依賴它。
但這個專案已在 2026 年 3 月正式停止維護。到了 11 月,新漏洞出現時官方已明確表示不會修正。還沒遷移的團隊,現在就是該行動的時候。
ingress-nginx 為什麼停止維護?
Kubernetes 在 2025 年 11 月 11 日宣布退役計畫,並在 2026 年 1 月 29 日由指導委員會與安全回應委員會發表聯合聲明。聲明指出,這個被大量使用的專案長期只有一到兩位維護者利用空閒時間支撐,即使現在有人願意投入,也不會再繼續維護。
依官方說明,2026 年 3 月之後不再有新版本、錯誤修正,也不會為任何安全漏洞發布修補,GitHub 專案改為唯讀。最後一批版本是 2026 年 3 月 19 日發布的 1.15.1、1.14.5 與 1.13.9。
停止維護代表什麼?還能繼續用嗎?
既有部署會繼續運作,Helm chart 與映像檔也還能取得,所以不會在某天突然失效。真正的問題是安全修補:
- 2026 年 11 月 5 日公布的 CVE-2026-116472,官方明確表示因為維護已在 3 月結束,不會發布修正。
- 最後一版內含 nginx 1.27.1,且 HTTP/2 預設開啟。依版本範圍推論,很可能落在 11 月 nginx2root 漏洞的影響範圍內,但 Kubernetes 官方沒有發布相關說明。
- 官方聯合聲明直接表示,退役後繼續使用會讓你和你的使用者暴露在攻擊風險中。
⚠️ 注意
官方聲明也提醒,市面上沒有可以直接替換的方案。遷移需要規劃與工程時間,越晚開始,越可能在漏洞出現時來不及處理。
怎麼確認叢集有沒有在用?
官方建議用以下指令檢查,有列出 Pod 就代表正在使用:
kubectl get pods --all-namespaces --selector app.kubernetes.io/name=ingress-nginx
同時列出所有 Ingress 資源與它們使用的註解(annotation),這份清單是後續遷移的主要依據。特別留意自訂 nginx 設定片段、驗證、轉址與速率限制這類較難轉換的註解。
要遷移到哪裡?
| 方向 | 說明 | 適合情境 |
|---|---|---|
| Gateway API | Kubernetes 官方推薦的新一代流量管理標準,需搭配一個實作 | 願意調整架構、希望長期跟著官方標準走 |
| 其他仍有維護的 Ingress 控制器 | 保留 Ingress 資源寫法,換成其他控制器,例如 F5 的 NGINX Ingress Controller | 想降低一次改動的範圍 |
不論選哪一種,原本依賴 ingress-nginx 專屬註解的設定,多半都要改寫成新方案的寫法。
遷移步驟怎麼排?
- 盤點所有 Ingress 資源、使用的註解與對外網域,標出驗證、轉址、速率限制等關鍵設定。
- 選定目標方案,在測試叢集安裝。
- 用 Ingress2Gateway 1.0 產生 Gateway API 設定,它支援超過 30 種 ingress-nginx 註解,但結果仍需人工檢查。
- 在測試環境逐一驗證網址、憑證、驗證與轉址行為。
- 正式環境先並行運作新舊控制器,再分批切換 DNS 或負載平衡器。
- 確認流量全部轉移後,移除 ingress-nginx。
💡 小提醒
遷移期間仍要維持基本防護:限制管理介面的存取來源、更新叢集節點的作業系統,並監控 ingress 的錯誤記錄。憑證的自動續期也要一併確認,可參考憑證效期縮短後的自動續期設定。
雲端與容器環境的資安範圍比單一主機更廣,盤點方式可以參考網頁安全的攻擊面盤點。需要協助評估遷移方案,可以透過資訊安全守護服務或聯絡我們。
參考資料
- Ingress NGINX Retirement: What You Need to Know — Kubernetes,2025-11-11(英文,國際,2026-11-21 查證)
- Ingress NGINX: Statement from the Kubernetes Steering and Security Response Committees — Kubernetes,2026-01-29(英文,國際,2026-11-21 查證)
- Before You Migrate: Ingress-NGINX — Kubernetes,2026-02-27(英文,國際,2026-11-21 查證)
- Announcing Ingress2Gateway 1.0 — Kubernetes,2026-03-20(英文,國際,2026-11-21 查證)
- ingress-nginx CVE-2026-116472 — oss-security,2026-11-05(英文,國際,2026-11-21 查證)
- ingress-nginx ConfigMap(use-http2) — ingress-nginx 文件(英文,國際,2026-11-21 查證)
ℹ️ 關於本文
本文依 2026 年 11 月 21 日查閱的官方公告與資安研究整理,漏洞細節、受影響版本與修補版本可能隨官方更新而調整,實際請以官方公告為準。文中的設定與指令是一般性範例,套用前請先在測試環境確認;如果不確定自己的網站或主機有沒有受影響,可以聯絡瞻新資訊協助盤點。
常見問題
ingress-nginx 和 NGINX Ingress Controller 是同一個嗎?
不是。Kubernetes 官方說明,ingress-nginx 是社群維護、已停止維護的專案;NGINX Ingress Controller 是 F5 開發的另一個產品,兩者除了都用 nginx 之外沒有關係。F5 的產品仍有維護,11 月的 nginx2root 也已釋出修補版本。
停止維護後,現有的 ingress-nginx 會不能用嗎?
不會。既有部署會繼續運作,Helm chart 與映像檔也還能下載。問題在於之後發現的漏洞都不會修補,Kubernetes 官方聲明直接表示,繼續使用會讓你和你的使用者暴露在攻擊風險中。
Ingress2Gateway 可以一鍵完成轉換嗎?
不行。Ingress2Gateway 1.0 支援超過 30 種 ingress-nginx 註解,但官方定位是遷移助手,轉換結果仍需人工檢查,無法對應的設定也要另外處理,並在測試環境驗證。