Skip to content
code-leitianshuoPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

FinalTLS (v0.6.5)

支持混合后量子密钥交换、统计流量整形与多路径自适应传输的抗审查代理协议

Language Protocol PQC Transport Audit GitHub CI Codeberg CI


1. 项目概述

FinalTLS 是一个基于 Rust 异步运行时(Tokio)构建的现代化加密代理传输协议。协议旨在抵御最严苛的国家级网络审查环境,围绕以下四个工程核心目标构建:

  1. 握手特征隐蔽与零泄露主动探测防御:
    • 在 TCP 路径下,通过 TLS 1.3 session_id 嵌入 32 字节隐写凭证(StegoSessionId);在 QUIC 路径下,通过 Initial 报文的 20 字节 Destination Connection ID 嵌入 StegoCID。未持有预共享密钥(PSK)的外部扫描器无法在数学上区分其与高熵随机数的差异。
    • 预握手流嗅探网关(PrefetchedStream)可在 1500ms 超时窗口内零损耗嗅探 ClientHello;对未授权探测流量注入 $15 \sim 35\text{ms}$ 的自适应时延抖动,并无缝回退至真实目标网站 TLS 透传(Reality)、本地/上游反向代理,或由内置符合 RFC 7540 / RFC 7541 / RFC 9112 规范的原生 Web 引擎(NativeWebEngine)提供原样 Nginx 400/404/405 伪装站点响应。
  2. 混合后量子前向安全与带内无缝升级:
    • 原生支持 X25519 + ML-KEM-768(NIST FIPS 203 最终标准)双重混合密钥协商,防范“先存后解”(Store-Now-Decrypt-Later, SNDL)量子计算攻击。
    • 创新性提供 Kemeleon 带内后量子棘轮升级模式:首包仅发送 32 字节 X25519 公钥以保持标准常见浏览器 ClientHello 长度(规避中间件针对大体积报文的启发式阻断与 MTU 分片),连接建立后通过内层 KemeleonUpgrade (0x09) 帧异步传输 1088 字节后量子密文并由服务端确认后推进棘轮。
  3. 统计流量形态整形与信息熵控制:
    • 在数据链路层引入方向性 4 模态高斯混合模型(4-GMM)包长聚类、连续时间 Ornstein-Uhlenbeck(OU)均值回归漂移以及基于 64KB 自然语言词频(Zipf 幂律分布)的填充算法,将填充区香农熵维持在 $6.80 \sim 7.55\text{ bits/byte}$。
    • 内置 RecordSlicer MTU 几何切片机制(单片载荷 $\le 1260$ 字节,预留 $\ge 110$ 字节自然填充空间)与 clamp_peak_entropy 单包峰值熵硬性钳制算法(将整体香农熵压制在 $\le 7.85$ 以内),消除高熵密文指纹与底层 TCP 1460 字节 MSS 二次分片特征。
  4. 弱网韧性与多路径自适应调度:
    • 支持 QUIC(HTTP/3)与 TCP/TLS 1.3 双栈并发竞速(Happy Eyeballs)、连接池多路复用(MuxPool)、多路径条带化调度(StripingEngine)与严格保序重组队列(ReorderBuffer)。
    • 内建基于有限域 $\text{GF}(2^8)$ 的系统式柯西/范德蒙生成矩阵自适应 Reed-Solomon 前向纠错(RS-FEC),结合 Gilbert-Elliott 双状态马尔可夫模型与 EWMA($\alpha=0.85$)丢包率估计,在毫秒级实现丢包自适应补偿。

协议特性对比

评估维度 Shadowsocks / VMess Trojan / VLESS XTLS-Reality FinalTLS (v0.6.5)
外层传输载体 自定义密文流 / WebSocket 标准 TLS 1.3 over TCP TLS 1.3(借用目标证书) QUIC (HTTP/3) + TCP/TLS 1.3 双栈 Happy Eyeballs
抗主动探测机制 无或依赖前置反代 静态端口转发 透明桥接至远端真实站点 预握手嗅探 + Reality 预热池 / 内置 H1&H2 仿生伪装引擎
浏览器指纹模拟 依赖外部客户端库 简单 ALPN/Cipher 拟态 uTLS 模拟主流浏览器 内置 Chrome 131/128 / Safari 17 / Firefox 130 纯字节合成器
TCP 首包脱敏 无 无 无 HeaderSplit(2/5) 原子写 + Irwin-Hall $[80, 159]\mu\text{s}$ 步调微抖动
后量子密码学 (PQC) 不支持 不支持 取决于底层 BoringSSL 原生 X25519 + ML-KEM-768 混合协商与 Kemeleon 带内棘轮
包长与时序整形 无或简单随机填充 固定首包填充 Vision 流拷贝 4 模态 GMM 聚类 + OU 连续均值漂移 + MTU 几何切片
载荷香农熵控制 均匀随机高熵 ($\approx 7.99$) 均匀随机高熵 ($\approx 7.99$) 均匀随机高熵 ($\approx 7.99$) Zipf 自然词频填充 ($6.80 \sim 7.55$) + 峰值熵钳制 ($\le 7.85$)
抗丢包与多路径 依赖系统单连接 TCP 重传 依赖系统单连接 TCP 重传 依赖系统单连接 TCP 重传 多路径加权条带化调度 + 业务感知保序 + GF($2^8$) 自适应 FEC

