文档中心

容器服务

网络组件

ingress-nginx

ingress-nginx

容器服务提供的 ingress-nginx 组件是 Ingress 控制器组件，使用 Nginx 作为反向代理和负载平衡器的 Ingress 控制器。本文主要介绍 ingress-nginx 组件的变更记录。

更多组件相关介绍和使用方法，请参见组件管理。

注意

Nginx Ingress 功能即将下线，详情请参见【产品公告】NGINX Ingress 停止维护公告。

2026.06

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.15.1-vke.1	v1.26 ≤ 集群版本 ≤ v1.34	【邀测·申请试用】维护中	同步社区 v1.15.1 版本，修复 ingress-nginx 的安全漏洞。 CVE-2026-3288 CVE-2026-4342	该版本对正则表达式形式的转发规则做了更严格的校验，配置正则表达式形式的转发规则时，pathType需要设置为ImplementationSpecific。注意若您的集群配置了正则表达式形式的转发规则，且pathType不为 ImplementationSpecific，请先修改pathType为 ImplementationSpecific，再升级组件。建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2026.03

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.14.3-vke.1	v1.26 ≤ 集群版本 ≤ v1.34	维护中说明【邀测·申请试用】：该版本目前处于邀测阶段。如果需要使用，请提交申请。	同步社区 v1.14.3 版本，修复 ingress-nginx 的安全漏洞 CVE-2026-1580。	该版本对正则表达式形式的转发规则做了更严格的校验，配置正则表达式形式的转发规则时，pathType需要设置为ImplementationSpecific。注意若您的集群配置了正则表达式形式的转发规则，且pathType不为 ImplementationSpecific，请先修改pathType为 ImplementationSpecific，再升级组件。建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2025.04

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.11.5-vke.2	v1.26 ≤ 集群版本 ≤ v1.34	维护中	修复了 v1.11.5-vke.1 版本无法以 vci pod 的方式安装的问题。同步社区 v1.11.5 版本，修复 ingress-nginx 的安全漏洞。 CVE-2025-1097 CVE-2025-1098 CVE-2025-1974 CVE-2025-24513 CVE-2025-24514	从低版本的 ingress-nginx 升级到该版本时，需要注意： v1.11.5 的社区版本将AllowSnippetAnnotations调整为默认关闭。此开关表示是否允许用户在 ingress 上设置-snippet形式的注解。如果集群中存在-snippet形式的注解，请在升级 ingress-nginx 前，在 ingress-nginx 的 configmap 中添加 allow-snippet-annotations: true。建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。
v1.11.5-vke.1	v1.26 ≤ 集群版本 ≤ v1.32	维护中	同步开源社区 v1.11.5 版本，修复 ingress-nginx 的安全漏洞： CVE-2025-1097 CVE-2025-1098 CVE-2025-1974 CVE-2025-24513 CVE-2025-24514	从低版本的 ingress-nginx 升级到该版本时，需要注意： v1.11.5 的社区版本将AllowSnippetAnnotations调整为默认关闭。此开关表示是否允许用户在 ingress 上设置-snippet形式的注解。如果集群中存在-snippet形式的注解，请在升级 ingress-nginx 前，在 ingress-nginx 的 configmap 中添加 allow-snippet-annotations: true。建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2024.10

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.10.4-vke.1	集群版本 ≥ v1.26	维护中	同步开源社区 v1.10.4 版本，修复 ingress-nginx 的安全漏洞 CVE-2024-7646。漏洞详细信息，请参见 issue。该版本目前属于灰度版本，如需使用，请联系客户经理申请使用。	ingress-nginx 组件从低版本升级到该版本时需要注意： v1.10.4 的社区版本将 AllowSnippetAnnotations 调整为默认关闭。此开关表示：是否允许用户在 Ingress 上设置-snippet形式的注解。如果集群中存在-snippet形式的注解，请在升级组件版本前，在 ingress-nginx 的 ConfigMap 中添加allow-snippet-annotations: true。建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2024.04

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.9.5-vke.2	集群版本 ≥ v1.28	维护中	安装组件时，支持配置 CLB 的实例规格、可用区、修改保护和计费类型。更新组件时，支持更新 CLB 的实例规格、修改保护和计费类型。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。
v1.9.5-vke.1	集群版本 ≥ v1.28	维护中	支持 Kubernetes v1.28 版本。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2023.12

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.6.4-vke.3	v1.24 ≤ 集群版本 ≤ v1.26	维护中	支持在 ingress-nginx-controller 对应 Service 关联的 CLB 实例上配置 EIP 共享带宽包。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。
v1.3.1-vke.6	v1.20 ≤ 集群版本 ≤ v1.24	维护中	支持在 ingress-nginx-controller 对应 Service 关联的 CLB 实例上配置 EIP 共享带宽包。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2023.04

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.1-vke.5	v1.20 ≤ 集群版本 ≤ v1.24	维护中	默认开放 Prometheus 监控指标 Metrics，允许通过托管 Prometheus 监控 ingress-nginx 组件。更多说明，请参见 Ingress 服务观测。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2023.02

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.1-vke.4	v1.20 ≤ 集群版本 ≤ v1.24	维护中	修复弹性容器部署模式下日志采集问题。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2023.01

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.1-vke.3	v1.20 ≤ 集群版本 ≤ v1.24	维护中	优化组件部署架构。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2022.12

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.1-vke.2	v1.20 ≤ 集群版本 ≤ v1.24	停止维护	支持组件高可用部署。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2022.10

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.3.1-vke.1	v1.20 ≤ 集群版本 ≤ v1.24	停止维护	支持 Kubernetes v1.24 版本。增强组件安全性。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2022.06

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v1.2.1-vke.2	集群版本 = v1.20	维护中	添加并默认开启 Ingress 对象深度检测功能，阻止包含敏感字段的 Ingress 的配置写入。该功能修复了 CVE-2021-25745 问题。支持配置 annotation-value-word-blocklist，阻止包含敏感字段的 Ingress annotations 配置写入。该功能修复了 CVE-2021-25746 问题。增加默认 IngressClass 对象，没有配置 IngressClass 的 Ingress 会被默认的 ingress nginx controller 处理。修复若干稳定性问题。	升级前需检查存量 Ingress 配置是否存在敏感字段。升级后包含敏感字段的 Ingress 将不再生效（敏感字段包括但不限于load_module、lua_package、_by_lua、location、root、proxy_pass、serviceaccount、{、}、'、\"）。建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2022.02

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v0.49.3-vke.1	集群版本 < v1.20	停止维护	优化 Nginx 默认配置。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2022.01

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v0.49.3	集群版本 < v1.20	停止维护	添加allow-snippet-annotations注解，缓解 CVE-2021-25742 漏洞。修复若干稳定性问题。	建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。

2021.10

版本号	Kubernetes 版本兼容性	版本状态	变更内容	变更影响
v0.44.0	集群版本 < v1.20	停止维护	ingress-nginx 组件首次发布。	无

最近更新时间：2026.06.05 14:00:43

这个页面对您有帮助吗？

有用

有用

无用

无用