软件简介:
国内访问 github.com 时通时断,典型症状:浏览器转圈半天超时,但 `api.github.com` 一直是通的,只有网页打不开。根因通常不是墙,而是 本地 DNS 解析出来的那个 GitHub IP 在当前线路上不通 ——浏览器老实地按 DNS 走,就卡死了。手工往 hosts 里钉 IP 只能管两三天。
狐径 FoxPath 就是为解决这个问题而诞生,他是 GitHub 直连助手 · 本机代理 + PAC 绕过 DNS/hosts · 直连实测可用的 GitHub 官方 IP · 免管理员、不改系统设置
软件信息
| 版本号 | 1.2.1 |
|---|---|
| 运行平台 | Windows |
| 授权方式 | 免费 |
| 软件分类 | 其他软件 |
| 更新时间 | 2026-10-19 |
原理:
浏览器 ──PAC──> 狐径本地代理 127.0.0.1:8787 ──> 实测可用的 GitHub 官方 IP
(只代理 github.com) (绕过 DNS)
| 传统做法 | 狐径 |
|---|---|
| 改 hosts(要管理员、IP 死了就失效) | 本机代理 + PAC,写在 HKCU,普通用户权限即可 |
| 依赖系统 DNS 解析 | 不查 DNS,直连实测能用的官方 IP |
| IP 失效后彻底打不开 | 每 5 分钟重测一轮,死 IP 自动换 |
| 程序退出后系统代理指向空端口,比原来更糟 | 退出/点「退出并还原」都会还原;PAC 带 DIRECT 兜底;还有 --restore 一键收尾 |
核心机制:
体检:每 5 分钟并发重测候选池,条件是 TCP 443 握手 + TLS 证书校验 + HTTP 首包必须返回 2xx/3xx。 最后这条很关键——有些 IP 证书是对的,但只服务 API/CDN,访问 github.com 首页会返回 400,必须过滤掉。
候选池刷新:定期从 api.github.com/meta 重拉 GitHub 官方公布的 IP 段,官方换 IP 了也能跟上。
自愈:候选全部失效时,依次尝试重拉官方表 → 查询系统 DNS → 放宽超时重测。三步都不通才判定真不通,此时退回系统解析(和没装本程序一样,不会更糟)。
退出安全:正常退出和静默模式(开机自启)都会把系统代理恢复成运行前的状态; 还原备份固定存在 %LOCALAPPDATA%FoxPathproxy-backup.json(不再依赖 exe 同级是否可写); 备份写不进去时不会去改注册表(宁可不开,也不留下无法还原的状态)。 另有一条 –restore:即使备份没了、程序也删了,也能把残留的 PAC 设置收干净。
在线升级:控制面板最上面那张卡片里检查更新,升级源读仓库的 version.json(Gitee raw 优先、GitHub 兜底); 新版下到 .new、比对 SHA256 通过后才交给小助手覆盖并重启。程序没有”安装”这一步,升级就是换 exe。
单实例:用 Windows 命名互斥保证只有一个实例;重复双击不会起两个进程去抢 8787/8788。
使用方法:
1、下载 exe,双击运行
2、浏览器自动打开控制面板 http://127.0.0.1:8788/ui
3、勾选「开机自启」即可后台常驻
首次启动请等 15~20 秒(要并发体检 49 个候选 IP),体检完成前代理尚未完全生效。
更新日志:
v1.2.1
升级源 / 下载地址切到 GitCode(国内更快),Gitee / GitHub 兜底;验签不变
已知边界(照旧)
运营商如果按 SNI 掐断(TLS 握手里能看到域名),本地代理帮不上忙 —— 只能换网络或换方案。
线路分钟级抖动期间,主站可能”通几秒、堵几十秒”,体检与吞吐挑 IP 会如实反映。
只代理 GitHub 相关域名;不改 hosts、不改系统 DNS,退出时还原系统设置。
控制面板只监听 127.0.0.1,接口已做 Host/Origin 同源校验。
文件说明:
| 文件 | 说明 |
|---|---|
FoxPath.exe |
主程序,绿色单文件,双击即用。版本号写在 exe 属性里(鼠标悬停 / 右键-属性-详细信息) |
version.json |
升级信息,已装用户点「检查更新」时读取。这个附件不能少,否则老版本拿不到升级提示 |
开源地址:
https://gitee.com/kele551/FoxPath
https://github.com/kele551/FoxPath
下载地址:
软件截图:













