This topic describes the Nginx Ingress Controller component, including its usage and change history.
Component overview
The Nginx Ingress Controller is based on the open source Kubernetes project Ingress NGINX and provides a unified entry point for services in a cluster. The code implementation is identical to the community's Ingress NGINX. New versions are released in sync with the upstream community, and version numbers are kept consistent. The Nginx Ingress Controller is a non-managed component deployed on your cluster nodes. You are responsible for its operations and maintenance (O&M). It does not come with a Service-Level Agreement (SLA) and supports extensive customization.
Basic concepts of Ingress
In a Kubernetes cluster, an Ingress functions as an access point that exposes Services in the cluster. It distributes most of the network traffic that is destined for the Services in the cluster. An Ingress is a Kubernetes resource object that is used to enable external access to Services in a Kubernetes cluster. You can configure routing rules for an Ingress to route network traffic to backend pods of different Services. For Ingress comparisons in ACK, see Comparison among Nginx Ingresses, ALB Ingresses, and MSE Ingresses
How it works
Ingresses can work as normal only if you deploy an NGINX Ingress controller in the cluster to parse the routing rules of the Ingresses. After the NGINX Ingress controller receives a request that matches a routing rule, the NGINX Ingress controller routes the request to a corresponding backend Service. The backend Service then forwards the request to pods. In a Kubernetes cluster, Services, Ingresses, and the NGINX Ingress controller work in the following process:
A Service is an abstraction of a backend application that runs on a set of replicated pods.
An Ingress contains reverse proxy rules. It controls to which Service pods HTTP or HTTPS requests are routed. For example, requests are routed to different Service pods based on the hosts and URL paths in the requests.
The NGINX Ingress controller is a reverse proxy program that parses Ingress rules. If changes are made to the Ingress rules, the NGINX Ingress controller updates the Ingress rules accordingly. After the NGINX Ingress controller receives a request, it redirects the request to Service pods based on the Ingress rules.
Nginx Ingress Controller and cluster version compatibility
If a component's target version is incompatible with the current cluster version, you must upgrade the cluster first. For more information, see Upgrade cluster.
Nginx Ingress Controller version | Compatible cluster versions |
[v1.5.1-aliyun.1, v1.11.5-aliyun.1] | 1.22 and later |
[v1.1.0-aliyun.1, v1.2.1-aliyun.1] | 1.20 and later |
Risks of outdated versions
Maintenance for Nginx Ingress Controller v1.2 and earlier has been discontinued. For more information, see Product Announcements. Expired versions of this component do not support new features or bug fixes and are not eligible for technical support. This exposes you to security risks from unpatched vulnerabilities. Please upgrade the component promptly.
Usage notes
To install or upgrade the Nginx Ingress Controller component, see Manage the Nginx Ingress Controller component and Upgrade the Nginx Ingress Controller component.
For more information about how to create, view, update, and delete an Nginx Ingress with the console or kubectl, see Create and use an Nginx Ingress to expose services.
For more information, see Use Nginx Ingress for phased releases and blue-green deployments, Configure public and private network access for an Ingress Controller SLB instance, and Use Nginx Ingress to replicate application traffic.
Change history
December 2025
Version | Registry address | Change date | Changes | Impact |
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 community version v1.12.6. | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
September 2025
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
March 2025
Version | Registry address | Change date | Changes | Impact |
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 community version v1.11.5 to fix CVE-2025-1097, CVE-2025-1098, CVE-2025-1974, CVE-2025-24513, and CVE-2025-24514. For more information, see Vulnerability Notice for CVE-2025-1097, CVE-2025-1098, CVE-2025-1974, CVE-2025-24513, and CVE-2025-24514. Important To fix the CVE-2025-1974 vulnerability, the Validation Webhook is enabled by default in this and later versions of the Nginx Ingress Controller component. However, the native NGINX configuration validation logic is now disabled by default. If you enabled snippet annotations (used for custom NGINX native directives), these configurations are no longer pre-validated by the Validation Webhook. Related errors will trigger alerts only when NGINX reloads the configuration. We recommend that you check the Nginx Ingress Controller pod logs after each modification to an Ingress rule and correct the Ingress configuration based on any error logs. Note: An incorrect configuration does not affect running Nginx Ingress pods. However, new pods created during operations such as scale-out or restart will fail to start due to the configuration error. We recommend that you fully validate snippet directives in a staging environment before changing configurations in a production environment. | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
v1.11.4-aliyun.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.4-aliyun.2 | March 19, 2025 | Optimized the node scheduling affinity configuration. Pods are not scheduled to Lingjun nodes. | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
February 2025
Version | Registry address | Change date | Changes | Impact |
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 community version v1.11.4. Added support for configuring custom topology spread constraints for the component in the console. | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
August 2024
Version | Registry address | Change date | Changes | Impact |
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 community version v1.10.4 to fix the CVE-2024-7646 vulnerability. For more information about the vulnerability, see Security issue. | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
July 2024
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
October 2023
Version | Registry address | Change date | Changes | Impact |
v1.9.3-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.9.3-aliyun.1 | October 24, 2023 | Important For security reasons, all snippet annotations (such as For security and stability reasons, we do not recommend that you enable snippet annotations. If you must use them, carefully assess the risks and manually enable them by adding
| Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
September 2023
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
June 2023
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
May 2023
Version | Registry address | Change date | Changes | Impact |
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 the TLS v1.1 and TLS v1.0 encryption methods by default. If you upgrade the Nginx Ingress Controller to this version, be aware of the impact on your services. For more information about this issue, see set ssl-protocols config not working after v1.6.4. To force the use of older TLS versions, see the configurations in Known issues in earlier versions of Nginx Ingress.
| Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
March 2023
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
February 2023
Version | Registry address | Change date | Changes | Impact of Changes |
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. Established connections may be briefly interrupted during the upgrade. |
June 2022
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
May 2022
Version | Registry address | Change date | Changes | Change impact |
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. Established connections may be briefly interrupted during the upgrade. |
April 2022
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
March 2022
Version | Registry address | Change date | Changes | Impact of changes |
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. Established connections may be briefly interrupted during the upgrade. |
January 2022
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
December 2021
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
October 2021
Version | Registry address | Change date | Changes | Impact of the change |
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. Established connections may be briefly interrupted during the upgrade. |
September 2021
Version | Registry address | Change date | Changes | Impact of the Change |
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. Established connections may be briefly interrupted during the upgrade. |
June 2021
Version | Registry Address | Change date | Changes | Impact of changes |
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. Established connections may be briefly interrupted during the upgrade. |
April 2021
Version | Registry address | Change date | Changes | Impact |
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 for the | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
March 2021
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
April 2020
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
October 2019
Version | Registry address | Change date | Changes | Impact |
v0.22.0.5-552e0db-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.5-552e0db-aliyun | October 24, 2019 | Added support for wildcard domain names, whitelists, and redirection configurations when dynamic server updates are enabled. | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
July 2019
Version | Registry address | Change date | Changes | Impact |
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 phased release rules to support Perl regular expression matching. | Upgrade during off-peak hours. Established connections may be briefly interrupted during the upgrade. |
April 2019
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
January 2019
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |
November 2018
Version | Registry address | Change date | Changes | Impact |
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. Established connections may be briefly interrupted during the upgrade. |