GitHub 加速下载代理使用指南

GitHub Proxy 是专为开发者打造的高性能 GitHub 资源加速代理服务。依托全球分布式 Anycast CDN 边缘节点与智能调度网络，彻底解决国内及跨国网络中访问 GitHub 频繁出现的连接超时、克隆龟速、大文件下载中断及 API 限流等痛点。

---

快速使用姿势

在任意合法的 GitHub 资源 URL 前，直接拼接代理域名即可发起高速下载：

https://gh-proxy.org/https://github.com/AdguardTeam/AdGuardHome/releases/download/v0.107.43/AdGuardHome_linux_amd64.tar.gz

---

支持的资源格式规范与完整清单

本服务全面支持以下各类 GitHub 资源链接，涵盖发布产物、源码归档、脚本直链、Actions 产物、Git 协议、补丁订阅及官方 API 等，点击或复制即可直接使用：

1. 仓库主页与 Releases 版本智能解析 (Repo Releases)

• 链接说明：直接输入 GitHub 仓库主页或 Releases 地址，系统自动识别并重定向至主站转换器，调用接口智能解析全部发布版本与资产。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}
  • https://github.com/{owner}/{repo}/releases
• 完整加速示例（注：由于需要调用主站 Web 转换器界面解析，该功能使用主站域名）：

  # 示例 1：直接加速 GitHub 仓库主页
  https://gh-proxy.com/https://github.com/dyang886/Game-Cheats-Manager
  
  # 示例 2：直接加速 GitHub 仓库 Releases 发布页面
  https://gh-proxy.com/https://github.com/dyang886/Game-Cheats-Manager/releases
  

• 核心解析特性：
  • 全自动识别与解析：在浏览器输入包含仓库主页的链接，自动跳转至 Web 端并即时拉取 Releases 列表。
  • 多线路直链高速下载：列出每个 Release 版本中的所有安装包（.exe、.zip、.apk、.tar.gz 等）及源码包，并提供直链下载与一键复制功能。
  • 更新日志在线展开：支持在网页端直接展开查阅每个版本的详细更新日志（Changelog）。
  • 无 Release 仓库降级保障：若仓库尚未发布过 Release，系统会自动提供主分支代码压缩包（main.zip）及 Git Clone 加速命令。

---

2. Release 发布文件与源码归档包

2.1 Release 软件发布产物（Release Assets）

• 链接说明：项目 Release 页面上传编译好的二进制程序、安装包、固件、ROM、压缩包及校验文件。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/releases/download/{tag}/{filename}
  • https://github.com/{owner}/{repo}/releases/latest/download/{filename} （最新版本直链）
• 完整加速示例：

  # 指定版本发布文件
  https://gh-proxy.org/https://github.com/AdguardTeam/AdGuardHome/releases/download/v0.107.43/AdGuardHome_linux_amd64.tar.gz
  
  # 自动重定向至最新版本的发布文件
  https://gh-proxy.org/https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64
  

• 使用场景：Shell 自动化安装脚本、Dockerfile 构建、服务器环境软件自动分发。
• 加速特性：自动跟随 GitHub 302 跳转至全球 CDN 节点，以 200 OK 流式输出给客户端，支持分块与断点续传。

2.2 分支/标签源码归档包（Source Code Archive）

• 链接说明：GitHub 自动生成的特定 Tag 或分支源码打包（zip / tar.gz）。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/archive/refs/tags/{tag}.tar.gz
  • https://github.com/{owner}/{repo}/archive/refs/tags/{tag}.zip
  • https://github.com/{owner}/{repo}/archive/refs/heads/{branch}.tar.gz
  • https://github.com/{owner}/{repo}/archive/{tag}.tar.gz （简写路径）
• 完整加速示例：

  # Tag 源码归档 (tar.gz)
  https://gh-proxy.org/https://github.com/torvalds/linux/archive/refs/tags/v6.6.tar.gz
  
  # 分支最新源码归档 (zip)
  https://gh-proxy.org/https://github.com/facebook/react/archive/refs/heads/main.zip
  

• 使用场景：开源软件源码本地编译、CI/CD 自动化依赖打包下载。

---

3. Raw 原始代码与脚本文件

