kubernetes/ingress-nginx

GitHub: kubernetes/ingress-nginx

基于NGINX的Kubernetes Ingress控制器,提供HTTP路由和负载均衡能力,但已停止开发并将于2026年终止维护。

Stars: 19481 | Forks: 8530

# Ingress NGINX 停止维护 ## 停止维护 [关于 Ingress NGINX 停止维护您需要了解的信息](https://www.kubernetes.io/blog/2025/11/11/ingress-nginx-retirement/): * 尽力维护将持续到 2026 年 3 月。 * 之后,将不再发布任何版本、错误修复,也不会更新以解决可能发现的任何安全漏洞。 * 现有的 Ingress NGINX 部署不会中断。 * 现有的项目构件(如 Helm charts 和容器镜像)将继续可用。 # Ingress NGINX Controller [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/5691/badge)](https://bestpractices.coreinfrastructure.org/projects/5691) [![Go Report Card](https://goreportcard.com/badge/github.com/kubernetes/ingress-nginx)](https://goreportcard.com/report/github.com/kubernetes/ingress-nginx) [![GitHub license](https://img.shields.io/github/license/kubernetes/ingress-nginx.svg)](https://github.com/kubernetes/ingress-nginx/blob/main/LICENSE) [![GitHub stars](https://img.shields.io/github/stars/kubernetes/ingress-nginx.svg)](https://github.com/kubernetes/ingress-nginx/stargazers) ## 概述 ingress-nginx 曾是一个 Kubernetes 的 Ingress controller,使用 [NGINX](https://www.nginx.org/) 作为反向代理和负载均衡器。 [在 Kubernetes 文档站点上了解更多关于 Ingress 的信息](https://kubernetes.io/docs/concepts/services-networking/ingress/)。 ## 使用警告 如果您尚未使用 ingress-nginx,则不应部署它,因为它[已不再开发](#retiring)。相反,您应该确定一个 [Gateway API](https://gateway-api.sigs.k8s.io/guides/) 实现并使用它。 请勿在多租户 Kubernetes 生产环境中使用。本项目假设能够创建 Ingress 对象的用户是集群管理员。更多信息请参阅 [FAQ](https://kubernetes.github.io/ingress-nginx/faq/#faq)。 ## 故障排除 如果您遇到问题,请查看[故障排除文档](docs/troubleshooting.md), [搜索 issue](https://github.com/kubernetes/ingress-nginx/issues),或者在 Kubernetes Slack 服务器的 [#ingress-nginx-users 频道](https://kubernetes.slack.com/messages/ingress-nginx-users)上与我们交流。 ## 更新日志 有关所有更改,请参阅[版本列表](https://github.com/kubernetes/ingress-nginx/releases)。 有关每个版本的详细更改,请检查该版本的 [changelog-$version.md](./changelog) 文件。 有关 `ingress-nginx` helm chart 的详细更改,请检查特定版本的 changelog 文件夹。 [CHANGELOG-$current-version.md](./charts/ingress-nginx/changelog) 文件。 ### 支持的版本表 ingress-nginx 项目的受支持版本意味着我们已完成 E2E 测试,并且所列版本均通过测试。Ingress-Nginx 版本**可能**在旧版本上运行,但项目不对此做出保证。 | Supported | Ingress-NGINX version | k8s supported version | Alpine Version | Nginx Version | Helm Chart Version | | :-------: | --------------------- | ----------------------------- | -------------- | ------------- | ------------------ | | 🔄 | **v1.15.0** | 1.35, 1.34, 1.33, 1.32, 1.31 | 3.23.3 | 1.27.1 | 4.15.0 | | 🔄 | **v1.14.4** | 1.34, 1.33, 1.32, 1.31, 1.30 | 3.23.3 | 1.27.1 | 4.14.4 | | 🔄 | **v1.14.3** | 1.34, 1.33, 1.32, 1.31, 1.30 | 3.23.2 | 1.27.1 | 4.14.3 | | 🔄 | **v1.14.2** | 1.34, 1.33, 1.32, 1.31, 1.30 | 3.23.2 | 1.27.1 | 4.14.2 | | 🔄 | **v1.14.1** | 1.34, 1.33, 1.32, 1.31, 1.30 | 3.22.2 | 1.27.1 | 4.14.1 | | 🔄 | **v1.14.0** | 1.34, 1.33, 1.32, 1.31, 1.30 | 3.22.2 | 1.27.1 | 4.14.0 | | 🔄 | **v1.13.8** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.23.3 | 1.27.1 | 4.13.8 | | 🔄 | **v1.13.7** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.23.2 | 1.27.1 | 4.13.7 | | 🔄 | **v1.13.6** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.23.2 | 1.27.1 | 4.13.6 | | 🔄 | **v1.13.5** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.22.2 | 1.27.1 | 4.13.5 | | 🔄 | **v1.13.4** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.22.2 | 1.27.1 | 4.13.4 | | 🔄 | **v1.13.3** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.22.1 | 1.27.1 | 4.13.3 | | 🔄 | **v1.13.2** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.22.1 | 1.27.1 | 4.13.2 | | 🔄 | **v1.13.1** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.22.1 | 1.27.1 | 4.13.1 | | 🔄 | **v1.13.0** | 1.33, 1.32, 1.31, 1.30, 1.29 | 3.22.0 | 1.27.1 | 4.13.0 | | | v1.12.8 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.22.2 | 1.25.5 | 4.12.8 | | | v1.12.7 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.22.1 | 1.25.5 | 4.12.7 | | | v1.12.6 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.22.1 | 1.25.5 | 4.12.6 | | | v1.12.5 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.22.1 | 1.25.5 | 4.12.5 | | | v1.12.4 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.22.0 | 1.25.5 | 4.12.4 | | | v1.12.3 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.21.3 | 1.25.5 | 4.12.3 | | | v1.12.2 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.21.3 | 1.25.5 | 4.12.2 | | | v1.12.1 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.21.3 | 1.25.5 | 4.12.1 | | | v1.12.0 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.21.0 | 1.25.5 | 4.12.0 | | | v1.12.0-beta.0 | 1.32, 1.31, 1.30, 1.29, 1.28 | 3.20.3 | 1.25.5 | 4.12.0-beta.0 | | | v1.11.8 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.22.0 | 1.25.5 | 4.11.8 | | | v1.11.7 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.21.3 | 1.25.5 | 4.11.7 | | | v1.11.6 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.21.3 | 1.25.5 | 4.11.6 | | | v1.11.5 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.21.3 | 1.25.5 | 4.11.5 | | | v1.11.4 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.21.0 | 1.25.5 | 4.11.4 | | | v1.11.3 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.20.3 | 1.25.5 | 4.11.3 | | | v1.11.2 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.20.0 | 1.25.5 | 4.11.2 | | | v1.11.1 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.20.0 | 1.25.5 | 4.11.1 | | | v1.11.0 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.20.0 | 1.25.5 | 4.11.0 | | | v1.10.6 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.21.0 | 1.25.5 | 4.10.6 | | | v1.10.5 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.20.3 | 1.25.5 | 4.10.5 | | | v1.10.4 | 1.30, 1.29, 1.28, 1.27,1.26 | 3.20.0 | 1.25.5 | 4.10.4 | | | v1.10.3 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.20.0 | 1.25.5 | 4.10.3 | | | v1.10.2 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.20.0 | 1.25.5 | 4.10.2 | | | v1.10.1 | 1.30, 1.29, 1.28, 1.27, 1.26 | 3.19.1 | 1.25.3 | 4.10.1 | | | v1.10.0 | 1.29, 1.28, 1.27, 1.26 | 3.19.1 | 1.25.3 | 4.10.0 | | | v1.9.6 | 1.29, 1.28, 1.27, 1.26, 1.25 | 3.19.0 | 1.21.6 | 4.9.1 | | | v1.9.5 | 1.28, 1.27, 1.26, 1.25 | 3.18.4 | 1.21.6 | 4.9.0 | | | v1.9.4 | 1.28, 1.27, 1.26, 1.25 | 3.18.4 | 1.21.6 | 4.8.3 | | | v1.9.3 | 1.28, 1.27, 1.26, 1.25 | 3.18.4 | 1.21.6 | 4.8.* | | | v1.9.1 | 1.28, 1.27, 1.26, 1.25 | 3.18.4 | 1.21.6 | 4.8.* | | | v1.9.0 | 1.28, 1.27, 1.26, 1.25 | 3.18.2 | 1.21.6 | 4.8.* | | | v1.8.4 | 1.27, 1.26, 1.25, 1.24 | 3.18.2 | 1.21.6 | 4.7.* | | | v1.7.1 | 1.27, 1.26, 1.25, 1.24 | 3.17.2 | 1.21.6 | 4.6.* | | | v1.6.4 | 1.26, 1.25, 1.24, 1.23 | 3.17.0 | 1.21.6 | 4.5.* | | | v1.5.1 | 1.25, 1.24, 1.23 | 3.16.2 | 1.21.6 | 4.4.* | | | v1.4.0 | 1.25, 1.24, 1.23, 1.22 | 3.16.2 | 1.19.10† | 4.3.0 | | | v1.3.1 | 1.24, 1.23, 1.22, 1.21, 1.20 | 3.16.2 | 1.19.10† | 4.2.5 | 请参阅 [更新 NGINX-Ingress 以使用稳定版 Ingress API (2021年7月26日)](https://kubernetes.io/blog/2021/07/26/update-with-ingress-nginx/) 以便在升级到 Kubernetes 1.22 之前升级到稳定版 Ingress API。 ## 参与 感谢您抽出时间加入我们的社区并开始做出贡献! - 本项目遵守 [Kubernetes 社区行为准则](https://git.k8s.io/community/code-of-conduct.md)。 参与本项目即表示您同意遵守其条款。 - **贡献**:欢迎文档贡献。 - 请阅读 [`CONTRIBUTING.md`](CONTRIBUTING.md) 以了解我们期望的工作流程以及我们要求的开发者原创证书说明。 - 加入我们的 Kubernetes Slack 频道进行开发者讨论:[#ingress-nginx-dev](https://kubernetes.slack.com/archives/C021E147ZA4)。 - 提交 GitHub issues 以反馈文档问题。 - 在开启 issue 之前,请务必阅读 [Issue 报告检查清单](https://github.com/kubernetes/ingress-nginx/blob/main/CONTRIBUTING.md#issue-reporting-guidelines)。不符合指南的 issue **可能会被立即关闭**。 - **支持**: - 加入 [Kubernetes Slack](http://slack.kubernetes.io/) 内的 [#ingress-nginx-users](https://kubernetes.slack.com/messages/CANQGM8BA/) 频道,向维护者和其他用户提问或获取支持。 - 仓库中的 [GitHub issues](https://github.com/kubernetes/ingress-nginx/issues) **仅**用于错误报告和功能请求。 ## 许可证 [Apache License 2.0](https://github.com/kubernetes/ingress-nginx/blob/main/LICENSE)
标签:CISA项目, DNS解析, EVTX分析, Gateway API, Go, HTTP/S 路由, Ingress Controller, NGINX, rizin, Ruby工具, SELinux, 反向代理, 子域名突变, 安全配置, 容器网络, 已弃用, 开源项目, 微服务网关, 提示注入, 日志审计, 服务网格, 流量管理, 请求拦截, 负责任AI, 负载均衡, 集群管理