文档目录导航（当前：GitHub 加速下载代理使用指南）
入门指南
快速上手总览
核心服务
GitHub 加速下载代理使用指南 Docker 镜像加速配置全指南 SourceForge 加速下载代理使用指南 OpenSheet - Google 表格转 JSON 接口文档
客户端配置
Git 客户端全局配置

GitHub 加速下载代理使用指南

GitHub Proxy 是一个专为开发者打造的高性能 GitHub 资源加速代理服务。它通过全球分布式 CDN 节点与智能线路调度，解决国内及跨国网络中访问 GitHub 频繁出现的连接超时、克隆龟速、大文件下载中断等痛点。

快速使用姿势

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

https://gh-proxy.org/https://github.com/用户名/仓库名/releases/download/v1.0.0/file.zip

支持的资源格式规范与完整示例

本服务全面支持以下各种 GitHub 资源类型，点击或复制即可直接使用：

1. 分支源码归档 (Archive)

支持以 Zip 或 Tar.gz 格式打包下载指定分支的最新代码：

# 示例：main 分支源码 Zip 包
https://gh-proxy.org/https://github.com/WJQSERVER-STUDIO/ghproxy/archive/refs/heads/main.zip

2. Raw 原始文件

支持网页端查看路径 (/blob/) 以及 raw 协议路径 (raw.githubusercontent.com)：

# 网页 blob 路径（自动转为 raw 下载）
https://gh-proxy.org/https://github.com/WJQSERVER-STUDIO/ghproxy/blob/main/config/config.toml

# 原始 raw 域名链接
https://gh-proxy.org/https://raw.githubusercontent.com/WJQSERVER-STUDIO/ghproxy/refs/heads/main/config/config.toml

3. Release 源码包 (Tags)

下载指定 Release Tag 对应的源码快照：

# 示例：4.3.4 版本源码
https://gh-proxy.org/https://github.com/WJQSERVER-STUDIO/ghproxy/archive/refs/tags/4.3.4.zip

4. Release 二进制发行文件 (Assets)

支持各大开源项目的二进制安装包、可执行文件与校验文件的极速下载：

# 示例：Linux 二进制安装包
https://gh-proxy.org/https://github.com/WJQSERVER-STUDIO/ghproxy/releases/download/4.3.4/ghproxy-linux-amd64.tar.gz

5. Gist 代码片段 (Gist Raw)

直接拉取公开 Gist 代码片段的原文本文件：

# 示例：Gist 原始文本
https://gh-proxy.org/https://gist.githubusercontent.com/oopsunix/2dbf20f64984773da6740d1d1cf7c2d4/raw/github-blacklist

6. GitHub REST API 接口

加速访问 GitHub 公共 API 接口，避免 API 限流与网络卡顿：

# 示例：仓库元信息 API
https://gh-proxy.org/https://api.github.com/repos/umami-software/umami

7. GitHub 用户头像 (Avatars)

加速加载 GitHub 用户与组织的头像静态资源：

# 示例：用户头像
https://gh-proxy.org/https://avatars.githubusercontent.com/u/10000?v=4

8. GitHub Desktop 客户端与安装包 (Desktop)

下载官方 GitHub Desktop 客户端安装文件：

# 示例：GitHub Desktop x64 安装包
https://gh-proxy.org/https://desktop.githubusercontent.com/releases/3.6.2-beta1-f62b1c7a/GitHubDesktop-x64.zip

9. Git 仓库克隆 (Git Clone)

在终端中极速克隆完整的 Git 版本库：

# 示例：克隆 ghproxy 仓库
git clone https://gh-proxy.org/https://github.com/WJQSERVER-STUDIO/ghproxy.git

支持加速拉取 GitHub Actions 生成的 nightly 构建包：

# 访问 nightly.link 查看自动化发布产物
https://nightly.link/

命令行集成指南

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 安装）
curl -fsSL "https://gh-proxy.org/https://raw.githubusercontent.com/homebrew/install/HEAD/install.sh" | bash

Git 全局自动替换 (无需手动拼接)

通过配置 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

核心功能特点

  • 全生态资源覆盖：全面支持 GitHub 的 Releases 附件、Raw 源码、Archive 压缩包、Git Clone、Gist 以及 API。
  • 全球 Anycast CDN 边缘缓存：热点 Release 文件与 Raw 脚本自动在边缘缓存，大幅缩减首次拉取延迟。
  • 海量大文件无缝传输：无文件大小人为限制，支持分块传输与断点续传。
  • 免配置与零学习成本：无需安装任何客户端软件或复杂代理工具，一行前缀即开即用。
  • 端到端安全传输：全面基于 TLS/HTTPS 协议加密，不解密或留存用户私密凭证。
  • 多区域智能故障转移：全球多节点互为备用，任一子加速节点不可用后预计会在 15 分钟内自动故障转移重定向至主站。

注意事项

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

💬 互动交流与反馈