Table of Contents

监听器与端口

监听器(listener)是数据口的配置实体:一个监听器=一个(地址,端口)+协议模式+ 可选 TLS/直通规则。发布态监听器驱动 worker 数据口热起停。

实体结构

{
  "port": 5010,
  "address": "0.0.0.0",
  "protocol": "auto",
  "maxConnections": 10000,
  "handshakeTimeoutMs": 10000,
  "idleTimeoutMs": 300000,
  "probeTimeoutMs": 5000
}
字段 缺省 语义
port 必填(1..65535) 监听端口
address — 绑定地址——IP 字面量(监听面起停零 DNS 依赖;域名解析是部署态决策)
protocol auto auto|http|tcp|socks5
maxConnections 10000 监听级连接上限(显式 0=无限;负数编译拒绝)
handshakeTimeoutMs 10000 SOCKS5/CONNECT 握手超时
idleTimeoutMs 300000 L4 直通/裸流/CONNECT 隧道空闲超时
probeTimeoutMs 5000 首包探测超时

协议探测与分派

protocol: auto 时按连接首包探测自动分派(零丢失:首包回放给分支处理器):

探测结果 判定 去向
TLS ClientHello TLS(解析出 SNI) TLS 终止进 HTTP 管线/按 SNI 规则直通
SOCKS5 greeting SOCKS5 SOCKS5 服务器流程
HTTP 报文头 HTTP 路由匹配+编排管线
其余 Raw TCP L4 规则/默认转交

固定协议模式(http/tcp/socks5)跳过探测直接进对应分支。

热增删

监听器实体走标准 draft→publish:发布后新增监听器即刻开收、删除的监听器停止收新连接 (存量连接随进程存活自然排空);连接限额槽随连接关闭释放。

PROXY protocol

{ "port": 5010, "proxyProtocol": true, "trustedProxies": ["10.0.0.0/8"] }

v1/v2 头剥离(前置 LB 场景还原真实客户端地址);必须配信任链 CIDR—— 非信任源不剥不信任(防伪造)。

与端口模型的关系

worker.json 的 listen.port 是缺省数据口(启动即监听);listener 实体在发布后 增删更多数据口——多端口拓扑、内外分离(如 80/443 双口)都由实体驱动。 整体端口面规划见部署与运维 · 端口模型。