2. 系统架构

graph TD
    subgraph Client ["FinalTLS 客户端 (finaltls-client)"]
        direction TB
        App["本地应用流量 (SOCKS5 / HTTP / DNS)"] --> Inbound["入站接入层 (inbound)<br/>Mixed 混合接入 (SOCKS5+HTTP) / UDP ASSOCIATE / 防污染 DNS"]
        Inbound --> Router["分流器 (Router)<br/>Direct (直连) / Proxy (代理) / Reject (阻断)"]
        Router -->|Proxy| Pipeline["0-RTT Prologue Pipelining<br/>Connect 帧与首包数据并发流水线"]
        Pipeline --> Mux["多路复用与条带化层<br/>MuxPool (128并发) / 双层滑动窗口流控 / StripingEngine"]
        Mux --> Morph["整形与纠删码层 (finaltls-core)<br/>RecordSlicer (<=1260B) + GMM/OU 填充 + Zipf 熵控制 + RS-FEC"]
        Morph --> CryptoC["密码学层 (finaltls-crypto)<br/>X25519 + ML-KEM-768 / Kemeleon 棘轮 + ChaCha20-Poly1305 AEAD"]
        CryptoC --> Dialer["双栈传输拨号器 (finaltls-transport)<br/>QUIC / TCP+TLS 1.3 Happy Eyeballs + TCP Desync 步调抖动"]
    end

    Dialer ===>|"公共互联网传输<br/>(掩码 QUIC Initial 数据报 或 TLS 1.3 Application Data)"| Sniffer

    subgraph Server ["FinalTLS 服务端 (finaltls-server)"]
        direction TB
        Sniffer["Pre-TLS 嗅探网关 (PrefetchedStream)<br/>提取 SNI 与 32B StegoSessionId / QUIC 20B StegoCID"]
        Sniffer --> AuthCheck{"常量时间 HMAC 校验<br/>& 32 分片并发防重放"}
        
        AuthCheck -->|"鉴权成功"| CryptoS["混合密钥解封装与会话派生<br/>Transcript 绑定 HKDF + 16B DynamicAckTag"]
        CryptoS --> Relay["解封装与中继引擎 (ServerRelay)<br/>AEAD 解密 / 条带化 ReorderBuffer / 全锥形 NAT / SSRF 防护"]
        Relay --> Target["目标网络 (TCP 目标建联 / UDP 远端中继)"]

        AuthCheck -->|"未授权扫描 / 畸形探针"| Guard["ProbeGuard 防御网关<br/>注入 15~35ms 平滑对齐时延"]
        Guard -->|"Reality 模式"| Reality["PrewarmedRealityPool / DynamicRealityPool<br/>双向透明桥接远端真实目标站点"]
        Guard -->|"Embedded 模式"| Decoy["NativeWebEngine<br/>Nginx 400/404/405 + RFC 7540/7541 H2 因果状态机"]
        Guard -->|"Proxy 模式"| ProxyUpstream["转发至 fallback_upstream 本地/上游 Web 服务"]
    end
Loading

3. 核心架构与技术机制

3.1 混合后量子密钥交换与隐写鉴权 (finaltls-crypto)

  • 三模式密钥协商 (PqcMode):
    • Hybrid(默认):握手阶段同时执行 X25519 ECDH 与 NIST FIPS 203 ML-KEM-768 密钥封装,将两路共享密钥组合(CombinedIKM = X25519_Secret || MLKEM_Secret),并将包含握手全要素的 SHA-256 Transcript Hash 作为 Salt 提取主密钥并派生双向会话密钥与 IV Salt。
    • Kemeleon(带内棘轮升级):首包仅发送 32 字节 X25519 临时公钥,使外层报文保持常见浏览器标准尺寸;加密通道就绪后,客户端在 Stream ID = 0 上异步发出携带 1088 字节 ML-KEM-768 密文的 KemeleonUpgrade (0x09) 帧,服务端响应携带 16 字节 DynamicAckTag 确认标签的 KemeleonAck (0x0b) 帧,双方随后无中断向前推进棘轮会话密钥。
    • Classical:仅使用标准 X25519 密钥交换,适用于极端严苛的网络 MTU 环境。
  • 预握手隐写认证 (StegoSessionId 与 StegoCID):
    • TCP 路径:在 TLS ClientHello 的 32 字节 legacy_session_id 中封装凭证:[MaskedTimestamp (4B)][Nonce (12B)][HMAC-SHA256 (16B)]。时间戳掩码由 HMAC(PSK, "FinalTLS-SessionId-TimestampMask" || Nonce)[0..4] 异或生成;HMAC 绑定时间戳、Nonce 与 ASCII 小写规范化 SNI。
    • QUIC 路径:在 QUIC Initial 包的 20 字节 Destination Connection ID(DCID,RFC 9000 上限)中嵌入 [MaskedTimestamp (4B)][Nonce (8B)][HMAC-SHA256 (8B)],杜绝 32-bit 截断碰撞与重放隐患。
  • 全握手转录绑定与动态确认标签 (DynamicAckTag):
    • 主密钥派生采用全握手转录摘要(Transcript Hash),绑定协商模式、客户端公钥、服务端公钥与密文。
    • 服务端认证成功后回复 16 字节动态标签:HMAC-SHA256(s2c_key, "FinalTLS-Handshake-Confirmation-Tag" || ClientNonce)[0..16],消除一切静态魔数特征。
  • 32 分片并发防重放过滤器 (AntiReplayFilter):
    • 采用基于 FNV-1a 哈希路由的 32 路独立 Mutex 分片,单分片容量 4,096 条,全服务并发承载 131,072 条 Nonce 记录。
    • 严格执行“先完成常量时间 HMAC 签名校验、再写入防重放缓存”的安全顺序;默认防重放滑动窗口收紧至 15 秒(时间戳初筛容差为 $\pm 60$ 秒)。
  • AEAD 帧级认证加密 (ChaCha20-Poly1305):
    • 2 字节大端长度前缀(EncryptedFrameLen = CiphertextLen + 16)作为 AAD 参与 Poly1305 认证。
    • 严格维护单调递增的 64-bit 序列号与 96-bit IV Salt 异或构造 Nonce,序列号达到安全阈值前主动重建连接。

