Higress 服务发现 - 我的博客

NOTE
服务发现是网关的核心能力。Higress 支持多种注册中心，通过 McpBridge CRD 统一配置，实现动态服务发现。

服务发现类型对比#

类型	适用场景	动态更新	健康检查	配置复杂度
K8s Service	K8s 原生应用	✅	✅（K8s 内置）	⭐
Nacos	微服务（Spring Cloud/Alibaba）	✅	✅	⭐⭐
Consul	多数据中心、服务网格	✅	✅	⭐⭐⭐
Eureka	Spring Cloud Netflix	✅	✅	⭐⭐
DNS	外部服务、云厂商 LB	⚠️ 依赖 TTL	❌	⭐
静态	固定 IP、测试环境	❌	❌	⭐

K8s Service（原生支持）#

自动发现#

Higress 部署在 K8s 中时，自动监听所有 Service 和 Endpoint，无需额外配置。

1
# 只需创建 Ingress 指向 Service
2
apiVersion: networking.k8s.io/v1
3
kind: Ingress
4
metadata:
5
  name: demo-ingress
6
spec:
7
  ingressClassName: higress
8
  rules:
9
    - host: api.example.com
10
      http:
11
        paths:
12
          - path: /api
13
            pathType: Prefix
14
            backend:
15
              service:
16
                name: my-service      # K8s Service 名称
17
                port:
18
                  number: 8080

工作原理：

1
Higress Controller 监听 K8s API Server
2
   ↓
3
Service/Endpoint 变化 → 触发 reconcile
4
   ↓
5
转换为 Envoy Cluster + Endpoint 配置
6
   ↓
7
通过 xDS 推送到 Higress Gateway
8
   ↓
9
Envoy 动态加载（无需重启）

跨命名空间服务#

1
# 方式 1：在 Ingress 中指定完整服务名
2
backend:
3
  service:
4
    name: my-service.other-namespace.svc.cluster.local
5
    port:
6
      number: 8080
7

8
# 方式 2：用 higress.io/destination 注解
9
metadata:
10
  annotations:
11
    higress.io/destination: "my-service.other-namespace.svc.cluster.local:8080"

Nacos 服务发现#

McpBridge 配置#

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: nacos-bridge
5
  namespace: higress-system
6
spec:
7
  registries:
8
    - name: nacos-prod
9
      type: nacos
10
      nacosServer: nacos.nacos.svc.cluster.local:8848
11
      nacosNamespaceId: prod          # 命名空间 ID（留空为 public）
12
      nacosGroups:
13
        - DEFAULT_GROUP
14
        - ORDER_GROUP
15
      nacosTimeout: 3000              # 超时（毫秒）
16
      # 认证（Nacos 2.x 开启鉴权时需要）
17
      nacosUsername: nacos
18
      nacosPassword: nacos

路由到 Nacos 服务#

1
apiVersion: networking.k8s.io/v1
2
kind: Ingress
3
metadata:
4
  name: order-route
5
  annotations:
6
    # 关键：指定服务来源为 Nacos
7
    higress.io/destination: "order-service.DEFAULT-GROUP.public.nacos"
8
spec:
9
  ingressClassName: higress
10
  rules:
11
    - host: api.example.com
12
      http:
13
        paths:
14
          - path: /order
15
            pathType: Prefix
16
            backend:
17
              resource:
18
                apiGroup: networking.higress.io
19
                kind: McpBridge
20
                name: nacos-bridge

destination 格式：{服务名}.{分组}.{命名空间}.nacos

Nacos 健康检查#

Higress 自动订阅 Nacos 服务列表，Nacos 负责健康检查：

临时实例：客户端心跳（默认 5s），15s 无心跳标记不健康，30s 剔除
持久实例：服务端主动探测（TCP/HTTP/MySQL）

Consul 服务发现#

McpBridge 配置#

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: consul-bridge
5
  namespace: higress-system
6
spec:
7
  registries:
8
    - name: consul-prod
9
      type: consul
10
      consulServer: consul.consul.svc.cluster.local:8500
