视频讲解：Envoy手把手入门视频讲解

Envoy 的 listener filter 列表

下面是可以在加入 listener 的 listener_filter 字段中的 listener filter。这些 filter 的主要作用是检测协议、解析协议，通过它们解析出的信息被用于匹配 filter_chains 中的 filter。

Envoy 支持的 listener_filter： listener filter。

name: envoy.listener.http_inspector

HTTP Inspector 判断应用层的数据是否使用 HTTP 协议，如果是，续继判断 HTTP 协议的版本号（HTTP 1.0、HTTP 1.1、HTTP 2），:

listener_filters:
  - name: "envoy.listener.http_inspector"
    typed_config: {}

name: envoy.listener.original_src

Original Source 用于透明代理，让 uptream 看到的是请求端的 IP，双方均感知不到 envoy 的存在。

Original Source 有点类似于 lvs 的 DR 模式，假设 downstream 的 IP 是 10.1.2.3，envoy 的 IP 是 10.2.2.3。envoy 将报文转发给 upstream 时复用 downstream 的源 IP，upstream 看到的源 IP 是 downstream 的 IP 10.1.2.3，不是 envoy 的 IP 10.2.2.3。

与 lvs 的 DR 模式区别是，在 lvs 中，upsteram 是直接将回应包发送给 downstream，而 envoy 的文档中强调，必须通过配置网络环境，让 uptream 的回应包发送到 envoy ，再由 envoy 转发。

下面是一个使用示例，用到了两个 filter：第一个 filter 是 envoy.listener.proxy_protocol，用途是从代理协议中解析出真实的源 IP，详情见下一节；第二个 filter 是 envoy.listener.original_src ，作用是透传源 IP。

listeners:
- address:
    socket_address:
      address: 0.0.0.0
      port_value: 8888
  listener_filters:
    - name: envoy.listener.proxy_protocol
    - name: envoy.listener.original_src
      config:
        mark: 123

mark 123 设置了被透传的报文需要打上的标记，当 upstream 和 envoy 位于同一台机器上时，将打了标记的报文转发到本地:

iptables  -t mangle -I PREROUTING -m mark     --mark 123 -j CONNMARK --save-mark
iptables  -t mangle -I OUTPUT     -m connmark --mark 123 -j CONNMARK --restore-mark
ip6tables -t mangle -I PREROUTING -m mark     --mark 123 -j CONNMARK --save-mark
ip6tables -t mangle -I OUTPUT     -m connmark --mark 123 -j CONNMARK --restore-mark
ip rule add fwmark 123 lookup 100
ip route add local 0.0.0.0/0 dev lo table 100
ip -6 rule add fwmark 123 lookup 100
ip -6 route add local ::/0 dev lo table 100
echo 1 > /proc/sys/net/ipv4/conf/eth0/route_localnet

上面的设置规则用到一个 linux 知识: local 地址的认定。

如果 envoy 和 upstream 不在同一个 host，需要通过调整网络环境使回应包回到 envoy。

name: envoy.listener.original_dst

Original Destination 用来读取 socket 的配置项 SO_ORIGINAL_DST，在使用透明代理模式时用到，在 envoy 中，用该 filter 获取报文的原始目地地址：

listener_filters:
  - name: "envoy.listener.original_dst"

name: envoy.listener.proxy_protocol

Proxy Protocol 解析代理协议，用该 filter 可以解析出真实的源 IP，已知支持 HAProxy Proxy Protocol（2019-08-09 18:08:01）：

listener_filters:
  - name: envoy.listener.proxy_protocol

name: envoy.listener.tls_inspector

TLS Inspector 用来判断是否使用 TLS 协议，如果是 TLS 协议，解析出 Server Name、Negotiation 信息，解析出来的信息用于 FilterChain 的匹配。

listener_filters:
  - name: "envoy.listener.tls_inspector"
    typed_config: {}