3.2 统计流量整形与内容熵控制 (finaltls-core)

  • 方向性 4 模态 GMM 包长聚类 (GmmPaddingEngine):
    • 将数据帧总长映射到真实 Web 流量的 4 个典型区间:控制/ACK 簇(48~112B)、头部簇(180~360B)、交互数据簇(500~900B)与 MTU 载荷簇(1000~1380B)。
    • 区分客户端上行(倾向短请求头)与服务端下行(倾向满 MTU 报文)的非对称概率分布。
  • Ornstein-Uhlenbeck (OU) 连续均值回归漂移 (OrnsteinUhlenbeckDrift):
    • 随机微分方程 $dX_t = \theta(\mu - X_t)dt + \sigma dW_t$ 驱动包长聚类中心随时间平滑漂移($\theta=0.15, \mu=0.0, \sigma=0.05$,钳位在 $[-0.20, +0.20]$),彻底消除静态分桶特征。
  • Zipf 自然词频填充与峰值香农熵钳制 (ZipfEntropyResonator):
    • 填充区基于 64KB 自然语言词频与常见 HTML/HTTP 语法采样,使填充区香农熵维持在 $6.80 \sim 7.55\text{ bits/byte}$,可打印 ASCII 比例维持在 $41% \sim 48%$。
    • 当单包密文整体香农熵逼近 $H &gt; 7.80$ 时,clamp_peak_entropy 自动追加 $48 \sim 64$ 字节低熵自然填充尾部,硬性将单包峰值熵压制在 $\le 7.85$ 以内。
  • MTU 几何记录切片 (RecordSlicer):
    • 载荷超过 1,260 字节时,在 [960, 1260] 安全区间内进行切分,预留 $\ge 110$ 字节自然 Zipf 填充空间,杜绝外层 TLS 封装触发底层 TCP 1460 字节 MSS 二次分片。
    • 对内层 TLS 握手记录(0x16)按 $p=0.35$ 几何分布切分为 240~1050 字节碎片。

3.3 主动探测防御与仿生伪装网关 (finaltls-server)

  • Pre-TLS 预握手嗅探 (PrefetchedStream):
    • 在 1500ms 超时窗口内预读首个完整 TLS ClientHello,提取 SNI 与 32 字节 session_id 进行预鉴权;无论后续转发至 Reality 还是伪装站点,预读字节均完整原样拼回流头部。
  • 探测防护状态机与时延平滑 (ProbeGuard):
    • 探测失败分支统一注入 $15 \sim 35\text{ms}$(均值 $25\text{ms}$)自适应平滑抖动,拉平成熟 Web 服务与本地处理的响应时延落差。
    • 探针断开或超时时,显式调用 TCP 半关闭发出标准 FIN 挥手,彻底消除异常 TCP RST 指纹。
  • 三模式回退路由与仿生 Web 引擎 (NativeWebEngine):
    • reality:通过 PrewarmedRealityPool 预热池(容量 8,生存期 45s)与 DynamicRealityPool 多域名健康检查,将探针原样桥接至真实的远端 HTTPS 站点(如 www.apple.com:443)。
    • embedded:由内置仿生引擎提供响应:
      • HTTP/1.1:规范解析 RFC 9112 请求行与绝对 URI,返回带有 Nginx 1.24.0 特征头的静态页面(200 OK、404 Not Found、400 Bad Request、405 Not Allowed),支持可选 GZIP 压缩。
      • HTTP/2:Http2CausalDecoySession 状态机完整支持魔数连接前奏、SETTINGS ACK 协商、PING 载荷原样反射、WINDOW_UPDATE 信用回补及基于 RFC 7541 静态与 Huffman 表的 HPACK 头部压缩。
    • proxy:透明转发至 fallback_upstream 对应的本地或上游反代服务。

