Listener 配置

MOSN listener 配置说明。

本文描述的是 MOSN listener 配置。

  • Listener 配置详细描述了 MOSN 启动时监听的端口，以及对应的端口对应不同逻辑的配置。
  • Listener 的配置可以通过Listener动态接口进行添加和修改。
  1. {
  2.   "name":"",
  3.   "type":"",
  4.   "address":"",
  5.   "bind_port":"",
  6.   "use_original_dst":"",
  7.   "access_logs":[],
  8.   "listener_filters":[],
  9.   "filter_chains":[],
  10.   "stream_filters":[],
  11.   "inspector":"",
  12.   "connection_idle_timeout":""
  13. }

name

用于唯一区分 Listener，如果配置为空，会默认生成一个 UUID 作为 name。在对 Listener 进行动态更新时，使用 name 作为索引，如果 name 不存在，则是新增一个 listener，如果 name 存在则是对 listener 进行更新。

type

标记 Listener 的类型，目前支持 ingress 和 egress 两种类型。不同 type 的 Listener 输出的 tracelog 不同。

address

IP:Port 形式的字符串，Listener 监听的地址，唯一。

bind_port

bool 类型，表示 Listener 是否会占用 address 配置的地址，通常情况下都需要配置为true。

use_original_dst

标记使用的透明代理类型，目前支持 redirect 和 tproxy 两种类型。(v1.2.0 之前为 bool 类型，标记是否开启 redirect 模式的透明代理)

access_logs

一组 access_log 配置。

listener_filters

一组 ListenerFilter 配置，目前 MOSN 仅支持一个 listener_filter。

filter_chains

一组 FilterChain 配置，目前 MOSN 仅支持一个 filter_chain。

stream_filters

一组 stream_filter 配置，目前只在 filter_chain 中配置了 filter 包含 proxy 时生效。

inspector

bool 类型，当此值为 true 时，表示即便 listener 在 filter_chain 中配置开启了 TLS 监听，listener 依然可以处理非 TLS 的请求。

connection_idle_timeout

Duration String，空闲连接超时配置。当 listener 上建立的连接空闲超过配置的超时时间以后，MOSN 会将此连接关闭。

ListenerFilter

MOSN 的 ListenerFilter 配置说明。

FilterChain

MOSN 的 FilterChain 配置说明。

Network Filter

Network Filter 配置。

修改于 2022年12月2日: Bump tar from 4.4.8 to 4.4.19 in /themes/docsy/userguide (942c999)