GitLab.com 的速率限制正在改变

# GitLab.com 速率限制即将调整 来源：https://about.gitlab.com/blog/rate-limit-change-2026/ GitLab.com 为各类型团队托管着数百万项目，为他们提供可信赖的协作平台。随着需求快速增长，我们预计今年平台负载将成倍提升。可预测的限制机制正是保障 GitLab.com 为所有用户（包括在平台上构建自动化与智能体工作负载的团队）保持高效运行的关键。 为确保扩展过程中的服务质量，我们将更新速率限制机制。自2026年10月19日起，GitLab.com 的速率限制将与您的订阅等级挂钩。免费账户和未认证请求将率先于10月19日调整，高级版和旗舰版用户将在2027年1月完成调整。 ## 主要变更内容 **限制与订阅等级对应** 免费版、高级版、旗舰版订阅计划将获得独立的限制额度，按用户和顶层组维度进行划分。免费版于10月19日生效；高级版和旗舰版于2027年1月生效。 **认证用户享有完整额度** 经过认证的请求将遵循下方订阅计划对应的限制。未携带任何凭证的请求，每小时每IP地址限制为60次请求。 各计划的具体限制详见[速率限制文档](https://docs.gitlab.com/user/gitlab_com/rate_limits/)。 ## 10月19日当天的变化 10月7日和10月14日15:00-19:00（UTC时间），我们将为免费版和未认证流量设置两个预览窗口期。高级版和旗舰版用户的认证请求不受影响，因为这些限制直到一月份才会变更。无论来源如何，未认证请求均会受限——包括针对付费账户运行且未携带凭证的自动化程序。预览窗口期（工程师称之为"服务降级演练"）是短暂的计划内时段，我们将启用新限制并随后关闭。在此期间服务其他功能保持不变。目的是让您在限制正式生效前数周，直观了解自身工作负载在新限制下的实际表现。 **10月19日**新限制正式生效。 我们通过分析GitLab.com实际使用情况来设定这些限制。几乎所有用户都已处于新限制范围内，不会感受到任何变化。我们参考了同类平台的限制标准：免费版限制和匿名访问额度符合行业常态，而高级版和旗舰版则更为宽松，其额度相当于其他平台企业版甚至未公开的配置水平。 ## 接近限制时的应对建议 若发现即将达到限制，请对请求进行认证。这通常只需简单调整：使用[个人访问令牌](https://docs.gitlab.com/api/rest/authentication/)、OAuth令牌或CI/CD作业令牌发起请求，即可从每小时60次的匿名额度切换到您订阅计划对应的更高额度。 其次，请检查API调用方式。批处理、缓存和分页能显著提升效率，紧密循环轮询则会快速耗尽配额。当您触达限制时，系统会返回`HTTP 429`状态码及`Retry-After`响应头，指示等待时长。支持读取响应头的客户端通常能自动恢复。采用指数退避策略比立即重试恢复更快。 升级到[高级版或旗舰版](https://about.gitlab.com/pricing/)也可按用户和顶层组维度提升限制额度。 若需长期使用更高额度，我们正在开发标准计划额度之外的购买方案，具体细节将于今年晚些时候公布。如需此类服务，请联系客户经理或发送邮件至`[email protected]`说明需求。 ## 变更范围说明 这些限制旨在防止单个工作负载影响其他用户的平台体验。常规的认证用户操作并非限制目标——对绝大多数用户而言，日常使用体验将保持不变：浏览界面、编辑器操作、Git推送/拉取以及计划内的CI/CD运行均与往常无异。部分高强度自动化程序和少量免费版工作负载可能会触及新上限。 以下内容保持不变： - 您始终可以访问和导出自己的数据与代码库。 - GitLab自托管版与GitLab Dedicated版的限制由运维方管控。本次仅影响GitLab.com。 - 后续调整将提前通知用户。 **再次提醒：**请确保对GitLab.com的请求进行认证，以获取更高额度。 ## 常见问题解答 **如何判断是否受影响？** 对比您最繁忙时段与[所购计划的限制额度](https://docs.gitlab.com/user/gitlab_com/rate_limits/#rate-limits-by-plan)。大多数用户远未达到上限。目前最直接的判断方式是查看API响应中的`RateLimit-Remaining`头信息，它会显示当前时间窗口剩余配额。我们正在开发产品内视图功能，将于今年晚些时候发布，用于展示您的使用量与计划额度的对比情况。 **我的项目公开且访问量大，有哪些应对措施？** 三种解决方案：1) 要求自动化程序进行认证，使其切换到认证用户额度而非匿名额度；2) 若流量非预期用户群体，可将项目设为私有以阻止匿名访问；3) [升级到高级版或旗舰版](https://about.gitlab.com/pricing/)获取更高额度。 **同时属于多个顶层组时如何处理？** 您的用户额度将自动采用您所属最高订阅等级。例如加入[旗舰版](https://about.gitlab.com/pricing/ultimate/)组织后，您将获得旗舰版额度。 **触发限制时会怎样？** 系统返回`429 Too Many Requests`状态码，并包含`RateLimit-*`响应头和`Retry-After`字段。请等待指定时间后重试。 **集成系统确实无法认证怎么办？** 请通过`[email protected]`联系我们。存在合理的匿名使用场景（如公开的状态徽章）。若您担心现有集成可能受影响，请及时沟通。 **GitLab自托管版或Dedicated版是否适用？** 不适用。本次调整仅限GitLab.com平台。 ## 相关资源 - [各计划速率限制](https://docs.gitlab.com/user/gitlab_com/rate_limits/#rate-limits-by-plan) - [API请求认证指南](https://docs.gitlab.com/api/rest/authentication/) - 疑问或遇到未涉及的情况？请联系客户经理或发送邮件至`[email protected]`