11
      consulDataCenter: dc1
12
      consulServiceTags:
13
        - production
14
        - v2
15
      consulToken: "your-acl-token"   # Consul ACL Token（可选）

路由到 Consul 服务#

1
metadata:
2
  annotations:
3
    higress.io/destination: "payment-service.consul"
4
spec:
5
  rules:
6
    - host: api.example.com
7
      http:
8
        paths:
9
          - path: /payment
10
            backend:
11
              resource:
12
                apiGroup: networking.higress.io
13
                kind: McpBridge
14
                name: consul-bridge

Eureka 服务发现#

McpBridge 配置#

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: eureka-bridge
5
  namespace: higress-system
6
spec:
7
  registries:
8
    - name: eureka-prod
9
      type: eureka
10
      eurekaServer: http://eureka.eureka.svc.cluster.local:8761/eureka
11
      eurekaTimeout: 3000

路由到 Eureka 服务#

1
metadata:
2
  annotations:
3
    higress.io/destination: "user-service.eureka"

DNS 服务发现#

适用场景#

外部 SaaS API（api.openai.com）
云厂商负载均衡（ALB/SLB 域名）
跨集群服务（通过 DNS 解析）

McpBridge 配置#

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: dns-bridge
5
  namespace: higress-system
6
spec:
7
  registries:
8
    - name: external-api
9
      type: dns
10
      domain: api.openai.com
11
      port: 443
12
      protocol: https
13
      dnsRefreshRate: 60              # DNS 刷新间隔（秒）
14

15
    - name: internal-lb
16
      type: dns
17
      domain: internal-lb.example.com
18
      port: 80
19
      protocol: http
20
      dnsRefreshRate: 30

路由到 DNS 服务#

1
metadata:
2
  annotations:
3
    higress.io/destination: "external-api.dns"
4
spec:
5
  rules:
6
    - host: ai.example.com
7
      http:
8
        paths:
9
          - path: /v1/chat
10
            backend:
11
              resource:
12
                apiGroup: networking.higress.io
13
                kind: McpBridge
14
                name: dns-bridge

静态服务发现#

适用场景#

固定 IP 的后端服务
测试环境
没有注册中心的遗留系统

McpBridge 配置#

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: static-bridge
5
  namespace: higress-system
6
spec:
7
  registries:
8
    - name: legacy-service
9
      type: static
10
      staticServers:
11
        - address: 192.168.1.100:8080
12
          weight: 70
13
        - address: 192.168.1.101:8080
14
          weight: 30

路由到静态服务#

1
metadata:
2
  annotations:
3
    higress.io/destination: "legacy-service.static"

多注册中心混合使用#

场景#

企业同时存在：

K8s 新应用（K8s Service）
传统微服务（Nacos/Eureka）
外部 SaaS（DNS）
遗留系统（静态 IP）

配置示例#

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: multi-bridge
5
  namespace: higress-system
6
spec:
7
  registries:
8
    # Nacos 注册中心
9
    - name: nacos
10
      type: nacos
11
      nacosServer: nacos.nacos.svc.cluster.local:8848
12
      nacosGroups: [DEFAULT_GROUP]
13

14
    # Eureka 注册中心
15
    - name: eureka
16
      type: eureka
17
      eurekaServer: http://eureka:8761/eureka
18

19
    # DNS 外部服务
20
    - name: openai
21
      type: dns
22
      domain: api.openai.com
23
      port: 443
24
      protocol: https
25

26
    # 静态遗留服务
27
    - name: legacy
28
      type: static
29
      staticServers:
30
        - address: 10.0.0.100:8080

路由分发#

1
# K8s 服务（默认，无需 McpBridge）
2
- path: /api/k8s
3
  backend:
4
    service:
5
      name: k8s-service
6
      port: { number: 8080 }
7

8
# Nacos 服务
9
- path: /api/nacos
10
  annotations:
11
    higress.io/destination: "nacos-service.DEFAULT-GROUP.public.nacos"
12

