全部產品
Search

搜尋本產品

    Container Service for Kubernetes：ALB Ingress Controller

    文件中心

    Container Service for Kubernetes：ALB Ingress Controller

    更新時間：Feb 14, 2026

    ALB Ingress基於阿里雲應用型負載平衡 ALB服務，為叢集中的Service提供統一的入口。本文介紹ALB Ingress Controller的使用說明和變更記錄。

    使用說明

    變更記錄

    2026年01月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.19.1

    2026年02月12日

    最佳化：

    • 最佳化調用OpenAPI時被流控的情境，針對部分錯誤碼提供自動重試能力。

    • 支援Tag Value為空白，新增對Tag Key重複的校正。

    缺陷修複：

    • 修複因 Ingress 事件觸發後端伺服器組建立時，向 Pod 添加 ReadinessGate 時不進行重試的問題。

    • 修複更新監聽日誌配置後，查詢監聽狀態失敗的問題。

    此次升級不會對業務造成影響。

    2026年01月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.19.0

    2026年01月07日

    新增功能：

    • 使用Secret方式指定defaultCertificate時，支援Secret的熱載入。

    • 支援為Ingress同時配置限速+固定響應/重新導向+轉寄至動作。

    最佳化：

    • 最佳化因認證到期導致監聽建立失敗時的報錯資訊。

    • 最佳化Controller調諧效能。

    • 增強 Webhook 的校正能力，增加對以下情境的校正：

      • 自訂轉寄條件中 SourceIP欄位的格式。

      • AclType欄位的值是否為 black或 white。

      • Ingress 中 backend只指定了 service.name但未指定 service.port。

    • Webhook中添加對是否為ALB類型Ingress的判斷。

    缺陷修複：

    • 修複當 AlbConfig中的 tags欄位被完全刪除時，無法清空 ALB 執行個體上對應標籤的問題。

    • 修複極端情境下，刪除 Service 可能導致 Controller 進程 Panic 的問題。

    此次升級不會對業務造成影響。

    2025年07月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.18.0-aliyun.1

    2025年07月04日

    • 預設啟用執行個體託管模式。對於通過 AlbConfig自動建立的ALB執行個體，其監聽和轉寄規則配置將無法在ALB控制台手動修改。該限制僅適用於升級到本版本後建立的ALB執行個體，已有執行個體和複用的執行個體不受影響。

    • 支援在AlbConfig中通過defaultCertificate手動指定預設認證。

    • 最佳化轉寄規則的優先順序排序邏輯，取消order全域唯一限制。

    • 支援ECS Metadata僅加固模式。

    • 修複在查詢非同步任務介面時，因流控可能導致Controller Panic的問題。

    • 修複當HTTPS和QUIC監聽共用同個連接埠時，ACL僅在一個監聽上生效的問題。

    • 在readinessGate等待未就緒Pod時，採用固定等待間隔。

    • 最佳化Admission Webhook中對不包含終結型轉寄動作的校正邏輯。

    此次升級不會對業務造成影響。

    2025年03月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.17.2-aliyun.1

    2025年03月31日

    • 修複當多個命名空間Ingress規則指向的Service名稱相同，但連接埠不同時，伺服器組調諧報錯連接埠不存在的問題。

    • 修複IPv6雙棧叢集下，查詢IPv4類型地址參數錯誤的問題。

    • 分批調用加入或移出安全性群組API時，單次最大安全性群組數量由4調整為9。

    • 當無需添加額外標籤時，跳過API調用。

    此次升級不會對業務造成影響。

    v2.17.1-aliyun.1

    2025年03月18日

    • 支援Gateway API 1.1.0及以上版本。

    此次升級不會對業務造成影響。

    v2.16.0-aliyun.1

    2025年03月04日

    重要

    自該版本起，建立伺服器組將預設開啟後端長串連能力，已經建立的伺服器組不受影響。請在升級前確認該行為變化是否會對業務產生影響。

    • 建立伺服器組時預設啟用長串連。

    • 支援為監聽設定自訂標籤。

    • 支援關閉伺服器組跨AZ能力。

    • 最佳化Service整體調諧效能。

    • 最佳化ReadinessGate功能更新Pod狀態的時機，會在確保所有伺服器組成功更新後再更新Pod狀態。

    • Canary灰階發布需拆分為兩條Ingress或通過自訂轉寄動作實現。如果錯誤地為Ingress直接添加了 Canary 註解，系統將報錯並保留原有轉寄規則。

    此次升級不會對業務造成影響。

    2025年01月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.15.2-aliyun.1

    2025年01月24日

    • 支援在監聽的XForwardedForConfig中配置XForwardedForProcessingMode設定X-Forwarded-For的處理模式，XForwardedForHostEnabled設定開啟X-Forwarded-Host要求標頭。

    • 修複當ValidatingWebhookConfiguration不存在時組件無法啟動的問題。

    • 修複alb.ingress.kubernetes.io/healthcheck-httpcode配置多個值時Webhook校正不通過的問題。

    • 添加對轉寄動作不包含FinalType類型時的檢查。

    • 最佳化建立ALB執行個體時clientToken的計算方式。

    此次升級不會對業務造成影響。

    v2.15.0-aliyun.1

    2025年01月06日

    • 預設開啟ValidatingWebhook，對AlbConfig和Ingress配置進行預檢。

    • 支援配置AScript可程式化指令碼。

    • 限速能力支援設定固定響應。

    • 相容ssl-redirect與限速能力同時使用。

    • 伺服器組會話保持支援自訂Cookie。

    • 支援為自北京時間2025年2月25日00:00:00起建立的ALB執行個體配置安全性群組。

    • 最佳化監聽衝突時的報錯。

    • 添加TLS認證配置與轉寄規則認證不一致時的事件通知。

    • 添加對關聯資源（如頻寬包）有效性的校正。

    • gRPC協議支援通過AlbConfig配置認證。

    • 修複開啟建立者標籤功能後不能使用AlbConfig中tag功能的問題。

    • 修複部分情境下Service調諧持續報錯的問題。

    • 修複AlbConfig配置錯誤時導致組件崩潰的問題。

    此次升級不會對業務造成影響。

    2024年10月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.14.1-aliyun.1

    2024年10月12日

    • 修複配置HTTPS健全狀態檢查失敗的問題。

    此次升級不會對業務造成影響。

    2024年09月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.14.0-aliyun.1

    2024年09月10日

    • 伺服器組健全狀態檢查支援gRPC協議。

    • 支援配置慢啟動。

    • 支援配置串連優雅中斷。

    • 支援伺服器組間會話保持。

    • 修複在某些情況下，ReadinessGate狀態無法被正確更新的問題。

    • 最佳化Secret報錯內容。

    • 最佳化對於configuring狀態伺服器組的調諧邏輯。

    • AlbConfig欄位大小寫相容。

    此次升級不會對業務造成影響。

    2024年07月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.13.2-aliyun.1

    2024年07月23日

    • 修複AlbConfig格式錯誤時會導致Controller崩潰的問題。

    • 修複Flannel網路模式下，ECS和ECI端點混合掛載時權重設定不正確的問題。

    此次升級不會對業務造成影響。

    2024年05月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.13.1-aliyun.1

    2024年05月10日

    • 添加AlbConfig無Ingress關聯時的事件。

    • 修複Flannel網路外掛程式下，端點更新後權重可能設定不正確的問題。

    • 修複當命名空間以數字開頭或命名空間、服務名過長導致伺服器組建立失敗的問題。

    此次升級不會對業務造成影響。

    2024年02月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.12.0-aliyun.1

    2024年02月05日

    • 支援通過alb.ingress.kubernetes.io/server-group-type: Ip註解使用IP類型伺服器組。

    • 支援通過alb.ingress.kubernetes.io/server-group-resource-group-id註解指定伺服器組使用的資源群組。

    • Flannel外掛程式下支援根據Node上Pod的個數，自動為Node配置權重。

    • 自訂轉寄規則支援QPS限速。

    • 建立ALB執行個體時不指定IP地址配置類型（addressAllocateMode）。

    • 支援為X-Forwarded-For頭配置可信IP。

    • 修複AlbConfig中部分欄位由空值配置為false時不生效的問題。

    此次升級不會對業務造成影響。

    2023年11月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.11.1-aliyun.1

    2023年11月20日

    修複當IngressClass未指定時可能會導致Controller崩潰的問題。

    此次升級不會對業務造成影響。

    2023年10月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.11.0-aliyun.1

    2023年10月31日

    重要

    自v2.11.0-aliyun.1版本起，ALB Ingress Controller將不會在AlbConfig中自動更新連接埠資訊，您需要在建立AlbConfig時手動指定所使用的連接埠。關於如何建立AlbConfig的樣本，請參見建立並使用ALB Ingress對外暴露服務。

    • 支援源IP限速功能。

    • 支援鏈路追蹤。

    • 訪問日誌支援記錄自訂Header。

    • 支援配置雙向認證。

    • 更新Ingress規則時，不再自動更新AlbConfig。

    • 當監聽上仍然存在ingress規則時，禁止從AlbConfig中刪除該監聽。

    • 最佳化複用ALB執行個體時的資源刪除行為。

    • 最佳化認證關聯邏輯，支援多頁認證。

    • 修複開啟HTTP2配置錯誤的問題。

    • 修複當轉寄動作配置錯誤時可能會導致controller崩潰的問題。

    • 修複controller重啟時可能不會及時更新後端伺服器組的問題。

    此次升級不會對業務造成影響。

    2023年08月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.10.0-aliyun.1

    2023年08月15日

    • 新增支援為Ingress和ALBConfig添加hash值，以保證ALB Ingress Controller重啟時不會出現預期外的變更。

    • 最佳化例外狀況事件透出。

    • 最佳化使用保留欄位情境下的調和行為。

    • 修複刪除Ingress資源後緩衝不同步問題。

    • 修複節時間點事件處理中斷問題。

    • 最佳化伺服器組同步邏輯。

    此次升級不會對業務造成影響。

    2023年07月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.9.0-aliyun.1

    2023年07月11日

    • Service並發調諧多個伺服器組時避免API限流。

    • 透出Service調和事件。

    • ssl-redirect註解使用最佳化。

    • 認證自動探索過濾國密版本。

    • 修複自訂轉寄規則中cookieConfig調諧的問題。

    • 修複未配置http欄位的Ingress導致controller崩潰的問題。

    • 修複ingress配置多個Action導致變更配置失敗的問題。

    此次升級不會對業務造成影響。

    2023年06月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.8.3-aliyun.1

    2023年06月05日

    • 修複Server調諧不重試問題。

    • 修複自訂轉寄規則設定Key失效問題。

    此次升級不會對業務造成影響。

    2023年05月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.8.2-aliyun.1

    2023年05月25日

    • 修複Pod重啟時可能會導致轉寄規則被刪除的問題。

    • 去除調諧共用頻寬包時的刪除邏輯。

    • 臨時禁用網路類型的更新。

    此次升級不會對業務造成影響。

    v2.8.1-aliyun.1

    2023年05月09日

    • 託管組件支援預設使用多副本進行高可用。

    • 支援建立ALB執行個體時指定資源群組。

    • 健全狀態檢查支援多個狀態代碼。

    • 支援後端伺服器組一致性雜湊。

    • 支援use-regex註解。

    • 支援指定單可用性區域。

    • 支援更新執行個體網路類型。

    • 支援綁定共用頻寬包。

    • 最佳化非同步API介面調用。

    • 最佳化錯誤提示。

    • 修複預設認證與控制台不一致及設定重複問題。

    此次升級不會對業務造成影響。

    2023年03月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.7.0-aliyun.1

    2023年03月14日

    • 最佳化調諧（Reconcile）流程與規則優先順序，提升規則同步速度。

    • 最佳化Event事件通知。

    • 支援直接調和Service到後端伺服器組。

    • 支援直接關聯ACL資源ID。

    • 支援HTTPS和QUIC部署同連接埠。

    • 自訂Action支援多伺服器組、支援重寫，同時相容大小寫。

    • 支援Secret配置認證優先順序高於AlbConfig。

    • 消除逾時時間寫入程式碼。

    • 修複Gzip壓縮配置錯誤。

    此次升級不會對業務造成影響。

    2022年12月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.6.0-aliyun.1

    2022年12月23日

    • 支援ALB資源自訂標籤。

    • 最佳化Event事件通知。

    • 修複Ingress刪除阻塞問題。不加Finalizer，支援無阻塞刪除。

    • 修複IPv6網路類型變更問題。

    • 修複Ingress認證重複發現問題。

    • 修複Canary灰階後端伺服器組標籤錯誤問題。

    此次升級不會對業務造成影響。

    2022年11月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.5.0-aliyun.1

    2022年11月23日

    • 支援Secret認證上傳。

    • 支援自訂Header、Cookie。

    • 設定ACL白名單。

    • 最佳化監聽處理邏輯：監聽錯誤與調和隔離，443監聽錯誤不會影響80調和。

    此次升級不會對業務造成影響。

    2022年08月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.4.0-aliyun.1

    2022年08月10日

    • 支援跨域。

    • 支援後端伺服器長串連。

    • 最佳化監聽刪除處理邏輯。

    此次升級不會對業務造成影響。

    2022年06月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.3.0-aliyun.1

    2022年06月23日

    此次升級不會對業務造成影響。

    2022年04月

    版本號碼

    變更時間

    變更內容

    變更影響

    v2.2.0-aliyun.1

    2022年04月13日

    • 支援Rewrite重寫。您可以在註解中進行相關配置使用Rewrite重寫功能。更多資訊，請參見配置重寫。

    • 支援TCP健全狀態檢查協議。通過發送SYN握手報文來檢測伺服器連接埠是否存活。更多資訊，請參見配置健全狀態檢查。

    • 支援指定TLS安全性原則。當前ALBConfig配置HTTPS監聽時，支援指定TLS安全性原則。更多資訊，請參見指定TLS安全性原則。

    此次升級不會對業務造成影響。