报错关键词速查
| 报错 | 原因 | 处置 |
|---|---|---|
| manifest unknown | tag/仓库不存在 | 核对镜像名与 tag |
| unauthorized | 未登录或凭据过期 | docker login 对应仓库 |
| i/o timeout | 网络或镜像源不通 | 配置 registry-mirror/代理 |
| x509 certificate | 自签证书不受信 | 信任证书或临时 insecure |
| no space left | 磁盘满 | 先清磁盘再拉 |
| no matching manifest | 架构不匹配 | 指定 --platform 或换镜像 |
验证步骤
验证步骤
docker pull registry.example.com/team/app:1.2.3
docker login registry.example.com
docker info | grep -A3 "Registry Mirrors"
docker pull --platform linux/arm64 nginx:1.27-alpine受限网络里拉取失败先测 registry 连通性：curl -v https://registry-1.docker.io/v2/ 看 TLS 与拦截位置。