快速上手总览

GH-Proxy 致力于为开发者解决访问 GitHub 时因网络波动导致的克隆慢、Release 资产下载超时等痛点。本服务完全免配置,支持多种快捷使用姿势。

1. 最简用法:前缀代理

只需在任何合法的 GitHub 资源 URL 前,拼接 https://gh-proxy.org/ 即可直接发起高速下载:

# 原链接
https://github.com/torvalds/linux/archive/refs/tags/v6.8.tar.gz

# 拼接加速前缀后
https://gh-proxy.org/https://github.com/torvalds/linux/archive/refs/tags/v6.8.tar.gz

2. Git Clone 仓库克隆加速

在执行 git clone 时,将原本的 GitHub 域名替换或直接拼接前缀:

# 推荐方式
git clone https://gh-proxy.org/https://github.com/username/repository.git

# 或者使用全局替换配置(参见 Git 客户端配置文档)

3. Raw 文件与一键安装脚本

在各类 Linux 安装脚本(如 Docker、Rustup、Node 安装器)中,通常需要 curl 远程脚本:

# 原脚本
curl -fsSL https://raw.githubusercontent.com/homebrew/install/HEAD/install.sh | bash

# 加速执行
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/homebrew/install/HEAD/install.sh | bash

4. 支持的资源类型

  • GitHub Releases: 二进制安装包、Assets 文件(含 latest/download 动态解析)。
  • Git 仓库克隆与归档: git clone 智能协议加速、Zip / Tar.gz 分支与 Tag 源码归档。
  • Raw 与脚本文件: raw.githubusercontent.com、历史 raw.github.com、仓库内 raw 以及网页 blob 链接智能重写。
  • GitHub Actions 产物: Workflow Run 构建产物(免登录下载)、Check Suites 及 nightly.link 构件。
  • 补丁与动态订阅: Commit / PR 的 .patch 与 .diff 补丁,以及 commits / releases 的 .atom 动态订阅源。
  • 代码片段与短链: Gist 代码片段、gh.io 官方短链接。
  • 官方 API 与静态资源: REST API 接口(内置 Token 轮询池)、用户头像、OpenGraph 封面及 Desktop 客户端。

完整匹配规范与实际示例详见:GitHub 加速下载代理使用指南。

💬 互动交流与反馈