Envoy 流量拓扑基础：Cluster、Endpoint、Listener、Route 配置模型

Envoy 作为服务网格的数据面核心，其流量处理能力建立在四个基础配置模型之上：Listener（监听器）、Route（路由）、Cluster（集群）和 Endpoint（端点）。理解这四个模型及其静态/动态资源管理方式，是掌握 Envoy 流量拓扑的基石。

2.1 四大核心配置模型

Envoy 的流量处理流水线遵循“监听 → 路由 → 转发”的线性路径。每个模型承担明确的职责：

2.2 配置模型关系与流量路径

下图展示了 Envoy 内部四个模型之间的层级关系与流量流转路径：

2.3 静态资源 vs 动态资源

Envoy 支持两种资源配置方式：静态资源（Static）和动态资源（Dynamic）。静态资源在 Envoy 启动时通过配置文件一次性加载，之后不可变更；动态资源则通过 xDS 协议从控制面（如 Istiod）实时获取，支持热更新。

2.4 静态资源配置示例

以下是一个完整的静态资源配置片段，展示了 Listener、Route、Cluster 和 Endpoint 的声明方式：

static_resources:
  listeners:
  - name: listener_http
    address:
      socket_address: { address: 0.0.0.0, port_value: 8080 }
    filter_chains:
    - filters:
      - name: envoy.filters.network.http_connection_manager
        typed_config:
          "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
          stat_prefix: ingress_http
          route_config:
            name: local_route
            virtual_hosts:
            - name: backend
              domains: ["*"]
              routes:
              - match: { prefix: "/api" }
                route: { cluster: service_api }
          http_filters:
          - name: envoy.filters.http.router

  clusters:
  - name: service_api
    connect_timeout: 0.25s
    type: STRICT_DNS
    lb_policy: ROUND_ROBIN
    load_assignment:
      cluster_name: service_api
      endpoints:
      - lb_endpoints:
        - endpoint:
            address:
              socket_address: { address: 10.0.1.10, port_value: 9090 }
        - endpoint:
            address:
              socket_address: { address: 10.0.1.11, port_value: 9090 }

2.5 动态资源与 xDS 协议

动态资源通过以下 xDS API 实现：

• LDS（Listener Discovery Service）：动态下发 Listener 配置，包括端口、过滤器链、TLS 证书等。
• RDS（Route Discovery Service）：动态下发 Route 配置，支持按域名、路径、Header 等条件分流。
• CDS（Cluster Discovery Service）：动态下发 Cluster 配置，包括连接池大小、超时时间、健康检查参数等。
• EDS（Endpoint Discovery Service）：动态下发 Endpoint 列表，实现服务实例的自动发现与摘除。

2.6 动态资源配置示例（bootstrap + xDS）

以下 bootstrap 配置声明 Envoy 通过 xDS 从控制面获取动态资源：

dynamic_resources:
  lds_config:
    api_config_source:
      api_type: GRPC
      transport_api_version: V3
      grpc_services:
      - envoy_grpc:
          cluster_name: xds_cluster
  cds_config:
    api_config_source:
      api_type: GRPC
      transport_api_version: V3
      grpc_services:
      - envoy_grpc:
          cluster_name: xds_cluster

static_resources:
  clusters:
  - name: xds_cluster
    type: STRICT_DNS
    lb_policy: ROUND_ROBIN
    typed_extension_protocol_options:
      envoy.extensions.upstreams.http.v3.HttpProtocolOptions:
        "@type": type.googleapis.com/envoy.extensions.upstreams.http.v3.HttpProtocolOptions
        explicit_http_config:
          http2_protocol_options: {}
    load_assignment:
      cluster_name: xds_cluster
      endpoints:
      - lb_endpoints:
        - endpoint:
            address:
              socket_address: { address: istiod.istio-system.svc.cluster.local, port_value: 15012 }

2.7 静态与动态的混合使用策略

在实际部署中，静态和动态资源并非互斥，而是可以混合使用：