NGINX Ingress controller
Track version updates, security patches, and feature changes for the NGINX Ingress controller add-on.
Because the Ingress NGINX open-source project stopped maintenance and updates after March 2026, Container Service for Kubernetes will discontinue maintenance of the NGINX Ingress controller add-on. Ensure that you fully understand the risks before you use it. For more information, see [Product Announcement] End of maintenance for Nginx Ingress Controller.
Add-on overview
NGINX Ingress controller is built on the Kubernetes community open-source project Ingress NGINX and provides a unified entry point for Services in a cluster. The NGINX Ingress controller code is identical to that of the community Ingress NGINX project. Releases are based on upstream community iterations and use the same version numbers as the community project. NGINX Ingress controller is an unmanaged add-on deployed on nodes in your cluster. You are responsible for its operations and maintenance (O&M), and no service-level agreement (SLA) is provided. It supports extensive customization.
Ingress terms
An Ingress is a Kubernetes resource that acts as the access entry point for cluster services and carries almost all traffic to them. It routes external traffic to internal Service pods through forwarding rules. See Comparison among Nginx Ingresses, ALB Ingresses, and MSE Ingresses.
How NGINX Ingress controller works
The cluster must include an Nginx Ingress Controller to parse Nginx Ingress forwarding rules. The controller receives requests, matches them against the rules, and forwards them to backend Service pods. The relationship among a Service, an Nginx Ingress, and the Nginx Ingress Controller:
-
A Service abstracts one or more identical backend services.
-
An Nginx Ingress defines reverse proxy rules that route HTTP/HTTPS requests to Service pods based on host and URL path.
-
The Nginx Ingress Controller parses Nginx Ingress rules. When an Ingress changes, the controller updates its forwarding rules and routes incoming requests to the appropriate Service pod.
Compatibility between NGINX Ingress controller and cluster versions
When you upgrade the add-on, if the target add-on version is incompatible with the current cluster version, upgrade the cluster first. For instructions, see Upgrade clusters.
|
NGINX Ingress controller version |
Compatible cluster versions |
|
[v1.12.6-release.1, v1.14.5-release.4] |
Version 1.24 and later |
|
[v1.5.1-aliyun.1, v1.11.5-aliyun.1] |
Version 1.22 and later |
|
[v1.1.0-aliyun.1, v1.2.1-aliyun.1] |
Version 1.20 and later |
Risks of outdated versions
The NGINX Ingress controller has ended maintenance for v1.2 and earlier versions. For more information, see the product announcement. Outdated versions of the add-on cannot use the features supported by newer versions or benefit from their bug fixes, and they cannot obtain timely, effective technical support. They also face the risk of security vulnerabilities that cannot be fixed. Upgrade the add-on as soon as possible.
Usage instructions
-
To install or upgrade NGINX Ingress controller, see Manage the Nginx Ingress Controller add-on and Upgrade the NGINX Ingress Controller.
-
To create, view, update, and delete NGINX Ingress in the console or by using kubectl, see Create and use an NGINX Ingress.
-
For information about using NGINX Ingress controller, see Implement phased releases and blue-green deployments using Nginx Ingress, Configure public and private CLB types for Ingress Controller, and Use an Ingress controller to mirror network traffic.
Change history
July 2026
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.14.5-release.4 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.14.5-release.4 |
July 16, 2026 |
Optimization:
Vulnerability fixes:
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
May 2026
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.14.5-release.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.14.5-release.1 |
May 20, 2026 |
Optimization:
Vulnerability fixes:
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
April 2026
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.13.9-release.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.13.9-release.1 |
April 2, 2026 |
Updated to the community v1.13.9 release. For more information, see the full update records. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
March 2026
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.13.8-release.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.13.8-release.1 |
March 16, 2026 |
Updated to the community v1.13.8 release. For more information, see the full update records. Important
v1.13.x changes the logic for obtaining the real client IP address when both
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
December 2025
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.12.6-release.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.12.6-release.1 |
December 11, 2025 |
Updated to the community v1.12.6 release. Important
To improve the security of ingress-nginx, this release changes the default values of some security configurations. If you have used or intend to use features prohibited by these security configurations, carefully assess the security risk. Then manually enable the features by adding configuration to the ConfigMap
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
September 2025
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.11.5-release.2 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.5-release.2 |
September 11, 2025 |
Feature optimizations:
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
March 2025
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.11.5-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.5-aliyun.1 |
March 26, 2025 |
Updated to the community v1.11.5 release and fixed CVE-2025-1097, CVE-2025-1098, CVE-2025-1974, CVE-2025-24513, and CVE-2025-24514. For details, see Security Advisory: NGINX Ingress Controller Vulnerabilities (CVE-2025-1974 and Related CVEs). Important
To fix the CVE-2025-1974 vulnerability, starting with this release, the NGINX Ingress controller add-on keeps the validating admission webhook enabled but disables NGINX native configuration validation by default. If you enable snippet annotations, which are used to customize native NGINX directives, these configurations are no longer prevalidated by the validating admission webhook. Related errors are raised only when NGINX reloads its configuration. Check the NGINX Ingress controller Pod logs after each change to Ingress rules and promptly correct the Ingress configuration based on the relevant error logs. Incorrect configurations do not affect running NGINX Ingress controller Pods, but newly created Pods fail to start during scaling, restarts, or other operations because of configuration errors. Before you change configurations in a production environment, complete full validation of snippet directives in a test environment. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
|
v1.11.4-aliyun.2 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.4-aliyun.2 |
March 19, 2025 |
Optimized node scheduling affinity configuration so that Pods are not scheduled on Lingjun nodes. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
February 2025
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.11.4-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.4-aliyun.1 |
February 12, 2025 |
Updated to the community v1.11.4 release and added customizable topology constraint configuration for the add-on in the console. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
August 2024
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.10.4-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.10.4-aliyun.1 |
August 20, 2024 |
Updated to the community v1.10.4 release and fixed the CVE-2024-7646 vulnerability. For more information about the vulnerability, see Security issue. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
July 2024
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.10.2-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.10.2-aliyun.1 |
July 24, 2024 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
October 2023
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.9.3-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.9.3-aliyun.1 |
October 24, 2023 |
Important
Due to security considerations, the add-on disables all snippet annotations (such as Enabling snippet annotations is not recommended for security and stability reasons. If you need to use them, fully assess the risks and then manually enable them in the ConfigMap
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
September 2023
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.8.2-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.8.2-aliyun.1 |
September 20, 2023 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
June 2023
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.8.0-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.8.0-aliyun.1 |
June 20, 2023 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
May 2023
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.7.0-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.7.0-aliyun.1 |
May 5, 2023 |
Important
This version no longer supports Transport Layer Security (TLS) v1.1 and v1.0 by default. If you upgrade the NGINX Ingress controller to this version, be aware of the impact on your services. For more information about the impact of this issue, see set ssl-protocols config not working after v1.6.4. To force the use of legacy TLS encryption methods, see What are the known issues in earlier versions of the NGINX Ingress Controller?
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
March 2023
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.6.4-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.6.4-aliyun.1 |
March 17, 2023 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
February 2023
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.5.1-aliyun.1 |
registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.5.1-aliyun.1 |
February 10, 2023 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
June 2022
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.2.1-aliyun.1 |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.2.1-aliyun.1 |
June 28, 2022 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
May 2022
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.2.0-aliyun.1 |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.2.0-aliyun.1 |
May 10, 2022 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
April 2022
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.44.0.12-27ae67262-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.12-27ae67262-aliyun |
April 29, 2022 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
March 2022
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.1.2-aliyun.2 |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.2-aliyun.2 |
March 21, 2022 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
January 2022
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.1.0-aliyun.2 |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.0-aliyun.2 |
January 12, 2022 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
December 2021
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v1.1.0-aliyun.1 |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.0-aliyun.1 |
December 17, 2021 |
For more information, see the community Changelog. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
October 2021
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.44.0.9-7b9e93e7e-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.9-7b9e93e7e-aliyun |
October 28, 2021 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
September 2021
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.44.0.5-e66e17ee3-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.5-e66e17ee3-aliyun |
September 6, 2021 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
June 2021
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.44.0.3-8e83e7dc6-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.3-8e83e7dc6-aliyun |
June 1, 2021 |
Fixed the CVE-2021-23017 vulnerability. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
April 2021
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.44.0.2-abf1c6fe4-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.2-abf1c6fe4-aliyun |
April 1, 2021 |
Added compatibility with the log_format field |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
March 2021
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.44.0.1-5e842447b-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.1-5e842447b-aliyun |
March 8, 2021 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
April 2020
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.30.0.1-5f89cb606-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.30.0.1-5f89cb606-aliyun |
April 2, 2020 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
October 2019
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.22.0.5-552e0db-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.5-552e0db-aliyun |
October 24, 2019 |
Supports wildcard domain names, allowlists, and redirect configuration when dynamic Server updates are enabled. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
July 2019
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.22.0.4-5a14d4b-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.4-5a14d4b-aliyun |
July 18, 2019 |
Optimized canary release rules and added support for Perl regular expression matching. |
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
April 2019
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.22.0.3-da10b7f-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.3-da10b7f-aliyun |
April 25, 2019 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
January 2019
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.20.0.2-cc39f1b-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.20.0.2-cc39f1b-aliyun |
January 17, 2019 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |
November 2018
|
Version |
Image URL |
Change date |
Changes |
Impacts |
|
v0.20.0.1-4597ce2-aliyun |
registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.20.0.1-4597ce2-aliyun |
November 29, 2018 |
|
Upgrade during off-peak hours. The change process may briefly interrupt established connections. |