7.5 KiB
协议说明
客户端
认证
本协议基于 TLS 协议，TLS 握手完成后客户端立即发送认证请求：
| sha256(password) | padding0 length | padding0 |
|---|---|---|
| 32 Bytes | Big-Endian uint16 | 可变长度 |
认证成功服务器会进入会话循环，认证失败服务器会关闭连接（或 fallback 到 http 服务）。
会话
认证完成后，客户端&服务器在 TLS 协议之上开启会话层事件循环，会话层 frame 格式如下：
| command | streamId | data length | data |
|---|---|---|---|
| uint8 | Big-Endian uint32 | Big-Endian uint16 | 可变长度 |
客户端每次开启新会话必须立即发送 cmdSettings frame。
command
cmdWaste = 0 // Paddings
cmdSYN = 1 // stream open
cmdPSH = 2 // data push
cmdFIN = 3 // stream close, a.k.a EOF mark
cmdSettings = 4 // Settings（客户端向服务器发送）
cmdAlert = 5 // Alert（服务器向客户端发送）
cmdUpdatePaddingScheme = 6 // update padding scheme（服务器向客户端发送）
cmdWaste
任意一方收到 cmdWaste frame 后都应将其 data 完整读出并无声丢弃。
cmdSYN
客户端通知服务器打开一条新的 Stream。客户端应为每个 Stream 生成在 Session 内单调递增的 streamId。
cmdPSH
承载 Stream 的传输数据。
cmdFIN
通知对方关闭对应 streamId 的 Stream。
cmdSettings
其 data 目前为：
v=1
client=anytls/0.0.1
padding-md5=(md5)
采用 UTF-8 编码，key 与 value 之间用
=连接，两者均为 string 类型。不同项目之间用\n分割。
v是客户端实现的协议版本号 （目前为1）client是客户端软件名称与版本号padding-md5是客户端当前paddingScheme的 md5 （小写 hex 编码）
cmdAlert
其 data 为服务器发送的警告文本信息，客户端需要将其读出并打印到日志，然后双方关闭连接。
cmdUpdatePaddingScheme
当服务器收到客户端的 padding-md5 不同于服务器时，会向客户端发送更新 paddingScheme 的 frame，其 data 目前格式如下：
Default Padding Schme v1
stop=8
0=30-30
1=100-400
2=400-500,c,500-1000,c,500-1000,c,500-1000,c,500-1000
3=9-9,500-1000
4=500-1000
5=500-1000
6=500-1000
7=500-1000
- 客户端应在 Client 对象存储
paddingScheme，即服务器下发的paddingScheme只作用于连接到该服务器的 Client - 客户端第一次会话连接使用默认的
paddingScheme，如果收到cmdUpdatePaddingScheme后续新建会话则必须使用服务器下发的paddingScheme
有了这个设计，当默认 paddingScheme 产生的流量特征被 GFW 列入黑名单时，理论上每个客户端启动时只需要发送少量数据（理想情况下只有第一个连接的 pkt 0~2），在收到服务器的首个
cmdUpdatePaddingScheme后就能更新为服务器指定的特征。因此，理论上可以被 GFW 捕获的已知特征的连接的比例将非常低。
paddingScheme 具体含义与实现
padding0
padding0 也就是第 0 个包，处于认证部分，不支持分包。客户端应将该长度的 padding 与 sha265(password) 一并发送。
提示：认证部分的开销为 34 字节。
stop
stop 表示在第几个包停止处理 padding 比如: stop=8 代表只处理第 0~7 个包。
padding1 开始
- padding1 开始处于会话部分，采用 padding 策略分包和/或填充：如果分包发送完之后，用户数据仍然有剩余，则直接发送剩余数据。如果分包发送完之前，用户数据已发送完毕，则发送
cmdWaste frame垃圾 padding 数据(建议用 0)做填充。 - 分包策略，比如：上述 paddingScheme 将包
2将分成 5 个尺寸在 400-500 / 500-1000 的小包发送（这里的尺寸指 TLS PlainText 的尺寸，不计算 TLS 加密等开销）。 - 中间的
c是检查符号，含义：若上一个分包发送完毕后，用户数据已无剩余，则直接对本次写入返回，不再发送后续的填充包。 - 包计数器以写到 TLS 的次数为准，包
1应该包括：cmdSettings和首个 Stream 的cmdSYN + cmdPSH(代理目标地址数据) - 包
2应该是代理自用户的第一个数据包，比如 TLS ClientHello。 - 假如在 stop 之前的某个包的发送策略没有被 PaddingScheme 定义，那么直接发送该包。
参考处理逻辑在 func (s *Session) writeConn()
复用
客户端必须实现会话层复用功能。 总体架构为：
TCP Proxy -> Stream -> Session -> TLS -> TCP
复用的具体逻辑：
创建新的会话层之前必须检查是否有“空闲”的会话，如果有则取 Seq 最大的会话，在该 Session 上开启 Stream 承载用户代理请求。
如果没有空闲的会话，则创建新的会话，Session 的序号 Seq 在一个 Client 内应单调递增。
Stream 在代理中继完毕被关闭时，如果对应 Session 的事件循环未遇到错误，则将 Session 放入“空闲”连接池，并且设置 Session 的空闲起始时间为 now。
定期（如 30s）检查连接池中的空闲会话，关闭并删除持续空闲超过一定时间（如 60s）的会话。
以上连接策略高度概括：优先复用最新的连接，优先清理最老的连接。
代理
对于 TCP，每个 Stream 打开后，客户端向服务器发送 SocksAddr 格式表示代理请求的目标地址，然后开始双向代理中继。
对于 UDP，现在使用 sing-box 的 udp-over-tcp 2 协议，相当于代理请求 TCP sp.v2.udp-over-tcp.arpa。
服务器
认证
服务器基于 TLS Server 运行，对于每个 Accpted TLS Connection 认证的方式为：
读出第一个数据包，校验认证请求（包括完整读出 padding0），如果符合，则开始会话循环。如果不符合，则直接关闭连接或 "fallback" 到任意 "合法" L7 应用。
会话
会话层格式和命令见客户端。
对于一个新 Session，如果服务器在收到客户端的 cmdSettings frame 之前收到 cmdSYN frame，必须拒绝此次会话。
服务器有权拒绝未正确实现本协议（包括但不限于 cmdUpdatePaddingScheme 和连接复用）、版本过旧（有已知问题）的客户端连接。
当服务器拒绝这类客户端时，必须发送 cmdAlert 说明原因，然后关闭 Session。
代理
代理中继完毕后，服务器关闭 Stream 但不要关闭 Session。
服务器可以定期清理长期无上下行的 Session。
对于目标地址为 sp.v2.udp-over-tcp.arpa 的请求，则应该使用 sing-box udp-over-tcp 协议处理。
协议参数
anytls 协议参数不包括 TLS 的参数。应该在另外的配置分区中指定 TLS 参数。
客户端
password必选，string 类型，协议认证的密码。idleSessionCheckInterval可选，time.Duration 类型，检查空闲会话的间隔时间。idleSessionTimeout可选，time.Duration 类型，在检查中，关闭空闲时间超过此时长的会话。minIdleSession可选，int 类型，在检查中，至少保留前 n 个空闲会话不关闭，即为后续代理连接保留一定数量的“预备会话”。
服务器
paddingScheme可选，string 类型，填充方案。