git - GitHub.com 的存储库大小限制

Question

最近我一直在使用 GitHub，我想知道 github.com 上托管的文件的存储库大小限制是多少？

Answer 1

已知限制

有多个适用的存储库大小限制。

软限制

截至 2022 年，根据 docs，这是 5 GB。如果超过此限制，您可能会收到来自 GitHub 支持的电子邮件。

We recommend repositories remain small, ideally less than 1 GB, and less than 5 GB is strongly recommended.

如果您碰巧从 GitHub 支持部门收到一封针对一个或多个公共(public)存储库的限制电子邮件，请将其报告为对此答案的评论以及存储库的链接，包括相关情况。

git push 警告限制

截至 2020 年，下面摘录的 archived docs ( backup ) 陈述如下。可以合理地假设这仍然适用。这个限制显然可以忽略不计。

If you reach 75GB, you'll receive a warning from Git in your terminal the next time you push a change.

此外，对于每个超过 50MB 但低于硬限制的文件，您都会在终端中收到警告。

硬限制

截至 2022 年，虽然 docs 没有说明每个存储库的硬限制，但可以合理地假设之前记录的每个存储库 100 GB 的硬限制 仍然适用，至少在任何理论上如此收到来自 GitHub 支持的电子邮件。同样摘录在下方的文档仅说明每个文件 100 MB 的硬限制。

Individual files in a repository are strictly limited to a 100 MBmaximum size limit.

截至 2020 年，下面摘录的 archived docs 声明每个存储库的硬限制为 100 GB。同样，可以合理地假设此硬性限制仍然适用。

Repositories have a hard size limit of 100GB.

截至 2018 年，documented (archive link) 推送大小限制为 2 GB，尽管相关的 considerations 也适用于大型推送。

we don’t allow pushes over 2GB

文件也可以在发布中作为二进制文件共享。截至 2020 年，每个此类文件的 documented 大小限制为 2 GB。

We don't limit the total size of the binary files in the release or the bandwidth used to deliver them. However, each individual file must be smaller than 2 GB.

搜索注意事项

如果想要使用 GitHub 搜索 API，请注意所有适用的附加 considerations。

检查使用的尺寸

https://github.com/settings/repositories 中显示了您直接拥有管理员访问权限(但不是通过团队访问)的每个存储库的大小。或者，git-sizer 工具可以在本地估计 repo 大小。

绕过文件大小限制

如果它适用于您的应用程序，则可以使用诸如 tar 之类的工具将 split a large file 分成 90 MB 的部分。

我建议不要使用 Git LFS，因为 GitHub 强加的免费计划中的 limits 很少。

文件数量

一个 repo 协议(protocol)中的最大文件数没有既定的限制。 post from 2015 注释在 GitHub 存储库中有 170 万个文件。请注意，拥有 100 万个文件会将每个文件的最大平均值限制为 100 KB(根据假定的 100 GB 硬限制)或 5 KB(根据 5 GB 的软限制)。

怎么写

为了能够使用 git 成功推送大量字节，您很可能首先必须将 configure http.postBuffer 设置为足够大的值，并有足够的可用系统内存。

除了使用 git 之外，另一种以编程方式写入更新不多的文件的方法是使用 v3 REST 或使用 v4 GraphQL 的 personal access token API。这样做时，请确保不超过用户特定的每小时速率限制。与 git 不同，此 API 似乎不允许提交增量或差异。

加密

使用 git 时可以加密 the entire repo 或仅 some files 的内容，但有几个注意事项。

比较

对于 Bitbucket，考虑 this answer 。如果可行，我会亲自 push to both GitHub 和 Bitbucket，提供隐式备份。

截至 2022 年，GitLab(而非 GitHub)似乎将其免费配额从每个存储库 10 GB 降低到所有存储库的总和 5 GB!您可以看到 GitLab account 中使用的总空间。