先给结论

登录令牌、镜像清单和镜像层是三个不同阶段;429 往往与请求限额有关。

按顺序排查

  1. 先打开官方状态或公告入口 https://www.dockerstatus.com/,确认是否有服务故障;帮助页不一定提供实时运行状态。
  2. 在相同出口下复现 Docker Hub 问题,记录发生时间、错误码、请求阶段与持续时间。
  3. 拉取一个体积很小的公开镜像,记录报错发生在认证、manifest 还是 layer 下载。
  4. 分别测试有线 / Wi-Fi 或另一个网络;一次仅更换一个条件,排除本地无线网络拥塞。
  5. 如果客户端慢、浏览器正常,核对客户端代理和系统代理是否一致,避免重复代理。
  6. 登录令牌、镜像清单和镜像层是三个不同阶段;429 往往与请求限额有关。

官方参考

服务规则以官方页面为准。部分公告入口为帮助页面,不代表实时状态检测。

常见问题

切换网络能解决所有 Docker Hub 问题吗?

不能。网络出口只影响连接路径。账号资格、订阅、设备限制、文件权限及平台状态需要分别核对。

应该向支持人员提供哪些信息?

提供发生时间、客户端版本、已脱敏的错误码和最小复现步骤。不要提供密码、验证码、Cookie 或完整的私有请求内容。