GitHub - 长风

GitHub 是全球最大的开源代码托管平台和开发者社区（同性交友网站），使用 [[Git]] 作为版本控制，2018 年被微软收购。

使用

连接

查看 ~/.ssh 目录下是否有

1
# 创建，一路回车
2
ssh-keygen -t ed25519 -C "[email protected]"
3
# 拷贝 pub 文件内容到剪贴板
4
cat id_ed25519.pub | pbcopy

拷贝后到 GitHub -> Setting -> SSH and GPG keys 粘贴即可，其他问题可参考使用 SSH 连接到 GitHub。

技巧

在项目界面按. 键，在网页编辑器([[VSCode]])中打开浏览;
在项目地址前加 gitpod.io/#/，在线运行项目([[VSCode]])；

API

如果是私有仓库需要从：Settings -> personal access tokens -> Fine-grained tokens 创建 Token。

选择所需仓库，然后权限选择：

Contents
Metadata

获取仓库文件

仅获取指定目录：/repos/{owner}/{repo}/contents/{path}

1
curl -L \
2
  -H "Accept: application/vnd.github+json" \
3
  -H "Authorization: Bearer <YOUR-TOKEN>" \
4
  -H "X-GitHub-Api-Version: 2022-11-28" \
5
  https://api.github.com/repos/OWNER/REPO/contents/PATH

递归获取所有文件：/repos/{owner}/{repo}/git/trees/{tree_sha}

1
curl -L \
2
  -H "Accept: application/vnd.github+json" \
3
  -H "Authorization: Bearer <YOUR-TOKEN>" \
4
  -H "X-GitHub-Api-Version: 2022-11-28" \
5
  https://api.github.com/repos/OWNER/REPO/git/trees/master

可加路径参数：

recursive: 1 或 true 为递归获取

获取文件内容

通过 contents 接口获取：/repos/{owner}/{repo}/contents/{file}

1
curl -L \
2
  -H "Accept: application/vnd.github+json" \
3
  -H "Authorization: Bearer <YOUR-TOKEN>" \
4
  -H "X-GitHub-Api-Version: 2022-11-28" \
5
  https://api.github.com/repos/OWNER/REPO/contents/file

这个接口会返回文件元数据和内容（Base64 编码）

通过 raw 接口获取：`/{owner}/{repo}/{branch}/{path}

1
curl -L \
2
  -H "Accept: application/vnd.github+json" \
3
  -H "Authorization: Bearer <YOUR-TOKEN>" \
4
  -H "X-GitHub-Api-Version: 2022-11-28" \
5
  https://raw.githubusercontent.com/OWNER/REPO/master/file

这个接口直接返回原始内容，不需要再通过 Base64 解码。

通过 Blob 接口获取：/repos/{owner}/{repo}/git/blobs/{sha}

1
curl -L \
2
  -H "Accept: application/vnd.github+json" \
3
  -H "Authorization: Bearer <YOUR-TOKEN>" \
4
  -H "X-GitHub-Api-Version: 2022-11-28" \
5
  https://api.github.com/repos/OWNER/REPO/git/blobs/sha

需要文件的 sha，返回的内容同样包含元数据和通过 Base64 编码的内容。

问题

GnuTLS recv error (-110): The TLS connection was non-properly terminated

1
apt-get install gnutls-bin
2
git config --global http.sslVerify false
3
git config --global http.postBuffer 1048576000

在 [[Ubuntu]] 下成功解决。