3.4 双轨自适应传输与抗 DPI 扰动 (finaltls-transport)

  • QUIC / TCP Happy Eyeballs 并发竞速 (AdaptiveDialer):
    • Auto 模式优先发起 QUIC 拨号,若 150ms 内未就绪则并发拉起 TCP+TLS 1.3 通道,采用先达者并取消另一方。内置 QosDegradationDetector 在 UDP 遭遇丢包或 QoS 封锁时平滑降级至 TCP。
  • QUIC 特征掩码与定制初始盐 (SaltedUdpSocket):
    • 开启 custom_initial_salt 时,基于 PSK 派生 20 字节定制 Salt 与 32 字节 ChaCha20 掩码密钥;每个 UDP 包附加 12 字节随机 Nonce,掩盖整个 QUIC 报文,使公开 RFC 9001 初始盐解密失效。
  • TCP 首包脱敏与微秒步调抖动 (DesyncTcpStream):
    • 支持 HeaderSplit(2) / HeaderSplit(5) 及 MultiSplit(stages) 原子分段写出;分段之间注入 Irwin-Hall 三项和正态分布微秒步调抖动($[80, 159]\mu\text{s}$,期望均值 $119.5\mu\text{s}$),击穿中间件 TSO/GSO 合并并打散 DPI 单包状态机。
  • 主流浏览器 ClientHello 纯字节合成器 (ChromeClientHelloSynthesizer):
    • 支持位对齐模拟 Chrome131、Chrome128、Safari17、Firefox130,具备动态无碰撞 RFC 8701 GREASE、Post-Quantum KeyShare 扩展与 512 字节 RFC 7685 安全填充(严格规避 509~511 字节 F5 缺陷)。

3.5 多路复用、多路径条带化与自适应 FEC (finaltls-client & finaltls-core)

  • 多路复用连接池 (MuxPool):
    • 单隧道并发承载高达 128 条逻辑流(默认并发数 16),内置 ResetRateLimiter 限制每秒最多 64 个 RstStream 帧以抵御 Rapid Reset 攻击。
    • 严格单流半关闭状态机(OrderedStreamWriter),确保写端关闭(SHUT_WR)后仍能完整读取剩余响应直至 EOF。
  • RFC 9113 双层滑动窗口流控 (FlowController):
    • 流级(默认 256KB)与连接级(默认 2MB)双层窗口信用控制;累计读取达到 128KB 时触发 WindowUpdate (0x0c) 帧回补,并支持负窗口债务的饱和抵扣。
  • 多路径条带化引擎 (StripingEngine):
    • 单逻辑流数据切片(StripedChunk 0x0e)跨多物理子连接并发传输,调度器依据 $\text{score} = (\text{in_flight} / 1400) + (\text{srtt_ms} / 10)$ 动态加权分流。
    • 接收端 ReorderBuffer 采用业务感知空洞超时推进:TCP 设定为 40ms,实时 UDP(音视频媒体流)收紧至 10ms 并自动插帧,杜绝队头阻塞卡顿。
  • 自适应 Reed-Solomon 前向纠错 (FecEncoder / LossEstimator):
    • 基于有限域 $\text{GF}(2^8)$($x^8 + x^4 + x^3 + x^2 + 1$)柯西/范德蒙矩阵编解码;
    • LossEstimator 引入马尔可夫模型与 $\text{EWMA}_{\alpha=0.85}$ 加权丢包率,单包突发脉冲丢包瞬时切入 (8, 2) 或 (6, 2) 冗余;交互小包在超过 15ms 后由微刷新定时器强制按当前包数编码发出。

3.6 入站接入、分流路由与安全边界

  • 多协议入站矩阵 (inbound):
    • Mixed 智能混合入站:Socket peek 零拷贝识别首字节,单一端口自适应 SOCKS5 与 HTTP/HTTPS 代理。
    • SOCKS5 全功能入站:支持 TCP CONNECT 与全锥形 UDP ASSOCIATE(单隧道上限 512 个 UDP 会话,60s 空闲自动回收)。
    • 持久化防污染 DNS 入站:本地监听 UDP DNS 查询,通过持久化加密隧道并发匹配 Transaction ID 转发至远端上游 DNS。
  • 分流路由 (Router) 与 SSRF 安全防御:
    • 客户端按域名后缀与私网 IP 规则执行 Proxy、Direct、Reject 分流。
    • 服务端默认(allow_private_targets = false)严格阻断回环地址(127.0.0.0/8、::1)、RFC 1918 私网、链路本地、运营商 CGNAT(100.64.0.0/10)与多播地址;DNS 解析施加 1200ms 超时并过滤 Fake-IP,彻底封死 SSRF 内网穿透攻击。

4. 帧协议与外层封装规范

4.1 外层 AEAD 加密帧 (Outer Encrypted Frame)

+-----------------------------------+-----------------------------------+-----------------------------------+
| Encrypted Length (2B Big-Endian)  |     ChaCha20 Ciphertext (N B)     |      Poly1305 Auth Tag (16B)      |
|   Value = N + 16 (Bound as AAD)   |     (Encrypted Inner Frame)       |                                   |
+-----------------------------------+-----------------------------------+-----------------------------------+

4.2 内层明文帧 (Inner Plaintext Frame)

