3. Envoy 配置基础：静态配置与动态配置（xDS协议）、Bootstrap文件结构、Admin接口

Envoy 的配置体系是其灵活性与可扩展性的核心。理解静态配置与动态配置的区别、掌握 Bootstrap 文件的骨架结构、以及熟练使用 Admin 接口进行调试，是进行后续代理缓存调优和服务目录冷启动削峰的前提。本章将系统梳理这三个基础模块。

3.1 静态配置 vs 动态配置（xDS 协议）

Envoy 支持两种配置加载方式：静态配置和动态配置。静态配置在 Envoy 启动时通过 Bootstrap 文件一次性加载，后续不发生变化；动态配置则通过 xDS 协议从控制平面（如 Istio Pilot）实时获取更新，实现配置的热加载。

xDS 协议族

xDS 是 Envoy 动态配置的统称，包含多个子协议，每个协议负责管理一类配置资源：

• LDS（Listener Discovery Service）：监听器配置，决定 Envoy 监听哪些端口及如何处理入站流量。
• RDS（Route Discovery Service）：路由配置，定义流量转发规则（域名、路径匹配、权重路由等）。
• CDS（Cluster Discovery Service）：集群配置，定义上游服务端点集合及负载均衡策略。
• EDS（Endpoint Discovery Service）：端点配置，动态更新集群中的具体 IP:Port 列表。
• SDS（Secret Discovery Service）：证书配置，动态管理 TLS 证书和私钥。

3.2 Bootstrap 文件结构

Bootstrap 文件是 Envoy 启动时的“第一口粮”，它定义了 Envoy 的节点身份、管理接口、动态配置的发现端点、以及静态资源（如监听器、集群）。即使后续使用全动态配置，Bootstrap 文件也必须提供 xDS 服务器的连接信息。

核心字段解析

典型 Bootstrap 示例（精简版）

admin:
  address:
    socket_address:
      address: 0.0.0.0
      port_value: 9901

dynamic_resources:
  ads_config:
    api_type: GRPC
    transport_api_version: V3
    grpc_services:
      - envoy_grpc:
          cluster_name: xds_cluster
  cds_config:
    ads: {}
  lds_config:
    ads: {}

static_resources:
  clusters:
    - name: xds_cluster
      type: STRICT_DNS
      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

node:
  id: sidecar~10.0.1.5~productpage-v1-abc123~default.svc.cluster.local
  cluster: productpage-cluster

3.3 Admin 接口

Envoy 的 Admin 接口是一个内置的 HTTP 管理端点，用于查看运行时状态、修改日志级别、触发统计刷新、甚至进行配置转储。在冷启动削峰场景中，Admin 接口是排查“配置是否生效”“端点是否就绪”的第一工具。

常用 Admin 端点

冷启动削峰中的 Admin 使用场景

• 验证端点注入进度：通过 /clusters 查看新服务集群的端点数量是否按预期增长。
• 检查缓存预热状态：通过 /stats 查看 cache.total_hit_count 和 cache.total_miss_count 比值。
• 动态调整日志：在排查问题时，通过 /logging?config=debug 临时开启配置模块的调试日志。
• 配置一致性校验：使用 /config_dump 对比控制平面下发的配置与 Envoy 实际生效的配置是否一致。

3.4 配置加载优先级与覆盖规则

Envoy 的配置来源具有明确的优先级：动态配置 > 静态配置 > Bootstrap 默认值。当动态配置与静态配置冲突时，动态配置优先生效。这一规则在冷启动削峰中尤为重要：

• Bootstrap 中定义的 static_resources 作为“保底配置”，确保 Envoy 启动时至少能处理基础流量。
• 控制平面通过 xDS 推送的配置可以覆盖静态配置中的监听器、路由和集群。
• 运行时配置（Runtime）可以在不重启 Envoy 的前提下，临时调整缓存大小、连接超时等参数，适合削峰期间的快速应急调整。