用 Cloudflare Workers 搭建 GitHub 文件代理加速

用 Cloudflare Workers 搭建 GitHub 文件代理加速

2025-03-09 周日
639 字 · 3 分钟

在国内网络环境下,访问 GitHub 常常面临速度缓慢甚至连接不稳定的问题,尤其是在下载大型仓库或发布文件时更为明显。

本文将详细介绍如何利用 Cloudflare Workers 搭建一套高效的 GitHub 文件代理加速服务,帮助你轻松解决这一痛点。


项目介绍

本教程将基于 hunshcn 开发的开源项目 gh-proxy 实现,这是一个专为加速 GitHub Release、archive 及项目文件下载而设计的工具。

gh-proxy
项目地址:https://github.com/hunshcn/gh-proxy


准备工作

首先,你需要拥有一个 Cloudflare 账号。如果你还没有账号,可以按照以下教程进行注册:


教程

注册好之后,新建一个 Workers

步骤1:创建 Workers 服务

  1. 登录 Cloudflare 控制台后,在左侧导航栏向下滑动找到相关服务
    QQ20250112-201443.png

  2. 点击 Workers 和 Pages 进入服务管理页面
    QQ20250112-201733.png

  3. 点击 创建 按钮开始新建 Workers 服务
    QQ20250112-201830.png

  4. 完成创建后,进入 Workers 服务详情页,点击 编辑代码 按钮
    QQ20250112-203027.png

  5. 复制 gh-proxy 项目的源代码 到代码编辑区域,然后点击 部署 按钮完成部署(注:界面可能会因 Cloudflare 后台更新而略有差异)
    QQ20250112-203142.png

  6. 配置自定义域名:由于 Cloudflare 提供的默认域名(xxx.workers.dev)在国内网络环境下可能无法访问,建议配置自定义域名。进入 设置 > 域和路由,添加已托管在 Cloudflare 的域名。配置完成后,Cloudflare 会自动完成二级域名解析和 HTTPS 配置
    QQ20250112-205004.png

附录:自定义主页(可选)

如果你希望为代理服务添加自定义的网页界面,可以修改代码中的 ASSET_URL 变量:

JS
const ASSET_URL = 'https://hunshcn.github.io/gh-proxy/'

https://hunshcn.github.io/gh-proxy/ 替换为你托管的HTML页面地址,例如:https://www.tbedu.top/assets/pages/gh-proxy/

使用方法

配置完成后,你可以通过以下方式使用 GitHub 文件代理加速服务:

如果你自定义的域名是 github.tbedu.top,那么访问格式为:https://github.tbedu.top/[完整的GitHub文件地址]

例如:https://github.tbedu.top/https://github.com/EasyTier/EasyTier/releases/download/v2.2.0/easytier-windows-x86_64-v2.2.0.zip

性能测试

以下是使用该代理服务的测速结果(测试时间:2025/01/12):

QQ截图20250112205638.png
QQ截图20250112205741.png

示例服务

如果你想直接体验,可以访问笔者搭建的 GitHub 文件代理服务:


Thanks for reading!

用 Cloudflare Workers 搭建 GitHub 文件代理加速

2025-03-09 周日
639 字 · 3 分钟