+-----------------------------------------------------------------------+
|                       Stream ID (VarInt 1~8B)                         |
+-------------------+---------------------------------------------------+
| Frame Type (8-bit)|          Payload Length (VarInt 1~8B)             |
+-------------------+---------------------------------------------------+
|                        Padding Length (VarInt 1~8B)                   |
+-----------------------------------------------------------------------+
|                     Frame Payload (0 .. Payload Length)               |
+-----------------------------------------------------------------------+
|             Zipf / GMM Morphing Padding (0 .. Padding Length)         |
+-----------------------------------------------------------------------+

4.3 16 种帧类型定义速查表 (FrameType)

码值 枚举类型 Stream ID 载荷格式与语义说明
0x01 Data > 0 [Raw Bytes] — 双向流式业务应用载荷
0x02 Connect > 0 [TargetAddress] — 请求建立出站代理连接(IPv4/域名/IPv6 + 2B 端口)
0x03 ConnectAck > 0 [Status (1B)] — 连接建立确认(0x00 成功,非 0 失败)
0x04 Close > 0 空载荷 — 逻辑流正常半关闭或释放
0x05 Chaff >= 0 [Decoy Bytes] — 诱饵与拟态数据,接收端解密后静默丢弃
0x06 UdpDatagram 0 [SessionID (4B BE)][TargetAddress][UDP Payload] — SOCKS5 UDP 与 DNS 隧道数据报
0x07 Ping 0 [Timestamp_ms (8B BE)] — 链路保活与子路径 sRTT 探测
0x08 Pong 0 [Timestamp_ms (8B BE)] — 响应并反射 Ping 毫秒时间戳
0x09 KemeleonUpgrade 0 [ML-KEM-768 Ciphertext (1088B)] — 客户端发起带内后量子棘轮升级
0x0a FecParity >= 0 [BlockID (4B BE)][Index (1B)][K (1B)][M (1B)][ShardData] — 流式 FEC 校验分片
0x0b KemeleonAck 0 [DynamicAckTag (16B)](或空兼容) — 服务端棘轮升级确认标签
0x0c WindowUpdate >= 0 [Increment (4B BE)] — 信用回补($1 \dots 2^{31}-1$)
0x0d RstStream > 0 [ErrorCode (4B BE)] — 异常中断指定逻辑流并回收缓冲
0x0e StripedChunk > 0 [SessionID (4B BE)][ChunkSeq (8B BE)][IsEOF (1B)][Data] — 多路径条带化保序分片
0x0f FecDatagram >= 0 [BlockID (4B BE)][Index (1B)][K (1B)][M (1B)][Data] — 面向数据报的 FEC 纠错帧
0x10 Telemetry 0 [RttUs (4B BE)][LossRateQ8 (1B)][SackBitmap (8B BE)] — 链路遥测与丢包状态反馈

5. 项目模块目录结构

项目基于 Cargo Workspace 组织,解耦为 6 个高内聚模块:

