GitHub 加速器 zijinggong/fastgithub-accelerate

fastgithub-accelerate

让 DSH 的 GitHub 流量自动加速，两种方式任选其一：本地安装 FastGithub，或者配置任意自定义 HTTP(S) 代理——不用手动配代理，不用浏览器扩展，不用重新构建。

装好之后，web_fetch / web_search、git / curl，以及 Node 侧的 fetch，都会透明地加速 GitHub，输入框里还有个小徽章，实时显示状态和当前生效的加速来源。

status badge

为什么需要它

- DSH 拒绝解析到回环地址的主机：dsh-web-fetch-http 会锁定公网 IP，只要主机解析到私有/回环地址，就返回 WEB_BLOCKED_URL——除非 URL 走的是已安装的代理策略，这时会跳过锁定，交给代理解析。
- 任何加速器，只要能把 GitHub 流量引到更快的链路上，一旦接入 DSH 的代理策略，问题立刻解决。

这个 bundle 就是把加速来源接进那套策略——有 FastGithub 就用 FastGithub，没有就用你配置的自定义代理。

工作原理

1. Host 侧（index.js） 选出当前生效的加速来源（status.source）：
- fastgithub——FastGithub 的 DNS 劫持已启动时，DSH 流量走本插件的回环正向代理（127.0.0.1:39467），它的 DNS 解析会落到 FastGithub 的拦截器上；
- custom-proxy——设置了 config.proxyUrl 时（且 FastGithub 不存在，或 mode 指定如此），DSH 流量直接走那个上游 HTTP(S) 代理（gh-proxy / Cloudflare-Workers 加速器、公司代理、VPN 节点……）。不需要本地 FastGithub，也不需要 MITM 证书。
2. 它从规范 realpath 加载 @deepseek-ai/dsh-http-proxy（和 harness 用的是同一个模块实例），用当前生效的端点调用 installProxyFromEnvironment，于是：
- web_fetch / web_search 走它做隧道——之前被拦的 GitHub 请求现在能通了；
- git、curl 等子进程继承 http(s)_proxy 环境变量；
- undici 的全局 dispatcher 接管 Node 侧的 fetch。
3. 每 60 s 探测一次（FastGithub 劫持 + 已配置代理），并提供 GET /fastgithub/status 给徽章用。
4. Client 侧（client.js） 在输入框渲染一个徽章，显示当前生效的来源（🚀 FastGithub 加速中 / 🚀 自定义代理加速中 / ⚠ 无来源）。浏览器请求从不改写——浏览器说的是 origin-form，任何正向代理都伺候不了。

启动时导出的代理永远优先于插件端点（插件绝不覆盖你自己的代理）；这时徽章报告的是继承来的策略。

安装

在目标 DSH 里：

plugin_manager → action: install_bundle → target: <path-to>/fastgithub-accelerate

或者从 GitHub 仓库 / npm 安装（发布之后）：

dsh plugin --profile web add <owner>/<repo>
先看 INSTALL.md，里面有前置条件（FastGithub 正在运行、DNS 劫持已生效、MITM 根证书已信任）和验证步骤。

状态

| 字段 | 含义 |
| accelerating | 代理已安装且加速源已生效 |
| source | fastgithub / custom-proxy / none |
| policy | proxied / none |
| proxyUrl | 已配置的自定义代理（当 source 为 custom-proxy 时） |
| fastgithub.dnsHijack | github.com 解析到回环地址 |
| fastgithub.interceptor443 | FastGithub :443 拦截器已启动 |
| module | ok / unavailable（dsh-http-proxy 导入） |
| port / endpoint | 插件的回环代理 |

配置

bundle 导出一个 Config，包含两个键：

| 键 | 默认值 | 含义 |
| mode | auto | auto \| fastgithub \| custom-proxy。auto 在 FastGithub 的 DNS 劫持生效时使用 FastGithub，否则在设置了 proxyUrl 时回退到它。 |
| proxyUrl | （空） | 上游 HTTP(S) 代理的 http://host:port，在 FastGithub 缺席时通过它加速——比如 gh-proxy 加速器、公司代理或 VPN 节点。 |

使用自定义代理（不用 FastGithub）

目标机器上没有 FastGithub 时，配置一个可访问的上游 HTTP(S) 代理，同样能加速 GitHub：

in the profile's cordis.patch.yml
- id: fastgithub-accelerate
config:
mode: auto # auto | fastgithub | custom-proxy
proxyUrl: http://<proxy-host>:<proxy-port>

mode: auto（推荐）在 FastGithub 的 DNS 劫持生效时使用 FastGithub，否则回退到 proxyUrl；mode: custom-proxy 强制使用自定义代理，忽略 FastGithub。在配置档里改完配置后重启 DSH。

重启后，GET /fastgithub/status 会报告 "source": "custom-proxy"、"proxyUrl": "<your proxy>" 和 "accelerating": true；web_fetch 和 git 随后会把 GitHub 流量走这个代理。不需要本地 FastGithub，不需要 DNS 劫持，也不需要 MITM 根证书。

⚠️ 代理必须能稳定访问 GitHub，并且值得信任——用公共 gh-proxy 加速器时，留意它的稳定性和证书策略。

要求

- 要么 FastGithub 正在运行（fastgithub.exe start / FastGithub UI），并按 FastGithub README 完成设置（http.sslverify false、信任库中有根证书 CN=FastGithub）——要么通过 config.proxyUrl 传入一个可访问的自定义代理。
- 两者都没有时，插件能正常加载，但会报告 source: "none"，不加速。

许可证

MIT