3.1 官方 Raw 资源直链

• 链接说明：获取仓库内文件的原始纯文本或二进制数据（非 HTML 包装）。
• URL 匹配模板：
  • https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{filepath}
• 完整加速示例：

  # Homebrew 官方安装脚本
  https://gh-proxy.org/https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
  
  # 常用 Shell 安装脚本
  https://gh-proxy.org/https://raw.githubusercontent.com/v2fly/fhs-install-v2ray/master/install-release.sh
  

• 使用场景：curl -fsSL ... | bash 远程一键安装、拉取远程配置文件或证书。

3.2 兼容历史 Raw 域名

• 链接说明：老旧脚本、旧文档或历史项目中常见的 raw.github.com 链接。
• URL 匹配模板：
  • https://raw.github.com/{owner}/{repo}/{branch}/{filepath}
• 完整加速示例：

  https://gh-proxy.org/https://raw.github.com/BTBaseNetwork/AdsAssets/master/BTAdsVideo/StairRush.mp4
  

• 加速特性：自动预规范化为 raw.githubusercontent.com，省去客户端 1 次 301 跨域重定向开销。

3.3 仓库内 Raw 路径

• 链接说明：通过 github.com 主站路由直接访问的 raw 路径。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/raw/{branch}/{filepath}
• 完整加速示例：

  https://gh-proxy.org/https://github.com/neovim/neovim/raw/master/CMakeLists.txt
  

3.4 网页端 Blob 浏览链接（智能转换）

• 链接说明：用户在 GitHub 网页上直接复制浏览器地址栏中的文件查看链接（包含 /blob/）。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/blob/{branch}/{filepath}
• 完整加速示例：

  https://gh-proxy.org/https://github.com/v2fly/fhs-install-v2ray/blob/master/install-release.sh
  

• 加速特性：智能重写为 raw 资源下载路径，直接下载文件原始内容，彻底杜绝客户端误下载到包含 HTML 导航栏骨架网页的问题。

---

4. GitHub Actions 工作流产物（Workflow Artifacts）

4.1 Workflow Run 构建产物（免登录下载）

• 链接说明：GitHub Actions 构建完成后生成的 Artifact 打包产物（在 Actions 运行页面点击产物时复制的链接）。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/actions/runs/{run_id}/artifacts/{artifact_id}
• 完整加速示例：

  https://gh-proxy.org/https://github.com/oprypin/nightly.link/actions/runs/39804786735/artifacts/12436972061
  

• 使用场景：无需登录 GitHub 账号，直接通过 curl / wget 或浏览器极速下载 Actions 编译产物。
• 加速特性：GitHub 原链接在未登录状态下会提示 404；加速端自动调用 GitHub REST API 与内置 Token 认证池提取微软云存储预签名地址，以 200 OK 流式输出并完整保留原始文件名（Content-Disposition）。

4.2 Suites 产物跳转链接

• 链接说明：GitHub 内部 Check Suites 相关的产物链接。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/suites/{suite_id}/artifacts/{artifact_id}
• 完整加速示例：

  https://gh-proxy.org/https://github.com/oprypin/nightly.link/suites/107881443291/artifacts/12436972061
  

• 加速特性：同上，自动转为 API 免登录提取并加速下载。

4.3 Nightly.link 自动化构建构件

• 链接说明：开源工具 nightly.link 为 GitHub Actions 提供的免登录下载直链。
• URL 匹配模板：
  • https://nightly.link/{owner}/{repo}/workflows/{workflow_file}/{branch}/{artifact_name}.zip
• 完整加速示例：

  https://gh-proxy.org/https://nightly.link/crystal-lang/crystal/workflows/win/master/crystal.zip
  

---

5. Git 仓库克隆与同步（Smart Git Protocol）

5.1 Git 仓库克隆（Clone / Fetch / Pull）

• 链接说明：标准 Git 版本控制拉取链接（支持带 .git 或省略 .git 后缀）。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}.git
  • https://github.com/{owner}/{repo}
• 命令行用法：

  # 克隆大型开源仓库
  git clone https://gh-proxy.org/https://github.com/torvalds/linux.git
  
  # 为已有本地仓库配置加速拉取远程源
  git remote set-url origin https://gh-proxy.org/https://github.com/owner/repo.git
  

