# 使用指南

请在同意我们服务条款和隐私协议后,再进行下一步。如若进行,我们将默认视为同意并遵守我们的服务条款和隐私协议。

关于 FastGit 的使用,本质上与 git 有关。常规的面向 GitHub 的 clone 命令可能如下:

git clone https://github.com/author/repo

使用 FastGit 时,可使用如下命令:

git clone https://hub.fastgit.org/author/repo

正如您所见, FastGit 仅仅是 GitHub 的代理,所以我们仅需要替换远程地址。

当然,您也可以直接修改 git 的配置,使用 FastGit 替换所有指向 GitHub 的链接:

git config --global url."https://hub.fastgit.org/".insteadOf "https://github.com/"
git config protocol.https.allow always

注意

当您排查网络错误时别忘了看看 FastGit 是否宕机了,尽管我们提供高达 0% 可用性的 SLA 保障。

注意

当开启 2FA 功能后, push 等需要您身份验证的操作会被拒绝。(无论您使用连接令牌与否)这是源于 GitHub 自身的规范。

我们并不反对对 git 配置的修改以方便您的工作。

随着 FastGit 的成长,我们会拥有更多资源用于加速,对于节点列表,请参阅 节点 章节。

# Web 的使用

对于常见的 GitHub Web 操作, FastGit 的基础节点也提供了最基本的支持。您可以直接访问包含有 Web 支持的节点。出于安全考虑,我们会禁用包括 Cookie 以及 Session 等敏感权限。这意味着您不能登录进行操作。

# Release 和源码存档的下载

对于正常的 clonepush 操作,FastGit 已经提供了相当完善的操作。对于 Release 和源码存档的下载,我们可以使用如下方法进行操作。

# Release
# 假设下载链接为 https://github.com/A/A/releases/download/1.0/1.0.tar.gz
wget https://download.fastgit.org/A/A/releases/download/1.0/1.0.tar.gz

# Codeload
# 假设下载链接为 https://hub.fastgit.org/A/A/archive/master.zip
# 或者 https://codeload.github.com/A/A/zip/master
wget https://download.fastgit.org/A/A/archive/master.zip

# SSH 操作

我们同样支持 SSH 克隆,您只需要把地址更换为 fastgit.org 即可。

由于不可抗逆因素,我们暂不支持 SSH 克隆。

26/06/2021 更新:由于 2FA 问题持续存在,所以我们很难以通过 HTTPS 的方法完成很多事。鉴于目前情况,我们继续开放了 SSH 操作入口。

与之前不同,我们拆分了 SSH 服务所在的域名,换句话说并不能通过替换地址为 FastGit.org 完成操作。

目前我们的 SSH 克隆地址为 ssh.fastgit.org。只需要修正地址即可完成加速。

# 对于 raw 的代理

我们同样对 https://raw.githubusercontent.com/ 进行了代理,地址为 https://raw.fastgit.org/

# 当遇到 FastGit 存在问题时的处理方法

  1. 请确认你的网络以及 DNS 工作正常
  2. 请查阅 https://status.fastgit.org 以及 https://github.com/FastGitORG/uptime 以确认 FastGit 是否正面临潜在的服务不可用可能性
  3. 更换阿里公共 DNS 避免潜在的 DNS 污染问题
  4. 通过 Tcpping 尝试与 FastGit IP 进行通信

当您确认 FastGit 正在或者即将面临不可用情景,请联系我们。 你可以通过发送邮箱至 admin@fastgit.org,前往我们的讨论区域 https://github.com/FastGitORG/discussion 发送 issue,或者通过 Telegram 即时通讯群组 @FastGit 与我们取得联系。

小贴士

需要注意一点,PING 并不能判断服务器是否不可用。我们推荐使用 Tcpping 检测 443 端口。

Copyright © FastGit 2021