容器服务提供的 ingress\-nginx 组件是 Ingress 控制器组件，使用 Nginx 作为反向代理和负载平衡器的 Ingress 控制器。本文主要介绍 ingress\-nginx 组件的变更记录。更多组件相关介绍和使用方法，请参见 [组件管理](https://www.volcengine.com/docs/6460/101015)。 ## 2025.04 |版本号 |Kubernetes 版本兼容性 |版本状态 |变更内容 |变更影响 | |---|---|---|---|---| |v1.11.5\-vke.2 |集群版本 ≥ v1.26 |维护中 |* 修复了 v1.11.5\-vke.1 版本无法以 vci pod 的方式安装的问题。|从低版本的 ingress\-nginx 升级到该版本时，需要注意：|\ | | | |* 同步社区 v1.11.5 版本，修复 ingress\-nginx 的安全漏洞。||\ | | | | * [CVE-2025-1097](https://github.com/kubernetes/kubernetes/issues/131007)|* v1.11.5 的社区版本将`AllowSnippetAnnotations`调整为默认关闭。此开关表示是否允许用户在 ingress 上设置`*-snippet`形式的注解。如果集群中存在`*-snippet`形式的注解，请在升级 ingress\-nginx 前，在 ingress\-nginx 的 configmap 中添加 `allow-snippet-annotations: true`。|\ | | | | * [CVE-2025-1098](https://github.com/kubernetes/kubernetes/issues/131008)|* 建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。 |\ | | | | * [CVE-2025-1974](https://github.com/kubernetes/kubernetes/issues/131009)| |\ | | | | * [CVE-2025-24513](https://github.com/kubernetes/kubernetes/issues/131005)| |\ | | | | * [CVE-2025-24514](https://github.com/kubernetes/kubernetes/issues/131006) | | |v1.11.5\-vke.1 |集群版本 ≥ v1.26 |维护中 |同步开源社区 v1.11.5 版本，修复 ingress\-nginx 的安全漏洞：|从低版本的 ingress\-nginx 升级到该版本时，需要注意：|\ | | | |||\ | | | |* [CVE-2025-1097](https://github.com/kubernetes/kubernetes/issues/131007)|* v1.11.5 的社区版本将`AllowSnippetAnnotations`调整为默认关闭。此开关表示是否允许用户在 ingress 上设置`*-snippet`形式的注解。如果集群中存在`*-snippet`形式的注解，请在升级 ingress\-nginx 前，在 ingress\-nginx 的 configmap 中添加 `allow-snippet-annotations: true`。|\ | | | |* [CVE-2025-1098](https://github.com/kubernetes/kubernetes/issues/131008)|* 建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。 |\ | | | |* [CVE-2025-1974](https://github.com/kubernetes/kubernetes/issues/131009)| |\ | | | |* [CVE-2025-24513](https://github.com/kubernetes/kubernetes/issues/131005)| |\ | | | |* [CVE-2025-24514](https://github.com/kubernetes/kubernetes/issues/131006) | | ## 2024.10 |版本号 |Kubernetes 版本兼容性 |版本状态 |变更内容 |变更影响 | |---|---|---|---|---| |v1.10.4\-vke.1 |集群版本 ≥ v1.26 |维护中 |* 同步开源社区 v1.10.4 版本，修复 ingress\-nginx 的安全漏洞 CVE\-2024\-7646。漏洞详细信息，请参见 [issue](https://github.com/kubernetes/kubernetes/issues/126744)。|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 服务观测](https://www.volcengine.com/docs/6460/1214009)。 |建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。 | ## 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 的配置写入。|* 升级前需检查存量 Ingress 配置是否存在敏感字段。|\ | | | | 该功能修复了 [CVE-2021-25745](https://nvd.nist.gov/vuln/detail/CVE-2021-25745) 问题。| 升级后包含敏感字段的 Ingress 将不再生效（敏感字段包括但不限于`load_module`、`lua_package`、`_by_lua`、`location`、`root`、`proxy_pass`、`serviceaccount`、`{`、`}`、`'`、`\"`）。|\ | | | |* 支持配置 annotation\-value\-word\-blocklist，阻止包含敏感字段的 Ingress annotations 配置写入。|* 建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。 |\ | | | | 该功能修复了 [CVE-2021-25746](https://nvd.nist.gov/vuln/detail/CVE-2021-25746) 问题。| |\ | | | |* 增加默认 IngressClass 对象，没有配置 IngressClass 的 Ingress 会被默认的 ingress nginx controller 处理。| |\ | | | |* 修复若干稳定性问题。 | | ## 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](https://nvd.nist.gov/vuln/detail/CVE-2021-25742) 漏洞。|建议在业务低峰期升级。变更过程中可能会导致已经建立的连接发生瞬断，变更完成后会自动恢复。 |\ | | | |* 修复若干稳定性问题。 | | ## 2021.10 |版本号 |Kubernetes 版本兼容性 |版本状态 |变更内容 |变更影响 | |---|---|---|---|---| |v0.44.0 |集群版本 < v1.20 |停止维护 |ingress\-nginx 组件首次发布。 |无 |