GitHub 访问加速 · v1.0.1 · MIT · Releases
v1.0.1 修复(T6):优选探测从「TCP + TLS 握手」推进到「真实 HTTP 请求」,能淘汰只握手不应答的半死 IP 与 GitHub 风控页节点;
--refresh-ips不再把官方 CIDR 机械展开成候选地址。详见 docs/DESIGN.md 的 T6 记录。
从 GitHub 官方 IP 网段中测速选出当前最优地址,把本地 CONNECT 隧道钉到该 IP,改善国内网络下的 DNS 污染与连接抖动。
不装根证书 · 不解密 HTTPS · 不需要管理员权限 · 零第三方运行依赖(Python ≥ 3.8 标准库 + Tkinter)。
| ✅ 做 | ❌ 不做 |
|---|---|
| 白名单 GitHub 域名的官方 IP 优选 | 境外代理 / VPN / 中继节点 |
本地 127.0.0.1 代理 + 系统代理(HKCU) |
TLS 中间人 / 自签 CA / 脚本注入 |
| 一键启停、状态反馈、规则可配置 | 劫持非白名单流量(一律原样直连) |
失败回退、结构化日志、--selftest |
绕过网络管控 / 企业安全策略 |
| 只记 host:port 与字节数,不联网上报 | 承诺访问依法不可访问的内容 |
候选 IP 只来自 GitHub 官方网段,流量终点始终是 GitHub 自有服务器;浏览器验证的仍是 GitHub 官方证书。企业环境请先取得 IT 许可后再使用。
python -m ghacc # 图形界面(默认)
python -m ghacc --cli # 无桌面 / 服务器
python -m ghacc --selftest # 自检 + 取证(退出码 0/1/2)
python scripts/selftest.py # 同上,无需安装包三端启动脚本:run.bat / run.sh / run.command;GUI 不可用时自动降级 CLI。
Windows 免安装:到 Releases 下载 GHAccelerator-1.0.0-win64.zip,解压后双击 GHAccelerator.exe;GHAccelerator-cli.exe 用于 --selftest / --status / --restore。单文件版 GHAccelerator-portable.exe 启动时解压到 %TEMP%(约 2~6 秒),企业管控环境建议用便携目录版。
| 文件 | 内容 |
|---|---|
config/settings.json |
监听端口(默认 18792)、模式、探测超时、TLS 校验开关、缓存 TTL、日志级别、回退策略 |
config/rules.json |
目标域名白名单(精确 + *.suffix 通配)、三个官方 IP 池、fallback |
GUI 的「目标网址与规则」「设置」两个标签页可直接编辑并保存;用户改动优先写 ~/.ghacc/config,程序目录只读时自动降级为纯内存配置。--refresh-ips 从 api.github.com/meta 补充候选,失败则完整保留内置池。
浏览器 → 系统代理 127.0.0.1:18792 → 本地代理
CONNECT github.com:443
→ 优选:并发 TCP 测速 + TLS 证书校验(SNI=真实域名,淘汰被劫持 IP)
→ socket.connect(官方 IP, 443) → 200 Connection Established → 纯字节透传
浏览器 ⇄ GitHub 官方服务器直接完成 TLS 握手(官方证书,无中间人)
| 能力 | 说明 |
|---|---|
| 一键启停 | 6 态状态机;开启前快照系统代理,关闭时精确恢复;异常退出后启动自愈 + --restore |
| 状态反馈 | 4 色状态灯、降级原因、计数器与优选结果表、常驻引擎标识、--status JSON 导出 |
| 优选健康断言 | 真实 GET / 验证状态码与风控页,淘汰「能握手不应答」的半死节点;官方 CIDR 不再展开成候选地址 |
| 失败回退 | HTTP 断言淘汰坏 IP → 证书校验失败降级重测(应用层断言仍生效)→ 系统 DNS 直连 → DEGRADED → ERROR 全撤回;DNS 解析带 1.5s 硬超时 |
| 日志/异常 | diagnose.log(2MB×3 轮转)→ 目录四级降级到纯内存;日志脱敏;selftest_<ts>.json 证据 |
| 可选 hosts 模式 | 标记块 + 备份 + 原子写 + 精确回滚(需管理员权限,默认关闭) |
python -m ghacc --selftest 全部在回环内完成,不依赖 GitHub 是否可达,含 4 组反向断言(优选全失败回退、系统代理只读降级、日志目录只读、启停快照一致性)。现场反馈三件套:selftest 输出、diagnose.log、GUI 状态截图。
| 平台 | 状态 |
|---|---|
| Windows 10/11 x64 | ✅ 主目标,本机已测 + exe 已打包 |
| Windows 7 SP1 x64 | |
| macOS 11+ / Linux GNOME | |
| 无桌面 / 服务器 | ✅ --cli |
CI:.github/workflows/selftest.yml 在 ubuntu / macOS / windows 三平台跑 selftest + 单测(覆盖 Python 3.8 / 3.10 / 3.11 / 3.14)。
scripts\build_windows.bat # onedir 双 exe + onefile 单文件
python scripts/verify_artifacts.py --dir dist/GHAccelerator --frozen # 产物校验(含 exe 自检)发布流程、哈希校验与代码签名落地指南见 docs/RELEASE.md。当前 exe 未签名,SmartScreen 可能提示「未知发布者」;仓库附 SHA256SUMS.txt、Release 附哈希清单供 IT 白名单,不引导关闭防护。
- docs/DESIGN.md — 完整设计、环境假设、平台矩阵、验证数据与缺陷闭环(T1–T5)
- docs/RELEASE.md — Release 流程、哈希校验、代码签名指南
- MIT License,见 LICENSE
本工具仅用于改善可合法访问的 GitHub 服务的解析与连接质量,不提供任何境外代理节点、不解密用户流量、不绕过网络管控。使用者应自行确认符合所在网络规范与所在地法律法规。