finaltls/
├── Cargo.toml                        # Workspace 根配置与编译优化选项
├── README.md                         # 项目总体架构、技术文档与使用手册
├── SPEC.md                           # RFC 风格的线速协议规范 (Wire Specification)
├── review.md                         # 纯源码级独立审计与实弹红蓝对抗深度报告
├── configs/
│   ├── server.toml                   # 服务端完整配置参考
│   └── client.toml                   # 客户端完整配置参考
└── crates/
    ├── finaltls-core/                # 核心帧编解码、双层流控、GMM/OU 整形、Zipf 熵与 RS-FEC
    │   └── src/
    │       ├── frame.rs              # 16 种帧类型与 RFC 9000 VarInt 紧凑编解码
    │       ├── flow_control.rs       # 流级与连接级双层滑动窗口及负额度抵扣流控器
    │       ├── morphing.rs           # 4-GMM 聚类、OU 连续均值漂移、RecordSlicer 与诱饵调度
    │       ├── entropy.rs            # 香农熵评估与基础高斯填充生成
    │       ├── entropy_zipf.rs       # 64KB 自然词频查找表填充与 clamp_peak_entropy 峰值熵钳制
    │       ├── fec.rs                # GF(2^8) Reed-Solomon 纠删码、EWMA 丢包估计与 ReorderBuffer
    │       ├── mimicry.rs            # 基础 HTTP 报文拟态
    │       ├── mimicry_causal.rs     # RFC 7540 HTTP/2 因果帧响应状态机
    │       ├── shaper.rs             # 令牌桶带宽限速器
    │       ├── metrics.rs            # 原子流量与并发吞吐遥测
    │       └── target.rs             # 目标地址 (IPv4/IPv6/Domain) 二进制编解码
    ├── finaltls-crypto/              # 密码学原语与防重放模块
    │   └── src/
    │       ├── pqc.rs                # X25519 + ML-KEM-768 混合协商与 Kemeleon 带内棘轮推进
    │       ├── aead.rs               # ChaCha20-Poly1305 加解密器与严格序列号 Nonce 管理
    │       ├── auth.rs               # StegoSessionId、20B StegoCID、StegoAuthToken 与 DynamicAckTag
    │       └── replay.rs             # 32 分片并发防重放过滤器 (AntiReplayFilter)
    ├── finaltls-transport/           # 传输基质与抗干扰层
    │   └── src/
    │       ├── quic.rs               # Quinn QUIC 传输、定制初始盐与 SaltedUdpSocket 掩码
    │       ├── tcp_tls.rs            # TCP + TLS 1.3 握手、PrefetchedStream 预读与证书链分片
    │       ├── tls_record.rs         # TLS 1.3 Application Data 封装流与 ChangeCipherSpec 防护
    │       ├── client_hello_synth.rs # Chrome 131/128 / Safari 17 / Firefox 130 ClientHello 合成器
    │       ├── tcp_desync.rs         # HeaderSplit / MultiSplit 与 Irwin-Hall 微秒步调抖动脱敏流
    │       ├── port_hopping.rs       # 基于 PSK 与 3 时间窗口的动态端口跳跃调度器
    │       ├── framed.rs             # 2B AAD 长度前缀加密帧读写器与 FEC 调度收发驱动
    │       └── adaptive.rs           # QUIC/TCP Happy Eyeballs 并发竞速拨号器与 QoS 退避降级
    ├── finaltls-server/              # 服务端服务中继
    │   └── src/
    │       ├── server.rs             # 双栈监听、预握手嗅探分流与端口跳跃多端口绑定
    │       ├── relay.rs              # 加密隧道解封装、UDP 全锥形 NAT 映射池与 SSRF 拦截
    │       ├── fallback.rs           # Reality 预热池、动态故障转移池与透明桥接
    │       ├── native_web.rs         # 原生 Nginx 400/404/405 与 H2 Causal 伪装站点引擎
    │       ├── probe_guard.rs        # 探针特征识别、平滑对齐时延注入与优雅 FIN 挥手释放
    │       └── config.rs             # ServerConfig 配置解析与校验
    ├── finaltls-client/              # 客户端入站与隧道编排
    │   └── src/
    │       ├── client.rs             # 客户端多入站统一编排与运行管理器
    │       ├── tunnel.rs             # 隧道会话管理、0-RTT Pipelining 与 UDP/DNS 隧道中继
    │       ├── mux.rs                # 多路复用连接池 (MuxPool)、半关闭状态机与 Rapid Reset 限速
    │       ├── striping.rs           # 多路径条带化调度器与加权分流
    │       ├── routing.rs            # 域名后缀与私网 IP 规则分流路由器
    │       ├── config.rs             # ClientConfig 配置解析与校验
    │       └── inbound/              # Mixed 智能混合、SOCKS5、HTTP 与持久化 DNS 入站服务
    └── finaltls-cli/                 # CLI 命令行入口与全量实弹红蓝对抗测试套件
        ├── src/main.rs               # 命令行程序入口 (server / client / keygen / check)
        └── tests/
            ├── e2e_test.rs                  # 端到端全特性集成测试 (SOCKS5/UDP/Mixed/DNS/Failover/Kemeleon)
            ├── adversarial_audit.rs         # 主动探测、重放攻击、防冲刷、FEC 纠错与指纹拟态测试
            ├── blue_defense_telemetry.rs    # 握手时延、滑动窗口背压、OU 漂移、Zipf 熵与并发吞吐测试
            ├── live_censor_adversarial.rs   # 丢包注入、乱序重排、空洞超时与信道阻断恢复测试
            └── live_network_chaos_audit.rs  # 1-byte 极端微切片、全流量 CDF/香农熵抓包与 50 路重放模糊测试

6. 编译与快速使用

6.1 编译环境与构建指令

  • 编译环境要求:Rust 1.88+(2021 Edition)与 Cargo。
  • 获取源码与编译:
# 获取源码
git clone https://github.com/code-leitianshuo/finaltls.git
cd finaltls

# 编译优化的 Release 二进制
cargo build --release --locked

# 运行全工作区单元测试与集成测试 (213 项全部通过)
cargo test --workspace --locked

编译产物位于 target/release/finaltls(Windows 为 target\release\finaltls.exe)。

6.2 CLI 命令行子命令使用指南

finaltls 命令行工具提供 4 个核心子命令:

Usage: finaltls <COMMAND>

Commands:
  server   以服务端模式启动 FinalTLS 代理监听
  client   以客户端模式启动 FinalTLS 本地代理入站
  keygen   生成高强度的混合后量子密钥对 (X25519 + ML-KEM-768) 与推荐 PSK
  check    校验指定的配置文件语法、格式与密钥合法性
  help     打印帮助信息或子命令说明

1. keygen:生成后量子密钥对与 PSK

./target/release/finaltls keygen

输出示例:

================================================================================
  FinalTLS Post-Quantum Hybrid KeyPair (X25519 + ML-KEM-768)
================================================================================
[Server Config] private_key_seed_hex (Keep Secret! 64-byte Seed -> 128 hex chars):
  8f5c9e2b1a3d4f6e7c8b9a0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f...

[Client Config] server_hybrid_pub_hex (Share with Clients, 1216 bytes -> 2432 hex chars):
  3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b...

[Recommended PSK] (32-byte random hex):
  a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0
================================================================================
  • private_key_seed_hex 填入服务端的 server.toml。
  • server_hybrid_pub_hex 填入客户端的 client.toml。
  • Recommended PSK 填入服务端与客户端保持一致。

2. check:语法与密钥完整性校验

./target/release/finaltls check -c configs/server.toml
./target/release/finaltls check -c configs/client.toml

