容器与云原生 / 系统课时
配置 Host 路由
配置 Host 路由
本课解决“同一个入口地址如何按域名把请求送到不同 Service”的问题。你将创建两条 Host 规则,用请求中的 Host 头触发不同后端,并通过实际请求验证命中、未命中和默认行为。
学习目标
- 能用 Ingress 的
host字段配置按域名路由 - 能验证不同 Host 对应不同 Service 的匹配结果
- 能判断 Host 不匹配时应检查的入口配置
Host 路由的匹配逻辑
Ingress 的 Host 路由先比较 HTTP 请求的 Host 与规则中的 spec.rules[].host。Host 匹配后,再在该规则下处理路径;因此,同一个 Ingress 可以把 app.example.test 和 api.example.test 分别交给不同 Service。
这里的“不同域名”不要求真实公网 DNS。实验中直接给请求设置 Host 头即可验证控制器是否按 Host 规则选择后端。

配置两条 Host 规则
下面的示例假设集群已安装可处理 Ingress 的控制器,并使用名为 nginx 的 IngressClass。两个 Service 都在 default Namespace 中,名称分别为 frontend 和 api,端口均为 80。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: demo-host-routing
spec:
ingressClassName: nginx
rules:
- host: app.example.test
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: frontend
port:
number: 80
- host: api.example.test
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: api
port:
number: 80预期结果
ingress.networking.k8s.io/demo-host-routing created配置中的两个 host 是独立匹配条件。app.example.test 只会进入第一条规则,api.example.test 只会进入第二条规则;两条规则都使用 /,因此本例主要演示 Host 的分流作用。
验证 Host 匹配
先查看 Ingress 是否已被控制器接管,再使用同一个入口地址发送不同 Host 的请求。<IP> 代表实际分配给 Ingress Controller 的入口地址。
kubectl get ingress demo-host-routing
curl -H 'Host: app.example.test' http://<IP>/
curl -H 'Host: api.example.test' http://<IP>/
curl -H 'Host: unknown.example.test' http://<IP>/预期结果
NAME CLASS HOSTS ADDRESS PORTS
demo-host-routing nginx app.example.test,api.example.test <IP> 80
<frontend-service response>
<api-service response>
<controller default-backend response or 404>两次已知 Host 的响应应该分别来自 frontend 与 api。未知 Host 不应被错误路由到其中一个显式 Host 规则;具体响应可能是控制器返回的 404 或其默认后端响应,取决于控制器配置。
常见失败定位
如果 Ingress 对象已创建,但两种 Host 得到相同结果,先检查 ingressClassName 是否与实际控制器一致,再确认控制器已经读取该 Ingress。还要核对 Service 名称、端口以及后端 Endpoint 是否存在。
如果只有 Host 不匹配时失败,这是预期现象,不要先去修改 Service。此时优先检查请求实际发送的 Host 头,以及入口是否被其他 Ingress、默认规则或网关策略接管。
Host 路由的关键不是“访问了哪个 IP”,而是入口收到请求后使用哪个 Host 值进行规则匹配。验证时保持入口地址不变,只改变 Host,就能最直接地证明路由是否生效。