先给结论
登录令牌、镜像清单和镜像层是三个不同阶段;429 往往与请求限额有关。
按顺序排查
- 从 https://docs.docker.com/docker-hub/ 确认适用平台和官方客户端;不为未提供移动客户端的产品安装第三方替代包。
- 记录系统与 Docker Hub 版本,先保留原有配置,避免同时修改私人 DNS、VPN 和系统代理。
- 确认客户端在 Wi-Fi 与蜂窝环境下使用的网络设置;桌面应用还需核对终端或应用内代理。
- 拉取一个体积很小的公开镜像,记录报错发生在认证、manifest 还是 layer 下载。
- 使用最小样本测试一次,检查后台运行、通知和文件权限是否按需开启。
- 确认基本功能恢复后再启用其他扩展、分流规则和多设备同步,每次改动后复测。
官方参考
服务规则以官方页面为准。部分公告入口为帮助页面,不代表实时状态检测。
常见问题
切换网络能解决所有 Docker Hub 问题吗?
不能。网络出口只影响连接路径。账号资格、订阅、设备限制、文件权限及平台状态需要分别核对。
应该向支持人员提供哪些信息?
提供发生时间、客户端版本、已脱敏的错误码和最小复现步骤。不要提供密码、验证码、Cookie 或完整的私有请求内容。