ALB Ingress Controller组件介绍和变更信息-容器计算服务(ACS)-阿里云帮助中心

ALB Ingress Controller基于阿里云应用型负载均衡 ALB，用于管理Ingress流量。本文介绍ALB Ingress Controller组件信息、使用说明和变更记录。

组件介绍

ALB Ingress Controller基于阿里云应用型负载均衡 ALB ，提供了更为强大的Ingress流量管理方式。它兼容Nginx Ingress，具备处理复杂业务路由和证书自动发现的能力，支持HTTP、HTTPS和QUIC协议，完全满足在云原生应用场景下对超强弹性和大规模七层流量处理能力的需求。

ALB Ingress Controller通过API Server获取Ingress资源的变化，动态生成AlbConfig，然后依次创建ALB实例、监听、路由转发规则以及后端服务器组。您可以在ACS集群中部署该组件，通过配置ALB Ingress实现Ingress流量管理。

使用说明

关于如何使用ALB Ingress Controller，请参见ALB Ingress管理。

变更记录

2026年04月

版本号

变更时间

变更内容

变更影响

v2.20.0

2026年04月16日

新增功能：

支持在ListenerSpec的logConfig中通过accessLogRecordCustomizedHeadersAllowDisable: true允许将accessLogRecordCustomizedHeadersEnabled设置为false。
Webhook中新增对仍在被ALB Ingress使用的Service/Secret资源的删除拦截。
Webhook中新增对path类型为Prefix时，path中不能包含通配符*的校验。

优化：

优化Controller内存占用。
默认使用EndpointSlice代替Endpoint进行端点发现。
优化服务器组操作的异步任务等待时间。

缺陷修复：

修复通过AlbConfig修改ALB资源组ID不生效的问题。
修复在使用自定义转发规则时，转发配置错误可能会导致Controller panic的问题。

此次升级不会对业务造成影响。

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`全局唯一限制。修复在查询异步任务接口时，因流控可能导致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。
支持为新建的ALB实例配置安全组。（从北京时间2025年2月25日00:00:00起）
优化监听冲突时的报错。
添加TLS证书配置与转发规则证书不一致时的事件通知。
添加对关联资源（如带宽包）有效性的校验。
gRPC协议支持通过AlbConfig配置证书。
修复开启创建者标签功能后不能使用AlbConfig中tag功能的问题。
修复部分场景下Service调谐持续报错的问题。
修复AlbConfig配置错误时导致组件崩溃的问题。

此次升级不会对业务造成影响。

2024年05月

版本号

变更时间

变更内容

变更影响

v2.13.1-aliyun.1

2024年05月10日

添加AlbConfig无Ingress关联时的事件。
修复命名空间以数字开头、命名空间或服务名过长导致服务器组创建失败的问题。

此次升级不会对业务造成影响。