作为开发者,GitHub 是我们获取开源项目、协作开发的重要平台。但在国内访问 GitHub 经常遇到速度慢、无法连接等问题。本文将介绍两种解决方案:使用 Watt Toolkit 加速 GitHub,以及使用 Gitee 作为替代方案。

常见问题概览

Q: 为什么 GitHub 在国内访问这么慢?
A: 由于网络环境原因,GitHub 的服务器在国外,访问时延迟较高,部分地区甚至无法正常连接。

Q: GitHub 都访问不了,怎么从 GitHub 下载加速工具?
A: 这就是"先有鸡还是先有蛋"的问题。解决方法:使用 Gitee 镜像下载,或者从官网下载。

Q: 还有其他方法吗?
A: 除了本文介绍的方法,还可以尝试修改 hosts 文件、使用镜像站等,但这些方法要么需要经常更新,要么功能受限。

方案一:使用 Watt Toolkit 加速 GitHub

什么是 Watt Toolkit?

Watt Toolkit(原 Steam++)是一款免费开源的网络加速工具,通过优化网络路由来提升访问速度。

核心优势:

  • ✅ 完全免费,无需注册
  • ✅ 开源项目,安全可靠(GitHub 20k+ Stars)
  • ✅ 支持 Windows、macOS、Linux
  • ✅ 一键操作,使用简单

快速安装使用

1. 下载软件

有三种下载方式(如果 GitHub 访问困难,推荐使用 Gitee):

方式一:官网下载

粘贴的图片

粘贴的图片

方式二:Gitee 下载(推荐)

方式三:GitHub 下载

根据你的系统选择对应版本:

  • Windows:选择 Steam++_win_x64_v*.exe
  • macOS:选择对应芯片的 .dmg 文件
  • Linux:选择 .deb.rpm

2. 安装注意事项

  • Windows:需要以管理员身份运行
  • macOS:首次运行需要在系统偏好设置中允许
  • Linux:可能需要安装额外依赖

3. 配置 GitHub 加速

  1. 启动 Watt Toolkit
  2. 在左侧菜单选择"网络加速"
  3. 勾选以下 GitHub 相关选项:
    • GitHub
    • GitHub Avatars
    • GitHub Content
    • GitHub Raw
    • GitHub Download(可选)
  4. 点击"一键加速"按钮
  5. 首次使用需要安装证书(用于 HTTPS 加速)

4. 验证效果

配置完成后,尝试:

  • 访问 https://github.com 查看网页加载速度
  • 执行 git clone 测试下载速度
  • 查看 README 中的图片是否正常显示

正常情况下,速度应该有显著提升(10-100倍)。

常见问题解决

问题1:加速后仍无法访问

  • 确保以管理员身份运行
  • 检查防火墙是否拦截
  • 尝试重启加速服务

问题2:证书安装失败

  • 进入设置 → 证书管理
  • 删除旧证书并重新生成
  • 手动安装到受信任的根证书颁发机构

问题3:Git Clone 仍然很慢
配置 Git 代理:

git config --global http.proxy http://127.0.0.1:11451
git config --global https.proxy http://127.0.0.1:11451

方案二:使用 Gitee 作为 GitHub 替代

什么是 Gitee?

Gitee(码云)是国内的代码托管平台,功能类似 GitHub,访问速度快且稳定。

Gitee 优势:

  • 🚀 国内访问速度快
  • 🆓 私有仓库免费(5人以下)
  • 🌏 中文界面,本地化好
  • 🔄 支持从 GitHub 导入项目

Gitee 使用指南

1. 注册账号

访问 https://gitee.com 注册账号,支持手机号、邮箱注册。

2. 从 GitHub 导入项目

Gitee 提供了便捷的导入功能:

  1. 登录 Gitee,点击右上角"+"号
  2. 选择"从 GitHub 导入仓库"
  3. 授权 GitHub 账号
  4. 选择要导入的仓库
  5. 设置仓库名称和访问权限

3. 同步更新

对于需要保持同步的项目:

  • 使用 Gitee 的"强制同步"功能
  • 或设置 GitHub Actions 自动同步

4. 日常使用

将 Git 远程地址改为 Gitee:

# 查看当前远程地址
git remote -v

# 添加 Gitee 远程地址
git remote add gitee https://gitee.com/用户名/仓库名.git

# 推送到 Gitee
git push gitee main

GitHub 与 Gitee 对比

特性 GitHub Gitee
访问速度 国内较慢 国内快速
开源生态 全球最大 国内领先
私有仓库 免费 5人以下免费
CI/CD Actions Gitee Go
界面语言 英文为主 中文
用户群体 全球开发者 国内为主

最佳实践建议

1. 双平台策略

  • 主要项目在 GitHub 维护(国际化)
  • 在 Gitee 创建镜像(国内访问)
  • 使用自动同步保持一致

2. 选择建议

使用 GitHub + Watt Toolkit 如果你:

  • 需要参与国际开源项目
  • 依赖 GitHub 生态(Actions、Packages等)
  • 团队已经在使用 GitHub

使用 Gitee 如果你:

  • 主要面向国内用户
  • 需要稳定快速的访问
  • 团队规模较小(5人以下)

3. 混合使用示例

# 设置多个远程仓库
git remote add origin https://github.com/user/repo.git
git remote add gitee https://gitee.com/user/repo.git

# 同时推送到两个平台
git push origin main
git push gitee main

# 或创建别名简化操作
git config --global alias.pushall '!git push origin main && git push gitee main'

进阶技巧

1. 自动同步脚本

创建 GitHub Actions 自动同步到 Gitee:

.github/workflows/sync-to-gitee.yml:

name: Sync to Gitee
on: [push]
jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - uses: pixta-dev/repository-mirroring-action@v1
      with:
        target_repo_url: git@gitee.com:${{ secrets.GITEE_USERNAME }}/repo.git
        ssh_private_key: ${{ secrets.GITEE_PRIVATE_KEY }}

2. 加速 npm/pip 等包管理器

除了代码托管,开发中还需要加速包下载:

npm 使用淘宝镜像:

npm config set registry https://registry.npmmirror.com

pip 使用清华镜像:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

3. Docker 镜像加速

配置 Docker 使用国内镜像:

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

总结

解决 GitHub 访问问题主要有两种思路:

  1. 加速访问:使用 Watt Toolkit 等工具,保持使用 GitHub
  2. 替代方案:使用 Gitee 等国内平台

两种方案各有优劣,可以根据实际需求选择或组合使用。对于需要参与国际开源的开发者,建议使用 Watt Toolkit 加速 GitHub;对于国内项目,Gitee 是个不错的选择。

记住,工具只是辅助,重要的是保持学习和创造的热情!

相关资源