5.2 Git 智能 HTTP 协议探测子路径

• 链接说明：Git 客户端底层协商握手与数据传输接口。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/info/refs
  • https://github.com/{owner}/{repo}/git-upload-pack
  • https://github.com/{owner}/{repo}/HEAD
• 加速特性：自动识别 application/x-git-* 数据包与 Git 客户端，完全禁用响应缓存（no-cache），保障克隆传输的完整性与实时性；若仓库发生重命名，自动返回 301 供 Git 客户端透明跟随。

---

6. Commit / PR 补丁与 Atom 动态订阅源

6.1 提交与合并补丁（Patch / Diff）

• 链接说明：GitHub 提供的特定 Commit 或 Pull Request 的统一差异补丁文本文件。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/commit/{commit_hash}.patch
  • https://github.com/{owner}/{repo}/commit/{commit_hash}.diff
  • https://github.com/{owner}/{repo}/pull/{pr_number}.patch
  • https://github.com/{owner}/{repo}/pull/{pr_number}.diff
• 完整加速示例：

  # Commit 补丁文件
  https://gh-proxy.org/https://github.com/torvalds/linux/commit/ffc253263a1375a65fa6c9f62a893e9767fbebfa.patch
  
  # Pull Request 补丁文件
  https://gh-proxy.org/https://github.com/facebook/react/pull/26000.patch
  

• 使用场景：代码审查（Code Review）、自动化补丁应用，例如直接管道执行：

  curl -fsSL https://gh-proxy.org/https://github.com/torvalds/linux/commit/ffc253263a1375a65fa6c9f62a893e9767fbebfa.patch | git apply
  

6.2 提交记录 Atom 订阅源（Atom Feeds）

• 链接说明：仓库指定分支或特定文件的提交更新 XML 订阅源。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/commits/{branch}.atom
  • https://github.com/{owner}/{repo}/commits/{branch}/{filepath}.atom
  • https://github.com/{owner}/{repo}/commits.atom
• 完整加速示例：

  https://gh-proxy.org/https://github.com/vernesong/OpenClash/commits/core/master/core_version.atom
  https://gh-proxy.org/https://github.com/vernesong/OpenClash/commits/package/master/version.atom
  

• 使用场景：路由器固件、自动化比对脚本监听版本变动与更新规则。
• 加速特性：特意对 .atom 扩展名与 XML 内容类型放行，避免被防火墙拦截。

6.3 Release / Tag 版本发布订阅源

• 链接说明：项目版本发布的 Atom/RSS 订阅源。
• URL 匹配模板：
  • https://github.com/{owner}/{repo}/releases.atom
  • https://github.com/{owner}/{repo}/tags.atom
• 使用场景：RSS 阅读器订阅开源项目的发版动态。

---

7. Gist 代码片段 (Gist Raw)

• 链接说明：GitHub Gist 的 Raw 纯文本文件访问。
• URL 匹配模板：
  • https://gist.githubusercontent.com/{user}/{gist_id}/raw/{filename}
  • https://gist.github.com/{user}/{gist_id}/raw/{filename}
• 完整加速示例：

  https://gh-proxy.org/https://gist.githubusercontent.com/octocat/1169852/raw/test.cs
  

• 加速特性：自动将 gist.github.com 规范化为 gist.githubusercontent.com，省去重定向跳转开销。

---

8. GitHub 官方短链接 (gh.io)

• 链接说明：GitHub 官方服务或活动使用的短域名。
• URL 匹配模板：
  • https://gh.io/{slug}
  • http://gh.io/{slug}
• 完整加速示例：

  https://gh-proxy.org/https://gh.io/copilot-install
  

• 使用场景：官方命令行一键安装指引，例如：

  curl -fsSL https://gh-proxy.org/https://gh.io/copilot-install | bash
  

• 加速特性：在加速节点内部自动跟随跳转并直接反代落地资源，避免客户端经历跨国多次握手重定向。

---

9. GitHub 官方 REST API 接口

• 链接说明：GitHub 开放数据 REST API 接口。
• URL 匹配模板：
  • https://api.github.com/{endpoint}