13
# Eureka 服务
14
- path: /api/eureka
15
  annotations:
16
    higress.io/destination: "eureka-service.eureka"
17

18
# DNS 外部服务
19
- path: /api/openai
20
  annotations:
21
    higress.io/destination: "openai.dns"
22

23
# 静态服务
24
- path: /api/legacy
25
  annotations:
26
    higress.io/destination: "legacy.static"

服务发现健康检查#

健康检查机制#

注册中心	健康检查方式	检查频率	剔除策略
K8s	Readiness Probe	按 Pod 配置	Endpoint 移除
Nacos	客户端心跳 / 服务端探测	5s / 自定义	15s 标记不健康，30s 剔除
Consul	TCP/HTTP/gRPC 探测	10s（默认）	3 次失败标记 critical
Eureka	客户端心跳	30s	90s 无心跳剔除
DNS	无（依赖 DNS 解析）	TTL	解析失败即剔除
静态	Envoy 主动健康检查	可配置	可配置

Envoy 主动健康检查（静态/DNS）#

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: static-with-health-check
5
  namespace: higress-system
6
spec:
7
  registries:
8
    - name: my-service
9
      type: static
10
      staticServers:
11
        - address: 10.0.0.100:8080
12
        - address: 10.0.0.101:8080
13
      # Higress 扩展：主动健康检查
14
      healthCheck:
15
        enabled: true
16
        interval: 5s
17
        timeout: 3s
18
        unhealthyThreshold: 3
19
        healthyThreshold: 2
20
        httpHealthCheck:
21
          path: /health
22
          expectedStatus: 200

常见问题#

Q1: Nacos 服务发现不生效#

1
# 1. 检查 McpBridge 状态
2
kubectl get mcpbridge -n higress-system
3
kubectl describe mcpbridge nacos-bridge -n higress-system
4

5
# 2. 检查 Higress Controller 日志
6
kubectl logs -n higress-system deploy/higress-controller | grep nacos
7

8
# 3. 确认 Nacos 服务已注册
9
curl http://nacos-server:8848/nacos/v1/ns/instance/list?serviceName=order-service
10

11
# 4. 确认网络连通性
12
kubectl exec -n higress-system deploy/higress-controller -- \
13
  curl -v http://nacos-server:8848/nacos/

Q2: 服务实例上下线延迟#

1
# 检查 xDS 推送延迟
2
kubectl logs -n higress-system deploy/higress-gateway | grep "cds: update"
3

4
# 调整 Nacos 订阅推送间隔（默认 10s）
5
# 在 McpBridge 中设置 nacosTimeout 更短
6

7
# 检查 Envoy Endpoint 状态
8
kubectl exec -n higress-system deploy/higress-gateway -- \
9
  curl -s localhost:15000/clusters | grep order-service

Q3: 跨命名空间服务无法访问#

1
# 确认 RBAC 权限
2
kubectl auth can-i list services --all-namespaces \
3
  --as=system:serviceaccount:higress-system:higress-controller
4

5
# 确认 Service 存在
6
kubectl get svc my-service -n other-namespace
7

8
# 确认 Endpoint 正常
9
kubectl get endpoints my-service -n other-namespace

复习卡片#

TIP
快速复习清单

6 种服务发现：K8s Service（原生）、Nacos、Consul、Eureka、DNS、静态

K8s Service：自动发现，无需配置，Ingress 直接指向 Service

McpBridge CRD：统一配置非 K8s 服务来源

Nacos destination 格式：{服务名}.{分组}.{命名空间}.nacos

DNS 适用场景：外部 SaaS、云厂商 LB、跨集群服务

静态适用场景：固定 IP、测试环境、遗留系统

健康检查：K8s（Readiness）、Nacos（心跳）、Consul（探测）、Envoy（主动检查）

混合使用：一个 McpBridge 可配置多个 registries

TIP
下一篇：流量治理将讲解限流、熔断、重试、超时、灰度发布、金丝雀、蓝绿部署等流量管理能力。
返回 Higress 学习路线总览 | 合集页