项目介绍
镜像下载失败时,需要区分 DNS、网络连接、仓库认证、标签不存在和拉取限流等原因。下面结合镜像访问方式,介绍按错误信息排查的方法;使用加速地址时也要确认镜像来源和版本。
镜像加速地址
https://docker.1ms.run
https://k-docker.asia
https://docker.1panel.live
https://dockerproxy.cn
https://docker.nastool.de
https://docker.agsv.top
https://docker.agsvpt.work
https://docker.m.daocloud.io
https://dockerhub.anzu.vip
https://docker.chenby.cn
https://docker.jijiai.cn
补充:部署与使用
配置与常见问题
- 镜像代理应来自可信维护者;自有仓库转存时记录上游来源与摘要。
- 修改全局镜像源前备份现有配置,避免影响已运行项目。
更新与备份
保存镜像来源、标签和摘要映射;仓库数据按重要程度设置保留策略。
按错误类型缩小范围
| 报错或现象 | 优先检查 |
|---|---|
manifest unknown |
完整仓库名和标签是否真的发布 |
no matching manifest |
镜像支持的平台与 NAS 架构 |
unauthorized / denied |
仓库可见性、登录和所需权限 |
too many requests |
注册表当前限流与账号额度 |
| 超时或 TLS 错误 | DNS、出口、代理、时间与证书链 |
先保留完整错误和镜像引用,再对相应一层做修改。多架构转存要区分单个平台镜像摘要与多架构索引摘要;本机默认拉取并重新推送通常不能证明保留了全部平台。
调整镜像加速或代理前保存原配置。镜像已存在并在运行时,不为排查一次拉取故障删除已有生产镜像。