元数据
| id | docker-manifest-not-found | 收录 | 2026-08-31 |
|---|---|---|---|
| 问题域 | 编码代理与终端 | 主题分组 | 容器与 WSL |
| 适用工具 | docker · 外部工具 | ||
症状
```
# 标准形态（Docker Hub 直连）
Error response from daemon: manifest for some/image:latest not found: manifest unknown
# 本机实测形态（daocloud 镜像源，2026-08-31）
Error response from daemon: unknown: failed to resolve reference "docker.io/library/alpine:definitely-no-tag-xyz":
unexpected status from HEAD request to https://docker.m.daocloud.io/v2/library/alpine/manifests/definitely-no-tag-xyz?ns=docker.io: 403 Forbidden
```
特征：报错里带「仓库:标签」完整引用；`manifest ... not found` = registry 上没这组合；镜像站域名 + 403 = 加速器把上游 404 改写了。
原因
pull 第一步查 manifest API，404 → daemon 报 `manifest not found`。`latest` 只是默认标签不是保证；镜像被删/改名/私有化/拼错都表现为 not found。镜像加速器是代理层，会把上游 404 改写成自己的状态码（实测 403），识别特征 = 报错 URL 是镜像站域名。
解法
1. `docker manifest inspect` 确认远端存在性；
2. 拼错改拼写、无 latest 写版本号、私有仓库先 `docker login`、被删/迁移换地址；
3. 镜像站 403 变体 = 换镜像源或直连上游验证。
验证证据
- 本地实测（2026-08-31，WSL Ubuntu，docker 29.1.3，daemon.json 配置 1panel.live + daocloud 镜像源）：`docker pull alpine:definitely-no-tag-xyz` → 镜像站 403 Forbidden（上游 404 被改写）；`docker pull ubuntu:1.0_` → 同镜像站 403。标准形态 `manifest for ... not found: manifest unknown` 未在本机复现（镜像源遮挡），机制与文案以 Docker 官方文档/多源搜索核对为准，链路推理由 manifest API 语义给出。
- 实测复现日志（2026-08-31）
来源与证据
素材来源：官方文档机制核对 + 本站 实测（2026-08-31，Docker 域试点；本机镜像源遮挡未复现标准形态）
验证证据：Evidence details kept locally (2026-08-31)