2. Envoy 限流架构总览：全局限流与本地限流架构、限流过滤器链、限流服务组件关系

在微服务网关与 Sidecar 代理中，Envoy 提供了两种核心的限流模式：本地限流（Local Rate Limiting）与全局限流（Global Rate Limiting）。理解这两种模式的架构差异、过滤器链编排方式以及限流服务组件的协作关系，是掌握 Envoy 限流工程应用的基础。

2.1 全局限流 vs. 本地限流：架构对比

2.2 限流过滤器链：请求处理路径

Envoy 的限流能力通过 HTTP 过滤器（HTTP Filter）链实现。在 HTTP 连接管理器中，限流过滤器按照特定顺序插入，形成一条处理流水线：

1. Router Filter（路由过滤器） — 确定请求的目标集群。
2. Rate Limit Filter（限流过滤器） — 根据路由配置触发限流检查。
3. Fault Filter（故障注入过滤器） — 可选，用于测试。
4. Upstream Codec（上游编解码） — 转发请求到上游服务。

限流过滤器本身支持两种操作模式：

• 全局限流模式：将限流描述符（Descriptor）通过 gRPC 发送给外部限流服务，等待决策。
• 本地限流模式：在 Envoy 进程内使用令牌桶算法直接判断，不依赖外部服务。

http_filters:
- name: envoy.filters.http.local_ratelimit
  typed_config:
    "@type": type.googleapis.com/envoy.extensions.filters.http.local_ratelimit.v3.LocalRateLimit
    stat_prefix: http_local_rate_limiter
    _bucket:
      max_tokens: 100
      tokens_per_fill: 10
      fill_interval: 1s
    filter_enabled:
      runtime_key: local_rate_limit_enabled
      default_value:
        numerator: 100
        denominator: HUNDRED
    filter_enforced:
      runtime_key: local_rate_limit_enforced
      default_value:
        numerator: 100
        denominator: HUNDRED
    response_headers_to_add:
      - header:
          key: "X-Local-Rate-Limit"
          value: "true"

2.3 限流服务组件关系：全局限流架构

全局限流架构涉及多个组件的协作，其核心交互流程如下图所示：

2.4 本地限流架构：进程内决策

本地限流架构更为简洁，所有限流逻辑在 Envoy 进程内部完成，无需外部依赖：

2.5 限流服务组件关系总结

Envoy 限流架构中的核心组件及其职责可归纳如下：