手册

排查 Docker Hub 问题

Table of contents

如果您在使用 Docker Hub 时遇到问题，请参考以下解决方案。

已达到拉取速率限制（429 响应代码）

错误消息

当出现此问题时，您会在 Docker CLI 或 Docker Engine 日志中收到以下错误消息：

You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limits

可能的原因

您作为已认证的 Docker Personal 用户已达到拉取速率限制。
您作为未认证用户，基于 IPv4 地址或 IPv6 /64 子网已达到拉取速率限制。

解决方案

您可以使用以下任一解决方案：

进行身份验证或升级您的 Docker 账户。
查看您的拉取速率限制，等待拉取速率限制降低，然后重试。

请求过多（429 响应代码）

错误消息

当出现此问题时，您会在 Docker CLI 或 Docker Engine 日志中收到以下错误消息：

Too Many Requests

可能的原因

您已达到滥用速率限制。

解决方案

检查访问 Docker Hub 的 CI/CD 流水线是否存在问题并修复。
在自动化脚本中实施带退避机制的解决方案，确保每分钟不会重新发送数千个请求。

500 响应代码

错误消息

当出现此问题时，Docker CLI 或 Docker Engine 日志中通常会出现以下错误消息：

Unexpected status code 500

可能的原因

Docker Hub 服务暂时出现问题。

解决方案

查看 Docker 系统状态页面，确认所有服务是否正常运行。
重试访问 Docker Hub。这可能是暂时性问题。
联系 Docker 支持团队报告问题。