基于 Docker 的 Nginx 反向代理，根据容器的 VIRTUAL_HOST 变量自动生成路由配置。
2万3037PythonMIT更新于 5天前
nginx/kubernetes-ingress
面向 Kubernetes 的 Ingress Controller，基于 NGINX 或 NGINX Plus 将外部流量路由到集群内服务。
- Star
- 5,094
- Fork
- 2,056
- 未关闭 Issue
- 190
- 最近提交
- 18小时前
这是什么？
NGINX Ingress Controller 是一个运行在 Kubernetes 集群中的组件，会根据 Ingress 资源配置 NGINX 或 NGINX Plus 负载均衡器。它支持按域名和路径进行内容路由，并可为每个域名做 TLS/SSL 终止，使集群内的应用能够被外部访问。
除标准 Ingress 外，控制器还通过注解和 ConfigMap 提供 NGINX 的扩展功能，并提供 VirtualServer、VirtualServerRoute 资源以实现流量分割等高级路由，以及 TransportServer 资源用于 TCP、UDP 和 TLS 透传。除 HTTP 外，还支持 Websocket、gRPC、TCP 和 UDP 应用的负载均衡。
项目由 NGINX（F5）维护，可通过 Helm Chart 或 Kubernetes 清单安装，并同时提供 NGINX 与 NGINX Plus 的镜像。它与 kubernetes/ingress-nginx 是不同的项目。
核心功能
- 01基于域名和路径的 HTTP 流量路由。
- 02为每个域名提供 TLS/SSL 终止。
- 03支持 HTTP、Websocket、gRPC、TCP 和 UDP 应用的负载均衡。
- 04通过 VirtualServer 资源实现流量分割和高级路由。
- 05通过 TransportServer 资源支持 TLS 透传。
- 06同时兼容 NGINX 开源版和 NGINX Plus。
适用场景
- 将运行在 Kubernetes 集群中的 Web 应用暴露给外部用户。
- 在统一入口为多个服务统一终止 TLS 证书。
- 在发布新版本时对流量进行分割。
- 在 Kubernetes 环境中为 gRPC 或 TCP 服务做负载均衡。
快速上手
- 1
使用 README 中链接的 Helm chart 或 Kubernetes 清单安装控制器
- 2
使用 Cafe 示例或 VirtualServer 基础配置示例，为示例应用配置负载均衡
使用前须知
- 它只能在 Kubernetes 集群内运行。
- 部分功能需要商业产品 NGINX Plus，并受支持合同覆盖。
- 它与 kubernetes/ingress-nginx 中的 NGINX Ingress Controller 是不同的项目。
收录于专题
标签
常见问题
- kubernetes-ingress 是什么？
- 面向 Kubernetes 的 Ingress Controller，基于 NGINX 或 NGINX Plus 将外部流量路由到集群内服务。 NGINX Ingress Controller 是一个运行在 Kubernetes 集群中的组件，会根据 Ingress 资源配置 NGINX 或 NGINX Plus 负载均衡器。它支持按域名和路径进行内容路由，并可为每个域名做 TLS/SSL 终止，使集群内的应用能够被外部访问。
- kubernetes-ingress 可以免费使用吗？用的什么许可证？
- kubernetes-ingress 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
- kubernetes-ingress 还在维护吗？
- 活跃维护中。kubernetes-ingress 最近一次提交是在 2026年11月6日。
- kubernetes-ingress 适合用来做什么？
- 将运行在 Kubernetes 集群中的 Web 应用暴露给外部用户。 在统一入口为多个服务统一终止 TLS 证书。 在发布新版本时对流量进行分割。 在 Kubernetes 环境中为 gRPC 或 TCP 服务做负载均衡。
- kubernetes-ingress 怎么安装和运行？
- 使用 README 中链接的 Helm chart 或 Kubernetes 清单安装控制器 使用 Cafe 示例或 VirtualServer 基础配置示例，为示例应用配置负载均衡
- 在哪里获取 kubernetes-ingress？
- 源代码和安装说明在 GitHub 上：https://github.com/nginx/kubernetes-ingress
概要由 AI 根据项目 README 生成；GitHub 数据每日更新。
相关项目
为 nginx 提供图形化网页界面，无需手动编辑配置文件即可管理虚拟主机、代理、SSL 证书和流转发。
2144151GoMIT维护活跃更新于 13天前
一款带网页管理界面的通用 HTTP 反向代理与转发工具，使用 Go 编写，适合家庭实验室和小型服务器。
5566+14 本周330HTMLAGPL-3.0更新于 3天前
基于 NGINX 的开源云原生 Web 应用防火墙，以反向代理形式保护你的 Web 服务。
1.1万+79 本周669PythonAGPL-3.0更新于 20小时前
基于 NGINX 和 etcd 构建的动态高性能 API 网关，支持路由、认证、限流及 AI 大模型流量管理。
1.7万+26 本周2992LuaApache-2.0维护活跃更新于 昨天
源自淘宝的高性能 Web 服务器与反向代理，兼容 nginx，并增加 HTTP/3、Kubernetes Ingress 等能力。
1.3万+8 本周2508CBSD-2-Clause维护活跃更新于 2个月前