Skip to content

Latest commit

 

History

History
102 lines (89 loc) · 9.53 KB

GLOSSARY.md

File metadata and controls

102 lines (89 loc) · 9.53 KB

术语速查

只收本项目自造的机制词——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