Docker Hub 故障排除

如果您遇到 Docker Hub 问题,请参考以下解决方案。

您已达到拉取速率限制(429 响应代码)

错误消息

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

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

可能原因

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

解决方案

您可以采用以下任一解决方案

请求过多(429 响应代码)

错误消息

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

Too Many Requests

可能原因

解决方案

  1. 检查访问 Docker Hub 的损坏的 CI/CD 流水线并修复它们。
  2. 在您的自动化脚本中实现带回退的重试方案,以确保您不会每分钟重发数千个请求。

500 响应代码

错误消息

出现此问题时,Docker CLI 或 Docker Engine 日志中常见的错误消息如下

Unexpected status code 500

可能原因

  • Docker Hub 服务存在临时问题。

解决方案

  1. 查看 Docker 系统状态页面 并验证所有服务是否正常运行。
  2. 再次尝试访问 Docker Hub。这可能是一个临时问题。
  3. 联系 Docker 支持 以报告此问题。
页面选项