Windows 本地 GitHub 加速代理(中国大陆访问 GitHub 用):按 routes.json 给 GitHub 系域名选 IP,可选 MITM 纠错,可选接管浏览器 PAC 与 git。
| 慢的原因 | 做了什么 | 效果 |
|---|---|---|
| 域名解析被干扰,返回假地址,连到假服务器 | 内置真实 IP 表(routes.json)跳过解析,直连表内 IP;候选按实测建连延迟升序——每次拨号自动回流,失败自动降权,测速按钮提供重启后的初始基线;游标驻留的 IP 优先 | 干扰免疫,首连落在实测最快 IP |
| 边缘 IP 迁移、部分 IP 间歇不可达 | 每(IP,域名)组合实测记账:连接失败冷却 2 分钟、服务端拒绝冷却 4 小时;失效 IP 不重复浪费等待,恢复后自动回队 | 首连落在实测最快 IP,失效 IP 不重复浪费等待 |
| 握手第一段明文里的目标字段触发针对性干扰——TCP 通了,TLS 完不成(不开 MITM,透传) | 握手消息拆 2~3 段、隔随机时间发送——真名保留,分片让干扰拼不齐 | 干扰窗口期连接照样建立——一切加速的前提 |
| 同上(开 MITM) | 握手里的目标字段直接换成不受限域名,证书按预设锚点验证(验的仍是真 GitHub 证书)——不依赖分片运气 | 干扰不适用;连接建立完全不受窗口期影响 |
| 一页十几个域名各建各的 TLS 连接,一排握手串行等待 | 同 IP 只建一条 HTTP/2 连接多路复用(:authority 区分目标);并发建连按 IP 仲裁,只放一个去拨 | 握手次数从按域名计降到按 IP 计,冷启动大幅缩短 |
| 单连接上并发流互相争抢;空闲连接被服务端回收,下次重握手 | 每 IP 恒 1 条通道,流排队由 h2 服务端配额调度;闲置 10 秒销毁 | 不养僵尸连接,并发不失控 |
| 发版日全部 js/css/字体换新哈希 URL,全网抢拉 + 网络波动,极慢 | 同 URL 只拉一次(并发的重复请求等首拉结果);拉取与浏览器解耦,页面关了也拉完入库;之后本地磁盘回放 | 发版日只慢一波,整个版本周期资产零网络 |
| 列表页/首页/头像内容没变,却每次重新下载 | 列表页会话内缓存、首页骨架 7 天、头像 302 本地直答;仓库页 HTML 永不缓存,真拉真交付 | 高频页面零等待,低频页面保新鲜 |
| api.github.com 上游 75% 是埋点和心跳,真请求被挤在后面 | 三类遥测本地读掉回 204,零字节发往 GitHub | api 上游归零,真请求显著变快 |
| release 附件单条连接拉取,跨境单流只有几百 KB/s | 按字节切段,直连 + 镜像同台并发;慢段按速率反比让位,停滞收割后断点续拉,按偏移拼回完整文件 | 总吞吐贴最快链路,不被单条慢链路拖死 |
| 镜像站时好时坏,固定顺序轮询反复撞死镜像 | 记录失败时间与吞吐,请求优先派给健康且快的;整链全灭熔断 60 秒,同域毫秒级快速失败 | 可用时不空耗,不可用时不傻等 |
| 部分请求浏览器没主动要压缩,白多传字节 | github.com / api 强制 gzip:仓库页 327KB → 44.5KB;其余放行原生 br/zstd | 传输量降约 7 倍 |
另有两件不图快的事:githubassets 资产入库——同 URL 只拉一次、与浏览器解耦(页面关了也拉完入库),只是不让重复拉白占网络;不写 hosts、不写 sslVerify、不需要管理员——卸载零残留。
- 这是 GitHub 加速器,不是全局代理:非 GitHub 域名只放行 443 隧道,其余一律
502 - 镜像无内容校验:流式转发无法既校验又实时交付,单家镜像只能污染自己负责的那段
- 页面缓存与资产库明文落盘,隔离只靠 ACL
- 半开放 443 隧道:本机任意进程可把它当"任意公网 443"的转发器;内网与环回已被 bogon 过滤挡住
- 仅 Windows,依赖 BoringSSL 本地编译
- 仓库不附基准数据,代码注释里的实测数字都来自作者环境
gitport-github.exe [-port 7810] [-webui 7811] [-tray] [-headless]
| 参数 | 含义 |
|---|---|
-port |
代理端口,默认 7810 |
-webui |
工作台端口,默认 7811 |
-tray |
启动即最小化到托盘 |
-headless |
无窗口无托盘,只跑代理与工作台 |
代理与工作台都只绑 127.0.0.1。第二次启动不会重复起进程,会把已在运行的窗口唤出。
首启的接管开关都是关的:程序会起代理,但不动系统设置。要么在界面上打开开关,要么自己把软件代理指到 127.0.0.1:7810。
| 开关 | 默认 | 打开后写什么 | 怎么撤 |
|---|---|---|---|
| 分流接管 | 关 | HKCU 的 AutoConfigURL → 本地 proxy.pac;同时接管 git 全局 http.proxy/https.proxy 与 6 个 GitHub 域的 sslCAInfo |
关开关或退出程序:只还原自己写的那条,别家的不动 |
| MITM | 关 | 把 ca.crt 装进当前用户受信任根 |
证书管理器里删除 GitPort Root;ca.key 在 exe 目录 |
| 关窗到托盘 | 关 | 关窗口不退出 | 关掉即可 |
| 开机自启 | 关 | HKCU\...\Run 一项 |
关掉即删 |
ca.key 权限收紧到当前用户;收紧失败会删掉私钥并禁用 MITM,不会降级硬跑。
与 exe 同目录。
settings.json:开关、镜像注册表、串发游标、还原备份。某个值写坏只回退该字段,不连坐整份配置。routes.json:ips(IP + 伪装 SNI + 证书校验锚点 + 服务的域名)与hosts(域名 + 四个开关位)构成二部图;可直接手改。session:带登录态,固定同一 IP,不开第二条通道content:可竞速、可切片、可挂镜像链big:大文件/Release,单通道长流 + 大镜像链direct:不进代理
mirrors/mirrors_big:路由键 → 镜像链。- 内置
seeds.json只在全新安装建表、或给已有表补节点时用,不会新建域名行。
每 IP 恒 1 条 h2 连接(多通道就换 IP),闲置 10 秒焚毁;会话域固定同一 IP。这些是写死的常量,不是可调项。
首次安装内置 6 家(可按条停用):
gh-proxy.org gh-proxy.com ghgo.de5.net
gh.meali.top gh.dpik.top ghproxy.icu
- 只对
GET/HEAD的大文件与 Release 路径生效;API 与会话域不走镜像。 - 发请求前剥掉 Cookie / Authorization / Referer / UA。账号凭据不外流。
- 校验只到结构:状态码、非 HTML、206 起点、区间与总长。没有内容哈希。
- 后果:单家镜像只能污染自己负责的那段(压包解压会报 CRC 错,exe 可能不报);只有一家可用时等于单源完整替换;全部段受控时与单源无异。
要彻底归零只有一条路:下载后自己核对官方 SHA256 / GPG。不核就把镜像停用,代价是跨洋大文件变慢。列表本身会过期——公共镜像随时失效,程序运行期会探针熔断。
ca.crt / ca.key 本地 CA
settings.json 开关与备份
routes.json 路由表与镜像链
.cache/ 页面缓存与资产库(明文)、crash.log、tray.log
启动会打一行分段耗时(配置 / 路由表 / CA / 代理),排障用。日志与页面缓存都落在 .cache。
cargo build --release
cargo test
仅 Windows。.cargo/config.toml 里固化的是作者机器上的 BoringSSL 构建路径(clang-cl + Ninja + nasm + 指定工具集),换机器要改。
机制细节(分流矩阵、通道池、失败分级、切片与合并、解密面)见 docs/architecture.md;缓存体系全解(三层各管什么、胚与资产库怎么配合、日志判读)见 docs/cache.md。