3. Envoy 配置入门：静态配置与动态配置、Bootstrap 配置文件结构、Admin 接口基础

Envoy 的配置体系是理解其行为与性能调优的基石。本章将系统讲解 Envoy 的两种配置模式（静态与动态）、核心的 Bootstrap 配置文件结构，以及用于运行时调试与监控的 Admin 接口。掌握这些基础，是后续进行数据传输优化与门禁策略调整的前提。

3.1 静态配置 vs 动态配置

Envoy 支持两种配置加载方式，分别适用于不同的运维场景。静态配置在启动时一次性加载，变更需重启进程；动态配置则通过 xDS 协议从控制面实时获取，支持热更新。

3.2 Bootstrap 配置文件结构

Bootstrap 是 Envoy 启动时读取的第一个配置文件，它定义了 Envoy 进程的全局行为，包括节点标识、管理接口、动态资源配置入口以及核心的监听器与集群初始设置。其顶层结构如下：

admin:                          # Admin 接口配置
  access_log_path: /tmp/admin_access.log
  address:
    socket_address:
      address: 0.0.0.0
      port_value: 9901

static_resources:               # 静态资源（监听器、集群、Secret）
  listeners:
  - name: listener_0
    address:
      socket_address:
        address: 0.0.0.0
        port_value: 10000
    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: local_service
              domains: ["*"]
              routes:
              - match:
                  prefix: "/"
                route:
                  cluster: service_cluster
          http_filters:
          - name: envoy.filters.http.router
            typed_config:
              "@type": type.googleapis.com/envoy.extensions.filters.http.router.v3.Router

  clusters:
  - name: service_cluster
    connect_timeout: 0.25s
    type: STRICT_DNS
    lb_policy: ROUND_ROBIN
    load_assignment:
      cluster_name: service_cluster
      endpoints:
      - lb_endpoints:
        - endpoint:
            address:
              socket_address:
                address: 127.0.0.1
                port_value: 8080

dynamic_resources:              # 动态资源配置（xDS 端点）
  ads_config:
    api_type: GRPC
    transport_api_version: V3
    grpc_services:
    - envoy_grpc:
        cluster_name: xds_cluster
  cds_config:
    ads: {}
  lds_config:
    ads: {}

node:                           # 节点标识
  cluster: test-cluster
  id: test-id
  metadata:
    role: sidecar

3.3 Admin 接口基础

Admin 接口是 Envoy 内置的 HTTP 管理端点，用于查看运行时状态、修改日志级别、触发统计信息转储、进行健康检查等。它是调试门禁策略与数据传输问题的第一入口。

3.3.1 启用 Admin 接口

在 Bootstrap 配置的 admin 字段中指定监听地址和端口即可启用：

admin:
  access_log_path: /tmp/admin_access.log
  address:
    socket_address:
      address: 0.0.0.0
      port_value: 9901

3.3.2 常用 Admin 端点

3.3.3 使用 Admin 接口调试数据传输

当门禁变更导致数据传输异常时，Admin 接口是快速定位问题的利器。以下是一个典型调试流程：

1. 检查监听器状态： 访问 /listeners，确认门禁端口是否正常监听，过滤器链是否加载。
2. 查看集群健康： 访问 /clusters，检查上游端点是否健康，连接池是否耗尽。
3. 分析统计指标： 访问 /stats，过滤关键字如 downstream_cx_active、upstream_rq_total、upstream_rq_5xx，判断流量是否被正确路由。
4. 导出配置对比： 访问 /config_dump，对比变更前后的配置差异，确认门禁规则是否生效。
5. 动态调整日志： 使用 POST /logging?filter=debug 临时开启过滤器级别的调试日志，观察请求处理细节。

3.4 静态配置与动态配置的混合使用

在实际部署中，静态配置与动态配置并非互斥，而是可以混合使用。常见的模式是：

• 静态定义基础设施： 将 Admin 接口、节点标识、核心监听器（如东西向流量入口）放在 static_resources 中，确保基础服务不依赖控制面。
• 动态管理业务策略： 将路由规则、集群端点、门禁过滤器等频繁变更的部分通过 xDS 动态下发。
• 优先级规则： 动态配置的优先级高于静态配置。当动态配置与静态配置存在同名资源时，动态配置生效。