geektls

多语言 TLS/HTTP 全栈指纹伪造库：对 ClientHello 逐字节可控，覆盖 TLS（JA3/JA4）、HTTP/2（Akamai 指纹）、HTTP/3 + QUIC、TCP 四层指纹，提供 Python / Node.js / Go 三种语言的一等 API。

当前状态：P0–P7 完成（一期收工）。其中 TLS/H2 已交付并经 E2 外部 oracle 验证；H3/QUIC 机制已建，但预设证据仍为 E4/TODO（H3 尚未做外部验证）；TCP 仅 TTL/MSS 可承诺（window/window_scale/options 仅 Linux 探测模式，不影响真实连接）。P1-T8（nginx 采集端 L2 终审）与 P6-T3（JA4TCP 验收）待 Linux 环境，见文末遗留表。精确现状见 docs/01-fingerprint-dimensions.md 与 docs/capability-matrix.yml。

功能矩阵

快速上手

Python（pip install geektls，动态库随包）：

from geektls import Session

with Session(impersonate="chrome_150") as s:
    r = s.get("https://example.com", stream=True)
    print(r.status, r.used_protocol, r.selfcheck["ja4"])
    for chunk in r.iter_bytes(65536):
        ...

Node.js（npm install geektls）：

const { Session } = require('geektls');

const s = new Session({ impersonate: 'chrome_150' });
const r = await s.get('https://example.com');
console.log(r.status, r.usedProtocol, r.selfcheck.ja4);
for await (const chunk of r.body) { ... }
s.close();

Go（import "github.com/geektls/golang"）：

rt, _ := geektls.NewRoundTripper("chrome_150", nil)
client := &http.Client{Transport: rt}
resp, _ := client.Get("https://example.com")

自校验

每个响应带 selfcheck（实际发出 ClientHello 自算的 JA3/JA4，JA3/JA4R 入口还含期望值比对）；gtls_check_profile 支持 profile JSON / JA3 / JA4R / hex 四入参离线自检。

性能摘要（docs/benchmarks.md）

• FFI 调用开销：gtls_version 6–7µs、gtls_check_profile 26–30µs（<50µs 目标达成）
• 回环吞吐（每请求新连接，10s）：Go 2.6k / Python 3.4k / Node 0.95k req/s（并发 100）
• 冷启动：Session 初始化 0.2ms、首请求 ~3.5ms

已知边界（如实）

文档索引

非目标

• 不做服务端指纹采集（那是隔壁 D:\work\tls nginx 套件的事，两者互为验证端）。
• 不做浏览器级 JS 环境模拟（Canvas/WebGL 等）。
• 不内置任何绕过具体站点防护的"开箱即用"策略——只提供精确的指纹原语。