容器与云原生 / 技术文章
Kubernetes Ingress Controller 到底怎么转发请求
Kubernetes 服务配置了 Ingress 后,很多工程师仍会困惑:真正接收 HTTP 请求的是谁,Ingress 规则什么时候变成可执行配置,请求又如何到达后端 Pod。下面从控制面和数据面拆开这条链路,适合需要理解入口机制的后端工程师、SRE 和平台工程师;读完可以沿着一次真实请求准确定位每个组件的职责。
Ingress 本身不会转发任何请求
Ingress 是 Kubernetes API 中保存 HTTP/HTTPS 路由意图的资源对象。它可以声明 Host、Path、后端 Service、TLS Secret 和 IngressClass,但 Ingress 对象本身没有监听端口,也不会接收网络连接。
例如下面的规则表示:访问 app.example.com/api 的请求应该交给 api Service 的 8080 端口。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: app
spec:
ingressClassName: nginx
rules:
- host: app.example.com
http:
paths:
- path: /api
pathType: Prefix
backend:
service:
name: api
port:
number: 8080这里描述的是期望状态,而不是一条已经存在的网络转发表。要让规则真正生效,集群中必须存在负责这个 IngressClass 的 Ingress Controller。
Controller 把 API 对象变成数据面配置
Ingress Controller 通常是运行在集群中的控制器程序。它会监听 Kubernetes API 中与入口有关的资源变化,例如 Ingress、IngressClass、Service、EndpointSlice 和 Secret,然后把这些对象组合成自身数据面能够执行的配置。
不同实现的内部方式并不完全相同。以常见模式来看,处理过程可以抽象为:Controller 监听资源事件,计算期望路由,更新代理配置,再由 NGINX、HAProxy、Envoy 或其他数据面组件真正处理连接。
因此需要区分两个概念:Controller 负责把 Kubernetes 声明转换成运行配置;数据面代理负责接收每一个真实请求。某些产品把两部分放在同一个 Pod 中,职责边界仍然存在。
可以先检查某条 Ingress 当前由哪个类负责:
kubectl get ingress app -o wide
kubectl get ingressclass
kubectl describe ingress app预期可以看到 Ingress 的 CLASS 或 ingressClassName 与某个 IngressClass 对应,并在事件或状态中观察到控制器处理结果:
NAME CLASS HOSTS ADDRESS PORTS
app nginx app.example.com <IP> 80如果没有匹配的 Controller,即使 Ingress YAML 已成功写入 API Server,也不会因此自动出现能够处理请求的数据面配置。
请求先到入口代理,再匹配 Host 和 Path
当客户端访问 http://app.example.com/api/users 时,请求首先必须通过 DNS、负载均衡器、NodePort 或其他外部网络路径到达 Ingress Controller 的数据面监听地址。
数据面拿到 HTTP 请求后,才开始执行由 Ingress 规则生成的路由配置。通常首先根据 Host 找到候选虚拟主机,再根据 Path 和 pathType 选择具体规则。例如 Host: app.example.com 与 /api/users 可以匹配前面的 /api Prefix 规则,而其他 Host 不会因为路径相同就自动进入这个后端。
可以绕过 DNS,直接向入口地址发送带 Host 的请求验证这一层:
curl -i -H 'Host: app.example.com' http://<IP>/api/users预期结果是入口代理匹配 app.example.com 与 /api 后,把请求交给对应后端;如果 Host 或 Path 未命中,常见结果是控制器自己的默认后端响应或 404:
HTTP/1.1 200 OK
...这里的关键点是:Ingress Controller 并不是根据客户端请求重新查询 Kubernetes API 决定下一跳。正常数据面请求通常直接使用 Controller 已经生成并装载的运行配置。
Service 是逻辑后端,最终流量仍要落到 Pod
Ingress 的标准后端引用指向 Service,而不是直接在规则中列出 Pod IP。Service 提供稳定的服务标识和端口语义,EndpointSlice 则记录当前可用的后端 Endpoint。
假设 Ingress 引用了 api:8080,Controller 会继续观察这个 Service 以及关联的 EndpointSlice。当 Pod 扩缩容、Ready 状态变化或 Endpoint 地址变化时,Controller 或其数据面会更新可转发后端集合。
可以分别查看这两层:
kubectl get service api
kubectl get endpointslice -l kubernetes.io/service-name=api预期可以同时看到 Service 端口以及一个或多个就绪 Endpoint:
NAME TYPE CLUSTER-IP PORT(S)
api ClusterIP <IP> 8080/TCP
ADDRESSTYPE PORTS ENDPOINTS
IPv4 8080 <IP>,<IP>这里容易产生一个误解:入口代理是否一定先把数据包发给 Service 的 ClusterIP。答案取决于具体 Ingress Controller 实现和配置。有些实现直接把 EndpointSlice 中的 Pod Endpoint 写入自己的 upstream,直接选择 Pod;另一些路径可能借助 Service 或集群网络转发。因此,Service 是 Kubernetes API 层面的标准后端引用,但真实数据包的下一跳不能仅凭 Ingress YAML 推断。
一次请求实际上跨过两个不同平面
把整个过程串起来,可以看到 Ingress 路由同时存在控制面链路和数据面链路。
控制面链路是 Ingress/Service/EndpointSlice/Secret → Ingress Controller → 数据面配置。它发生在资源创建、修改以及后端状态变化时,目标是让运行配置持续逼近期望状态。
数据面链路则是 Client → 入口代理 → 匹配 Host/Path → 选择后端 → Pod。它发生在每一个真实请求到来时,强调的是连接建立、规则匹配和请求转发。
这一区分也解释了一个常见现象:kubectl get ingress 能看到完全正确的 YAML,并不等于请求一定成功。资源可能已经存在,但 Controller 没有接纳它;Controller 也可能已经接纳规则,但入口地址、TLS、Service 端口、Endpoint 或 Pod 监听仍然存在问题。
理解转发链路后应该怎样定位问题
遇到入口访问异常时,可以按照真实请求经过的层级检查,而不是只盯着 Ingress YAML。先确认客户端能否到达入口地址,再确认负责该 IngressClass 的 Controller 是否正常;随后检查 Host、Path 和 TLS 是否符合请求,最后沿 Service、EndpointSlice、Pod Ready 状态和应用监听端口向后验证。
例如规则存在但始终返回 404,优先怀疑 Host、Path、pathType 或 Controller 是否真正加载了规则;如果入口返回 502、503 一类上游错误,则更应该继续检查 Service 端口、EndpointSlice 和后端应用,而不是反复修改 Host 规则。
因此,理解 Ingress Controller 转发机制最重要的结论不是记住某个代理的配置文件格式,而是建立清晰的职责模型:Ingress 保存路由意图,Controller 持续协调 Kubernetes 对象,数据面代理处理真实连接,Service 和 EndpointSlice描述可用后端,最终请求才落到具体 Pod。沿着这条链路观察状态,就能判断故障究竟发生在声明、配置生成、入口匹配还是后端转发阶段。