GitHub 没有在中国大陆部署服务器和 CDN 节点，所有访问都要走跨境国际互联网出口，叠加几个网络层面问题，所以表现为：有时能打开、有时超时、网页打开但图片 / 头像 / Release 下载失败。
一、你遇到的问题：GitHub 在国内为什么这么慢？
在中国大陆的网络环境下，github.com、raw.githubusercontent.com、codeload.github.com 等 GitHub 官方域名经常出现以下现象：
- 打开仓库页面转圈半天，最后提示连接超时
git clone卡在Receiving objects: 42%，进度条长时间不动- Release 里的安装包只有几十 KB/s，下到一半直接中断，浏览器还无法续传
curl -fsSL https://raw.githubusercontent.com/... | bash一直卡住，一键安装脚本根本跑不起来- 公司电脑或云服务器上装不了代理工具，换第三方镜像站又担心同步不及时、内容被二次修改
这些问题大多不是你的网络「坏了」，而是跨境链路的问题：GitHub 的服务器在境外，请求需要经过国际出口，晚高峰时链路拥塞、丢包率升高，速度就会剧烈波动甚至直接失败。
二、典型使用场景
只要你的工作流里出现「GitHub 链接」，下面这些场景都可能用得上 ghclone：
- 克隆开源项目：学习源码、二次开发，整仓
git clone或浅克隆 - 下载软件安装包：大量工具通过 GitHub Release 分发安装包（exe / dmg / AppImage / tar.gz）
- 服务器与容器环境：云服务器、CI/CD（持续集成与持续交付）流程中拉取公开仓库、依赖与脚本
- 获取配置文件与一键脚本：Raw 原始文件场景，如安装脚本、docker-compose 配置、dotfiles（点文件）同步
- 下载源码归档：不装 git 时直接下载分支 / 标签的 Archive 源码包（zip / tar.gz）
- 查看与下载 Gist：分享出去的代码片段页面与原始文件同样可以加速
- 解析仓库版本：在首页粘贴仓库主页链接，直接查看 Release 版本列表、资产体积与下载次数
三、ghclone是什么？有什么特点？
ghclone是一个面向公开开源资源的 GitHub 下载加速网关：把原始 GitHub 链接拼接到加速域名之后，请求就会经由 Cloudflare 全球边缘节点（离你最近的中转机房）中转，全程不需要自备服务器，也不需要注册账号。
它的主要特点：
- 免费、无需注册：打开网页即用，不设账号门槛，也没有隐性的下载次数限制（服务端仅做防滥用限流）
- 五类资源全覆盖：Release 资产包、Raw 原始文件、Archive 源码包、Gist 代码片段、git clone 克隆
- 三种链接写法，零成本迁移：兼容「加速域名 + 原始链接」「
/gh/前缀」「裸域名拼接」三种写法，与主流加速站习惯一致，已有脚本、IDE 配置、CI 流水线几乎不用改 - 智能多线路调度：浏览器侧并发探测各线路延迟、自动选当前最快的一条；服务端对失败请求自动重试与熔断降级
- 支持断点续传：完整透传
Range请求头，配合 wget / curl / aria2 等工具可从断点继续下载大文件 - 边缘缓存加速：Raw 文件与 Releases 解析结果命中边缘缓存后无需回源 GitHub，重复访问更快
- 可视化工具链：首页提供链接转换器与 Releases 解析面板，服务状态页展示 72 小时请求数与流量统计
- 安全只读：只代理公开资源；
Cookie、Authorization（授权头）等敏感请求头会被剥离；登录、注册等账号相关路径会被直接拦截，保护你的账号安全
四、解决痛点：一条链接替换，覆盖全部下载场景
| 常见痛点 | ghclone的解决方式 |
|---|---|
git clone 卡死、反复中断 | 边缘节点中转 + 多线路自动选优，克隆、浅克隆、增量拉取都支持 |
| Release 大文件下载慢、断流 | Range 透传支持断点续传，配合 wget -c / aria2c -c 从中断处继续 |
| raw 文件打不开、脚本装不上 | Raw 加速支持管道执行，一键安装脚本可直接运行 |
| 镜像站不稳定、内容可能被改 | 直连 GitHub 官方源，内容不被改写，只做透明转发 |
| 服务器环境装不了代理工具 | 无需安装客户端，纯 HTTPS 请求，任何环境都能用 |
| 不知道用哪个加速线路 | 页面自动测速选优，无需手动切换 |
五、使用步骤：3 分钟完成第一次加速
第 1 步：准备好原始 GitHub 链接
例如：https://github.com/ayuday/vkeyboardhand/archive/refs/heads/main.zip
第 2 步：在链接前面拼接加速域名（三种写法任选其一）
写法 A（推荐，最通用）：
https://ghclone.com/https://github.com/ayuday/vkeyboardhand/archive/refs/heads/main.zip
写法 B（更短，适合手动输入）：
https://ghclone.com/gh/github.com/ayuday/vkeyboardhand/archive/refs/heads/main.zip
写法 C（裸域名拼接，首段必须是 GitHub 域名）：
https://ghclone.com/raw.githubusercontent.com/ayuday/vkeyboardhand/main/README.md
第 3 步：浏览器直接访问，或用命令行下载
# wget：断点续传下载
wget -c https://ghclone.com/https://github.com/ayuday/vkeyboardhand/archive/refs/heads/main.zip
# curl：跟随重定向、输出到文件
curl -fL -O https://ghclone.com/https://github.com/ayuday/vkeyboardhand/archive/refs/heads/main.zip
# aria2：多线程分段下载
aria2c -x16 -s16 https://ghclone.com/https://github.com/ayuday/vkeyboardhand/archive/refs/heads/main.zip
第 4 步：加速 git clone
# 常规克隆
git clone https://ghclone.com/https://github.com/ayuday/vkeyboardhand.git
# 最短写法（裸仓库形式）
git clone https://ghclone.com/ayuday/vkeyboardhand.git
# 大仓库建议浅克隆，只拉最新一次提交
git clone --depth=1 https://ghclone.com/ayuday/vkeyboardhand.git
六、常见问题（FAQ）
Q1：ghclone收费吗？需要注册吗？ A：完全免费，不需要注册，也没有客户端要安装；服务运行在 Cloudflare 的免费额度与免费套餐体系内。
Q2：支持私有仓库吗？ A：不支持。ghclone只加速公开资源，私有仓库请使用官方地址或自行配置网络环境，也不要在请求中携带任何账号凭据。
Q3：会泄露我的 GitHub 账号吗？
A：不会。网关只做公开资源的只读转发，Cookie、Authorization 等敏感请求头会被剥离，登录、注册、会话等账号相关路径会被直接拦截（返回 403）。
Q4：下载中断了怎么办？
A：换用支持续传的工具重新下载即可：wget -c、curl -C -、aria2c -c 都会从中断处继续，不会重复下载已完成的部分。
Q5：为什么速度有时快有时慢？ A：实际速度与你的本地网络、运营商线路、所在地区到边缘节点的距离有关；页面会自动并发测速并选择当前最快的线路，无需手动操作。
Q6：支持哪些 GitHub 域名？ A：覆盖 github.com、raw.githubusercontent.com、codeload.github.com、gist.github.com 等 GitHub 官方域名，并通过白名单机制拦截非 GitHub 目标，保证只做 GitHub 加速。