• 完整加速示例：

  # 获取仓库最新 Release 元数据
  https://gh-proxy.org/https://api.github.com/repos/cli/cli/releases/latest
  
  # 获取仓库标签列表
  https://gh-proxy.org/https://api.github.com/repos/torvalds/linux/tags
  

• 使用场景：编写自动化脚本查询仓库元信息、检测版本更新、获取 Assets 下载链接等。
• 加速特性：
  • Token 轮询池：内部集成多个 GitHub PAT Token 轮换请求，彻底解决未认证 IP 仅 60 次/小时 的限流问题；
  • 请求头透传：若客户端自带 Authorization 请求头，则优先使用客户端自带 Token。

---

10. 静态展示与客户端资产

• 用户/组织头像 (Avatars)：
  • 模板：https://avatars.githubusercontent.com/u/{user_id}
  • 示例：https://gh-proxy.org/https://avatars.githubusercontent.com/u/9919?v=4
• 项目 OpenGraph 封面图与静态 Assets：
  • 模板：https://opengraph.githubassets.com/{token}/{owner}/{repo}
  • 模板：https://github.githubassets.com/assets/...
• GitHub Desktop 官方客户端安装包：
  • 模板：https://desktop.githubusercontent.com/...
  • 示例：https://gh-proxy.org/https://desktop.githubusercontent.com/releases/3.6.2-beta1-f62b1c7a/GitHubDesktop-x64.zip

---

命令行集成指南

Wget 快速下载

wget -c "https://gh-proxy.org/https://github.com/WJQSERVER-STUDIO/ghproxy/releases/download/4.3.4/ghproxy-linux-amd64.tar.gz"

cURL 极速下载与管道执行

# 下载并保存为本地文件
curl -L -C - -O "https://gh-proxy.org/https://github.com/WJQSERVER-STUDIO/ghproxy/releases/download/4.3.4/ghproxy-linux-amd64.tar.gz"

# 远程安装脚本管道执行（例如 Homebrew / Rustup / Copilot 安装）
curl -fsSL "https://gh-proxy.org/https://raw.githubusercontent.com/homebrew/install/HEAD/install.sh" | bash

Git 全局自动替换 (insteadOf)

通过配置 Git 的 insteadOf 机制，可以在本地无缝加速所有 GitHub 仓库拉取，无需每次手动拼接：

# 开启全局加速
git config --global url."https://gh-proxy.org/https://github.com/".insteadOf "https://github.com/"

# 此时直接执行原生 git clone 即可自动享受加速
git clone https://github.com/torvalds/linux.git

# 取消加速配置
git config --global --unset url."https://gh-proxy.org/https://github.com/".insteadOf

---

核心功能特点

• 全生态资源覆盖：全面覆盖 Release 产物、Raw 代码、源码归档、Actions 产物、Git Clone、Patch/Diff、Atom Feeds、Gist、gh.io 短链及 REST API。
• Actions 产物免登录提取：独创 API + Token 轮询技术，无需登录 GitHub 账号即可高速直连下载 CI/CD 构建产物。
• 仓库主页与 Releases 智能解析：输入仓库主页即可自动列出所有版本，并提供多线路直链下载与更新日志展开。
• 全球 Anycast CDN 边缘缓存：热点 Release 与 Raw 资源自动在边缘缓存，大幅缩减首次拉取延迟。
• 海量大文件无缝传输：无文件大小人为限制，支持 HTTP Range 分块传输与断点续传。
• 端到端安全传输：基于 TLS/HTTPS 协议加密，不解密或留存用户私密凭证。
• 智能故障转移：全球多节点互为备用，任一加速节点异常时自动调度故障转移。

---

注意事项

1. 合规使用：本服务仅供学习、科研及正常开源软件下载使用，严禁用于滥用或恶意爬虫。
2. 公开资源：本代理专门用于 GitHub 公开资源的加速下载；出于安全与合规考虑，私有仓库拉取需要配置专属凭据。
3. 协议识别：转换工具会自动识别并处理 https:// 协议前缀，请确保输入的链接格式合法完整。
4. 建议收藏：建议将 https://gh-proxy.org 加入浏览器书签，以便日常开发与服务器部署时随时调用。