4. Listener资源模型：Listener配置结构、Listener过滤器、Listener的TCP/UDP支持

Listener（监听器）是Envoy代理的流量入口，负责在指定端口上接收来自下游的入站连接或数据报。理解Listener的资源模型，是掌握Envoy流量劫持与协议处理的基础。本节将深入剖析Listener的配置结构、过滤器链机制以及其对TCP和UDP协议的支持差异。

4.1 Listener配置结构

Envoy的Listener配置采用分层嵌套的YAML/JSON结构，核心字段包括监听地址、过滤器链、套接字选项等。以下是一个典型的Listener配置骨架：

listeners:
- name: ingress_listener
  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: "/" }
              route: { cluster: backend_service }
        http_filters:
        - name: envoy.filters.http.router
  listener_filters:
  - name: envoy.filters.listener.tls_inspector
    typed_config:
      "@type": type.googleapis.com/envoy.extensions.filters.listener.tls_inspector.v3.TlsInspector
  socket_options:
  - level: 1
    name: 2
    int_value: 1
    state: STATE_PREBIND

4.2 Listener过滤器

Listener过滤器（Listener Filter）在连接被分发到具体的网络过滤器链之前执行，主要用于连接元数据的预检和协议嗅探。Envoy内置了多种Listener过滤器，下表对比了最常用的几种：

4.3 Listener的TCP/UDP支持

Envoy的Listener原生支持TCP和UDP两种传输层协议，但两者的资源模型和配置方式存在显著差异。TCP Listener面向面向连接的流式处理，而UDP Listener则面向无连接的数据报处理。

4.3.1 TCP Listener

TCP Listener是Envoy最成熟的监听模式，支持完整的过滤器链、连接池、健康检查和负载均衡。其核心流程为：

1. 监听端口，接受TCP连接。
2. 通过Listener过滤器（如TLS Inspector）预检连接。
3. 根据filter_chain匹配规则（如SNI、源IP）选择对应的网络过滤器链。
4. 网络过滤器链处理连接，典型如HTTP Connection Manager进行七层路由。

4.3.2 UDP Listener

UDP Listener在Envoy 1.14+中引入，用于处理DNS、QUIC、Syslog等UDP协议。由于UDP无连接特性，其资源模型与TCP有本质区别：

• 无连接概念：每个数据报独立处理，不维护连接状态。
• 过滤器链简化：UDP Listener仅支持UDP专用的网络过滤器（如UDP Proxy、DNS Filter），不支持TCP过滤器。
• 并发模型：UDP Listener通常使用SO_REUSEPORT实现多worker接收，避免锁竞争。

下表总结了TCP与UDP Listener的关键差异：

4.4 Listener资源模型SVG架构图

下图展示了Envoy Listener的完整资源模型，包括配置结构、过滤器链处理流程以及TCP/UDP的分支路径：

4.5 性能调优要点

基于Listener资源模型，以下调优策略可直接提升Envoy的入站吞吐与延迟表现：

• SO_REUSEPORT：在Linux上启用，允许多个worker线程独立监听同一端口，减少锁竞争，提升多核扩展性。
• Listener过滤器精简：仅保留必要的嗅探器（如TLS Inspector），避免在连接建立路径上引入额外开销。
• filter_chain匹配优化：将高频匹配规则前置，减少遍历深度；使用SNI或源IP前缀匹配替代正则表达式。
• UDP Listener专用worker：将UDP Listener绑定到独立线程池，避免与TCP Listener争抢CPU时间片。
• 连接限制与超时：设置合理的per_connection_buffer_limit_bytes和listener_connection_timeout，防止慢连接耗尽资源。