只收本项目自造的机制词——TCP/TLS/SNI 这类教科书基础词不收(README 与各文档首次出现处已就地解释)。数字全部与当前代码常量对齐(出处见表尾),机制条目以现行代码为准——本文件不收历史方案。
| 名词 |
大白话 |
| 二部图 |
routes.json 的组织形式:左边 65 个 IP 节点、右边 25 个路由键,边 = "这个 IP 服务这些域名"。没有边就不能服务,这是数据约束 |
| 路由键 |
github.com / *.github.com / objects.githubusercontent.com 这类条目。精确键覆盖自身+子域,*. 通配键只覆盖子域 |
| 四开关位 |
每个路由键的属性:session(带登录态,固定同一 IP)、content(可竞速可切片)、big(大文件/Release,挂大镜像链)、direct(不进代理) |
| 边 |
一个 (IP, 路由键) 组合——路由行为的最小记账单位。它的状态小黑屋三档见下条 |
| 边冷却 |
某条边的实测小黑屋,三档:响应 421 / 证书不匹配 → 4 小时;新拨连接超时/断连 → 120 秒;风控拦截页 → 600 秒。风控冷却只能到期自愈,不被"成功"洗白。只有响应层会写边:TLS 校验失败、TCP 连不上都不写边 |
| 死亡退避 |
IP 级 TCP/TLS/h2 失败后的记账,串发/竞速跳过它 |
| 通道 |
一条 IP 上的 h2 连接。每 IP 恒 1 条,多域名靠 h2 :authority 多路复用 |
| 通道池 |
全仓唯一取连接的入口:要连接只找它,同 IP 已有通道直接复用 |
| 建造锁 |
同 host 取通道未命中只放一个进拨号(雷群去重),等锁者直接 await,最多等 15s |
| 闲置焚毁 |
通道空闲 10 秒销毁——这就是替代"定时探活"的机制,探活已整体移除 |
| 黑洞判定 |
响应头到了但 30 秒零数据字节 = 上游黑洞,判死换路 |
| 遥测拦截 |
GitHub 前端埋点(/_private/browser/*、alive、collector)本地读掉回 204,零字节发往上游 |
| 拨号并发闸 |
真实流量的拨号总闸:同一时刻最多 48 个拨号在途——开个页面几十条连接并发要建连,没闸会打爆自己 |
| 伪装 SNI |
池内握手第一句写 baidu.com 等不受限域名,证书按 verify 锚点验证真 GitHub 证书——SNI 阻断不适用(MITM 模式) |
| 握手分片 |
透传(MITM 关)时把浏览器的 ClientHello 拆 23 段、首刀 116B 随机、段间隔 20~70ms 随机发送——DPI 单包拼不齐 SNI 就不会掐 |
| gh_defuse |
风控页化解:403 restricted / 400 Whoa 拦截页本地识别,(IP, 域名) 记 600s 风控冷却,换 IP 重试 |
| 名词 |
大白话 |
| 镜像链 |
每种资源的"复印店优先级名单"。内置 6 家(gh-proxy 系),单链上限 5;名单来自 routes.json,可加自部署镜像。只对 GET/HEAD 的大文件与 Release 路径生效 |
| 直连腿 |
直连以 direct/{host} 身份参与切片竞速,与镜像一视同仁 |
| 切片前提 |
GET、非探片、区间 ≥ 512KB、空闲源 ≥ 2 家、总长可探——任一不成立走单流 |
| 探片 |
无 Range 的请求先发 bytes=0-0 探总长;总长记 10 分钟,同 URL 下一条不必再探 |
| 段位 |
无 Range:空闲源数等分;带 Range:同 URL 在途区间总字节 ÷ (镜像数 + 直连 1),大区间先占、每请求保底 1 段 |
| 刀口 |
段边界偏移。每段必须 206 且 Content-Range 起点对准刀口、终点不越界——错位 = 静默截断,按这家失败换下一个 |
| 让位 |
段停滞 5 秒零帧 → 慢段缩边界,已收字节留下、尾巴排补发(缓冲一个字节不丢);让位冷却 1.5s / 2.5s |
| 补发 |
按偏移重拉尾巴;接手按 ECT 挑家(不能挑"最空闲"——刚断流负载归零恰是最空闲);连续 6 次空手放弃 |
| ECT 时间槽 |
派发打分:在途字节 ÷ 上一窗(500ms)实收 = 还需几个槽跑完,最小者胜、无容差;零历史垫底(闲者先试)。每面源独立记账,独立线程 500ms 一拍 |
| 降权 |
镜像失败两档:硬错误(拒连/RST/坏回包)45 秒、超时类 15 秒——慢不等于死 |
| 熔断 |
镜像链整链全灭 → 60 秒快速失败;零镜像时直连独走不连坐 |
| 直连多路 |
媒体白名单 7 域(raw/user-images/private-user-images/media/camo/gist/avatars)的切片:探片 10KB 记总长,恒 4~8 段(目标 192KB)全部骑池内同一条通道并发拉,5s 界由镜像救援续传;185.199 聚合水管恒定,多连接不加吞吐 → 关让位 |
| 身份头剥除 |
镜像/切片请求剥 Cookie / Authorization / Referer / UA,注入恒定浏览器 UA——账号凭据不外流,CF 系镜像拦非浏览器 UA |
| 总长记忆 |
探得/记忆的总长与 206 自报不符 = 记忆陈旧 → 作废回单流(对象换版/镜像转码) |
| 名词 |
大白话 |
| 资产库 |
githubassets 的 js/css/字体按 URL 一存永逸,本地透明回放;15MB 池按文件年龄从旧到新淘汰。收录门:200 + js/css/字体;仓库页 html 一律不缓存(三次白屏教训,见 CACHE.md) |
| 时代中立 |
URL 里的内容哈希就是内容指纹,同 URL 永远同字节;发版换哈希 = 新条目,库永远不会给错内容 |
| 骨架 |
首页框架页(/)跨会话缓存 7 天——纯框架页,数据全靠 XHR;超期交旧 + 后台静默重拉 |
| 会话缓存 |
列表页/搜索页会话内缓存,空闲 15 分钟清盘 |
| 身份标签 |
未登录固定一枚;登录 = user_session 值的摘要。同机两账号不串页 |
| SESSION_EPOCH |
会话号:首次导航写当前毫秒,间隔超 15 分钟 +1 并清会话条目;重启必新会话 |
| 闸门页 |
2FA 验证、密码确认、限流页——GitHub 拿这些顶替你请求的 URL,拒收 |
| 截断自愈 |
骨架条目缺结尾标记 → 当场删文件当 miss |
| 名词 |
大白话 |
| 诊断头 |
响应带 x-gitport-route:cache / 302memo / direct-split / dns / direct / stream / mirror |
| 302 记忆 |
头像等跳转本地直答(学 301/302/307/308,直答 302),4096 条、6 小时 TTL |
每行说清这条数字管什么行为、超了会怎样;「代码在哪」只给文件名——具体常量名进文件一搜即得。
| 场景 |
数值 |
代码在哪 |
| 代理 / 工作台监听端口 |
7810 / 7811 |
config.rs |
| 浏览器发来 CONNECT/请求后,收不齐完整请求头 |
30 秒断开,防半开连接挂死 |
config.rs |
| 对候选 IP 拨号:TCP 连接 / TLS 握手各自限时 |
1.15s / 1.35s,超时这个 IP 判不可用换下一个 |
config.rs |
| TCP+TLS 都通了,等 GitHub 回 HTTP/2 设置帧 |
最多 5 秒,否则整条连接作废 |
config.rs |
| 一条 h2 通道空闲(没有在途请求) |
10 秒销毁——下次请求重新拨号,这就是替代"定时探活"的机制 |
config.rs |
| 响应头已收到、但之后一直没有数据字节 |
30 秒判上游黑洞,换路 |
config.rs |
| 非 MITM 透传隧道:接通后等浏览器第一字节 / 整条隧道寿命 |
8 秒断开防黑洞挂死 / 最长 1 小时兜底 |
config.rs |
| 同时服务的连接总数 |
最多 256 条,防止狂开 CONNECT 拖垮常驻进程 |
config.rs |
| 同一时刻在途的拨号数 |
最多 48 个——开个页面几十条连接并发要建连,没闸会打爆自己 |
config.rs |
| 透传模式的握手分片:TLS 握手第一包拆 2~3 段转发 |
首段 116 字节随机、段间隔 2070ms 随机——审查拼不齐 SNI 就不会掐 |
config.rs |
| 内存日志环 |
保留最近 2000 条 |
config.rs |
| 同一个 host 已有人在拨号,其他请求排队等它建连 |
最多等 15 秒,超时走兜底腿 |
pool/mod.rs |
| 拨号成功但太慢的线 |
超过 1.5 秒 = "慢成功",排序垫底 |
upstream.rs |
| (IP, 域名) 组合的小黑屋:回 421/证书不匹配、新连接超时断连、出现风控拦截页 |
分别 4 小时 / 120 秒 / 600 秒不碰;风控冷却只能等过期,成功不会洗白 |
edges.rs |
| 边状态账本容量 |
8192 条,满淘汰最早到期的 |
edges.rs |
| 文件/区间小于多少不切片 |
512KB 以下直接单流拉 |
merge.rs |
| 一个段几秒没有数据字节 |
5 秒 = 停滞:慢段把尾巴让给别的源,已收字节保留 |
merge.rs |
| 让位的防抖间隔 |
同段两次至少隔 1.5 秒、全局两次至少隔 2.5 秒,防连环切 |
merge.rs |
| 尾巴补发连续空手几次放弃 |
6 次(有一次进展就清零重来) |
merge.rs |
| 每段在内存里最多缓冲多少 |
2MB,快段先到的数据攒着等交付线推进 |
merge.rs |
| 一条镜像链最多挂几家 |
5 家 |
mirror.rs |
| 镜像出错后多久不派新活 |
硬错误(拒连/回包坏)45 秒;只是超时 15 秒——慢不等于死 |
mirror.rs |
| 给每面源结账的周期 |
500ms 一拍:按"在途字节 ÷ 上窗实收"派发新段,最快的源接 |
mirror.rs |
| 专门拉镜像的备用连接 |
最多留 4 条,60 秒没人用就关 |
upstream.rs |
| js/css/字体资产库总容量 |
15MB,满了从最旧的文件开始淘汰 |
asset_store.rs |
| 页面缓存总量 / 单条页面上限 |
200MiB / 单条超过 2MiB 不收 |
page_cache.rs |
| 列表页会话缓存清盘 |
15 分钟没有浏览动作就整盘清 |
page_cache.rs |
| 首页框架页缓存 |
7 天,过期交旧壳同时后台重拉新壳 |
page_cache.rs |
| 头像等跳转的本地直答 |
记 4096 条、6 小时内有效 |
redirect_memo.rs |
| MITM 现签证书的缓存 |
512 张,满淘汰最旧 |
certgen.rs |