Skip to content
This repository was archived by the owner on Jun 7, 2024. It is now read-only.

guide.md

Latest commit

 

History

History
81 lines (54 loc) · 3.33 KB

guide.md

File metadata and controls

81 lines (54 loc) · 3.33 KB

使用指南

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

::: danger 由于不可抗逆的因素，我们已经将我们的枢纽链接从 hub.fastgit.org 更新到 hub.fgit.cf。 :::

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

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

使用 FastGit 时，可使用如下命令：

git clone https://hub.fgit.cf/author/repo

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

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

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

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

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

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

Web 的使用

对于常见的 GitHub Web 操作， FastGit 的基础节点也提供了最基本的支持。您可以直接访问包含有 Web 支持的节点。目前我们已经支持登录操作（因未对 api.github.com 进行代理，USB Key 2FA 等部分功能不可用）。Github 对一些功能（例如搜索）有速率限制，如果遇到 429 错误，可以尝试登录后继续使用。

Release 和源码存档的下载

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

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

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

SSH 操作

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

对于 raw 的代理

我们同样对 https://raw.githubusercontent.com/ 进行了代理，地址为 https://raw.fgit.cf/。

:::warning 注意 由于某些仓库的用量较大，我们对 raw 启用了有效期为 5 分钟的缓存。 :::

当遇到 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 与我们取得联系。

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