监听器与端口
监听器(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 双口)都由实体驱动。
整体端口面规划见部署与运维 · 端口模型。