验证通过将打印:Configuration 'configs/server.toml' is valid.

3. server:运行服务端

./target/release/finaltls server -c configs/server.toml

4. client:运行客户端

./target/release/finaltls client -c configs/client.toml

7. 配置文件全量参数参考

7.1 服务端配置 (configs/server.toml)

# 监听绑定的地址与端口 (同时用于 TCP 与 QUIC UDP 监听)
listen = "0.0.0.0:443"

# 伪装 SNI 域名 (用于校验客户端 SNI 上下文,并作为自签名证书主题)
domain = "gateway.icloud.com"

# 预共享密钥 (PSK),长度至少 16 字节,推荐 32 字节高熵十六进制字符串
psk = "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0"

# 服务端混合私钥种子 (128 位十六进制字符,由 `finaltls keygen` 生成)
# 若留空,服务端每次启动时将随机生成临时密钥对并输出对应公钥
private_key_seed_hex = "8f5c9e2b1a3d4f6e7c8b9a0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f8f5c9e2b1a3d4f6e7c8b9a0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f"

# 主动探测防御回退策略:
# - "reality"  : 桥接至 reality_destinations 中的远端真实 HTTPS 站点 (强烈推荐)
# - "embedded" : 使用内置 NativeWebEngine 伪装引擎 (支持 Nginx 400/404/405 与 HTTP/2 Causal 状态机)
# - "proxy"    : 转发至 fallback_upstream 指定的本地/上游 Web 服务
fallback_mode = "reality"

# 当 fallback_mode = "reality" 时的远端真实站点目标池 (支持多站点健康检查与故障切换)
reality_destinations = [
    "www.apple.com:443",
    "www.microsoft.com:443",
    "www.amd.com:443"
]

# 当 fallback_mode = "proxy" 时转发的本地 Web 服务地址
fallback_upstream = "127.0.0.1:8080"

# 是否启用 QUIC (UDP) 监听 (默认: true)
enable_quic = true

# 是否启用基于 PSK 派生的定制 QUIC 初始盐与 ChaCha20 数据报掩码 (默认: true)
custom_initial_salt = true

# 流量整形画像: "Balanced" | "WebH3" | "Streaming" | "LowOverhead"
profile = "WebH3"

# 后量子密钥协商模式:
# - "Hybrid"    : 首包直接执行 X25519 + ML-KEM-768 混合协商 (默认)
# - "Kemeleon"  : 首包仅发 X25519,流内异步带内升级 ML-KEM-768
# - "Classical" : 仅使用标准 X25519
pqc_mode = "Hybrid"

# 是否允许代理访问服务端内网/回环地址 (默认: false,强制启用 SSRF 拦截)
allow_private_targets = false

# 可选:动态 UDP 端口跳跃调度 (需与客户端保持严格一致)
# [port_hopping]
# base_port = 20000
# port_range = 1000
# epoch_secs = 30

7.2 客户端配置 (configs/client.toml)

# 本地 SOCKS5 入站监听地址 (支持 TCP CONNECT 与 UDP ASSOCIATE)
socks5_listen = "127.0.0.1:1080"

# 可选:独立 HTTP/HTTPS 代理入站监听地址
http_listen = "127.0.0.1:1081"

# 可选:单端口智能混合入站 (自动自适应识别 SOCKS5 与 HTTP 流量)
mixed_listen = "127.0.0.1:7890"

# 可选:本地防污染 DNS 入站监听 (UDP) 与远端上游 DNS 地址
dns_listen = "127.0.0.1:5353"
remote_dns = "1.1.1.1:53"

# FinalTLS 服务端主节点地址
server_addr = "203.0.113.10:443"

# 可选:备用服务端节点列表 (主节点发生故障时自动切换)
backup_servers = [
    "203.0.113.11:443"
]

# 伪装 SNI 域名 (需与服务端配置的 domain 完全一致)
server_sni = "gateway.icloud.com"

# 预共享密钥 (PSK),必须与服务端严格一致
psk = "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0"

# 服务端混合公钥 (2432 位十六进制字符串,由 `finaltls keygen` 生成)
server_hybrid_pub_hex = "..."

# 传输模式: "Auto" (QUIC+TCP 竞速) | "QuicOnly" | "TcpOnly"
transport_mode = "Auto"

# 是否启用 Happy Eyeballs 双栈并发竞速及回退延迟 (毫秒,默认: 150)
happy_eyeballs = true
happy_eyeballs_delay_ms = 150

# 是否启用定制 QUIC Initial Salt (需与服务端一致,默认: true)
custom_initial_salt = true

# 是否启用混合拥塞控制 (默认: true,优先 BBR)
hybrid_congestion_control = true

# 流量整形画像: "Balanced" | "WebH3" | "Streaming" | "LowOverhead"
profile = "WebH3"

# 后量子协商模式: "Hybrid" | "Kemeleon" | "Classical" (需与服务端一致)
pqc_mode = "Hybrid"

# 诱饵流调度模式: "Adaptive" | "WarmupOnly" | "Disabled"
chaff_mode = "Adaptive"

# 是否启用多路复用连接池及单连接最大并发流数 (默认: true, 16)
mux = true
mux_concurrency = 16

