1
1. 登录 Console → 路由管理 → 创建路由
2
2. 填写基本信息：
3
   - 路由名称：api-route
4
   - 域名：api.example.com
5
   - 路径：/api/*
6
   - 路径类型：Prefix
7
3. 配置后端服务：
8
   - 服务来源：K8s Service
9
   - 服务名称：api-service
10
   - 端口：8080
11
4. 高级配置（可选）：
12
   - 超时：30s
13
   - 重试：3 次
14
   - 限流：1000 QPS
15
5. 保存 → 测试

1
apiVersion: networking.k8s.io/v1
2
kind: Ingress
3
metadata:
4
  name: api-route
5
  namespace: default
6
  annotations:
7
    higress.io/request-timeout: "30s"
8
    higress.io/retry-count: "3"
9
    higress.io/limit-rps: "1000"
10
spec:
11
  ingressClassName: higress
12
  rules:
13
    - host: api.example.com
14
      http:
15
        paths:
16
          - path: /api
17
            pathType: Prefix
18
            backend:
19
              service:
20
                name: api-service
21
                port:
22
                  number: 8080

1
1. Console → 服务来源 → 创建服务来源
2
2. 填写：
3
   - 名称：nacos-prod
4
   - 类型：Nacos
5
   - 服务器地址：nacos.nacos.svc.cluster.local:8848
6
   - 命名空间：prod
7
   - 分组：DEFAULT_GROUP
8
   - 用户名/密码：nacos/nacos
9
3. 保存 → 验证连接

1
apiVersion: networking.higress.io/v1
2
kind: McpBridge
3
metadata:
4
  name: nacos-prod
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
12
      nacosGroups: [DEFAULT_GROUP]
13
      nacosUsername: nacos
14
      nacosPassword: nacos

1
1. Console → 插件市场 → 浏览可用插件
2
2. 选择插件（如：jwt-auth）→ 点击安装
3
3. 填写配置：
4
   - 镜像地址：oci://registry.example.com/plugins/jwt-auth:v1
5
   - 执行阶段：AUTHN
6
   - 优先级：1000
7
   - 插件配置（JSON）：
8
     {
9
       "issuer": "https://auth.example.com",
10
       "jwks_uri": "https://auth.example.com/.well-known/jwks.json"
11
     }
12
4. 选择生效范围：
13
   - 全局
14
   - 指定域名
15
   - 指定路由
16
5. 保存 → 验证插件状态

1
✅ 推荐做法：
2
1. 先在测试环境验证
3
2. 备份所有 CRD 配置
4
3. 使用 --reuse-values 保留自定义配置
5
4. 滚动升级（默认），避免中断
6
5. 升级后立即测试核心路由
7

8
❌ 避免做法：
9
1. 直接升级生产环境（未测试）
10
2. 删除 PVC（丢失配置）
11
3. 同时升级多个组件（Controller + Gateway + Console）
12
4. 忽略版本兼容性（K8s 版本、Istio 版本）

1
# PrometheusRule
2
apiVersion: monitoring.coreos.com/v1
3
kind: PrometheusRule
4
metadata:
5
  name: higress-alerts
6
  namespace: monitoring
7
spec:
8
  groups:
9
    - name: higress
10
      rules:
11
        # 高错误率
12
        - alert: HigressHighErrorRate
13
          expr: |
14
            sum(rate(envoy_http_downstream_rq_5xx[5m]))
15
            /
16
            sum(rate(envoy_http_downstream_rq_total[5m])) > 0.05
17
          for: 2m
18
          labels:
19
            severity: critical
20
          annotations:
21
            summary: "Higress 错误率超过 5%"
22

23
        # 高延迟
24
        - alert: HigressHighLatency
25
          expr: |
26
            histogram_quantile(0.99,
27
              rate(envoy_http_downstream_rq_time_bucket[5m])
28
            ) > 1000
29
          for: 5m
30
          labels:
31
            severity: warning
32
          annotations:
33
            summary: "Higress P99 延迟超过 1s"
34

35
        # 上游不可用
36
        - alert: HigressUpstreamDown
37
          expr: envoy_cluster_upstream_cx_active == 0
38
          for: 1m
39
          labels:
40
            severity: critical
41

42
        # Pod 重启
43
        - alert: HigressPodRestart
44
          expr: |
45
            increase(kube_pod_container_status_restarts_total{
46
              pod=~"higress-.*", namespace="higress-system"
47
            }[1h]) > 3
48
          for: 5m
49
          labels:
50
            severity: warning

1
问题现象
2
   ↓
3
1. 检查 Pod 状态
4
   kubectl get pods -n higress-system
5
   ↓
6
2. 查看日志
7
   kubectl logs -n higress-system deploy/higress-gateway --tail=100
8
   kubectl logs -n higress-system deploy/higress-controller --tail=100
9
   ↓
10
3. 检查配置
11
   kubectl get ingress,wasmplugin,mcpbridge -A
12
   kubectl describe ingress <name>
13
   ↓
14
4. 检查 Envoy 配置
15
   kubectl exec -n higress-system deploy/higress-gateway -- \
16
     curl -s localhost:15000/config_dump
17
   ↓
18
5. 检查上游服务
19
   kubectl get endpoints <service-name>
20
   curl http://<pod-ip>:<port>/health
21
   ↓
22
6. 网络连通性
23
   kubectl exec -n higress-system deploy/higress-gateway -- \
24
     curl -v http://<upstream-service>:<port>