文档中心

镜像仓库

请输入

实例同步

Docker Hub 实例同步出现 TOOMANYREQUESTS 报错如何处理?

问题描述

通过 Docker Hub 将实例同步至镜像仓库 CR 时，可能出现 TOOMANYREQUESTS 的报错。详细报错信息如下：

http status code: 429, body: { "errors": [ { "code": "TOOMANYREQUESTS", "message": "You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit" } ] }

解决方案

Docker Hub 针对免费账号用户的镜像拉取限速导致了以上报错。解决的方法：

调整您的拉取方案。

推荐以下方式：

正则匹配采用精确写法，非模糊匹配，避免拉取无用的镜像。

间隔时长6小时以上，避免频繁拉取导致限速。

升级为 Docker Pro、Docker Team 账号。

解决方案的详细说明参见 https://www.docker.com/increase-rate-limit。

最近更新时间：2026.07.08 10:45:37

这个页面对您有帮助吗？

有用

无用