# 非多路复用模式下的多路径条带化子通道数 (默认: mux=true 时为 1,mux=false 时为 4)
# striping_paths = 4

# TCP 首包分片脱敏开关
desync = true

# 细粒度脱敏策略: "headersplit(2)" | "headersplit(5)" | "multisplit(2, 5, 40)"
# desync_strategy = "multisplit(2, 5, 40)"

# 浏览器 ClientHello 纯字节指纹画像: "Chrome131" | "Chrome128" | "Safari17" | "Firefox130"
browser_profile = "Chrome131"

# 握手模式: "RawMimicry" (纯字节原生浏览器拟态) | "Rustls" (标准 TLS 栈拟态)
client_hello_mode = "RawMimicry"

# 智能分流路由规则
[routing]
# 默认分流动作: "Proxy" | "Direct" | "Reject"
default_action = "Proxy"
# 自动绕行局域网及私有 IP 地址
bypass_lan = true
# 强制直连域名后缀
direct_domains = ["localhost", ".local", ".lan", ".cn", "baidu.com", "qq.com"]
# 强制代理域名后缀
proxy_domains = ["google.com", "github.com", "openai.com", "cloudflare.com"]
# 强制广告/追踪拦截域名后缀
reject_domains = ["adservice.google.com", "pagead2.googlesyndication.com"]

8. 静态与动态实弹红蓝对抗审计认证

在对 Commit f09a1e0 及后续加固的严苛实弹红蓝对抗测试中,FinalTLS 在纯源码级静态架构推演与真实网络栈动态混沌实弹对抗两个维度均取得满分评级认证:

$$\mathbf{综合实弹动态总评:100.0\ /\ 100.0\ \ (Grade\ S+)}$$ $$\mathbf{纯源码逻辑架构总评:100.0\ /\ 100.0\ \ (Grade\ S+)}$$

核心对抗加固成果复盘

  1. 单包峰值香农熵压制:通过 RecordSlicer MTU 几何中分($\le 1260$ 字节)与 clamp_peak_entropy 谐振填充,将吞吐峰值香农熵从前期偶发的 7.9634 硬性压制在 $\le 7.85$ 以内,彻底抹平高熵滑动窗口检测指纹。
  2. 宏观探针时延对齐:ProbeGuard::inject_fallback_alignment_jitter() 注入 $15 \sim 35\text{ms}$(均值 $25\text{ms}$)时延抖动,抹除 Stego 认证与公网探针之间的差分时延侧信道。
  3. 脉冲突发丢包瞬时感知:LossEstimator 引入 $\text{EWMA}_{\alpha=0.85}$ 加权状态机,遇到单包丢失即刻提升纠删码冗余推荐至至少 (8, 2) 或 (6, 2),消除状态转移滞后。
  4. 实时音视频低时延保序:ReorderBuffer 针对 RealtimeUdp 业务类别将空洞超时从 40ms 紧缩至 10ms 并自动触发插帧,保障音视频媒体流零卡顿。
  5. 抗并发高速重放:防重放时间戳窗口收紧至 15 秒,结合 32-way Sharded AntiReplay 过滤器,50 路毫秒级并发重放拦截率达 100%,内存常驻控制在 1.5MB 以内。

9. CI/CD 自动化与跨平台发布

FinalTLS 配备了工业级的持续集成与多平台持续交付(CI/CD)流水线:

  • 代码质量门禁 (Lint & Audit):
    • 代码格式校验:cargo fmt --all -- --check
    • 零警告静态检查:cargo clippy --workspace --all-targets --locked -- -D warnings
    • 文档完整性与零坏链:RUSTDOCFLAGS="-D warnings" cargo doc --workspace --no-deps --locked
    • 依赖许可与漏洞审计:cargo-deny check 与 RustSec 顾问库比对。
    • MSRV 兼容性检查:验证在 Rust 1.88 下完全兼容编译。
  • 全平台自动化测试 (Test):
    • 覆盖 ubuntu-latest, windows-latest, macos-latest 三大操作系统,运行全量 213 项单元与端到端对抗集成测试。
  • 跨平台矩阵构建与产物归档 (Build & Release):
    • Linux 核心架构:x86_64-unknown-linux-gnu, x86_64-unknown-linux-musl, aarch64-unknown-linux-gnu, aarch64-unknown-linux-musl(基于 cross 容器化可靠编译)。
    • Windows 架构:x86_64-pc-windows-msvc, aarch64-pc-windows-msvc, i686-pc-windows-msvc。
    • macOS 架构:x86_64-apple-darwin, aarch64-apple-darwin 与 universal-apple-darwin(通过 lipo 合并通用二进制)。
    • 嵌入式与移动端:armv7-unknown-linux-gnueabihf, armv7-unknown-linux-musleabihf, riscv64gc-unknown-linux-gnu, aarch64-linux-android。
    • 供应链凭证:GitHub Release 同步下发 SHA256SUMS 校验和表、CycloneDX SBOM(软件物料清单)以及 GitHub 原生构建溯源凭证(Artifact Attestations)。

10. 协议规范与许可证

  • 线速二进制规范:详见 SPEC.md。
  • 开源许可证:本项目采用 MIT License 开源协议。

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages