让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
拉取老镜像提示 Schema 1 已废弃怎么办？
本文适用于：
- • 拉取时出现
422 Unknown，且正文含 schema 1 / manifest v1 相关描述 - • 报错含
schema 1 support has been removed、manifest schema v1 unsupported等 - • 需要拉取较老的官方镜像，如
php:5.4.x、mysql:5.5.x等 - • 需与「manifest unknown」（镜像不存在）和「422 Unknown 泛化报错」区分
先搞清一点：这是 Docker 生态对旧清单格式的整体限制
镜像发布于 2017 年前后、使用已废弃的 Manifest Schema 1 时，现代 Docker 客户端与 Docker Hub 均不再支持拉取。 这不是轩辕镜像加速服务单独造成的限制，换任何镜像源或直连 Docker Hub 通常同样无法拉取。
典型报错示例
不同 Docker 版本措辞略有差异，但核心信息一致：Schema 1 清单已不再被支持。
常见场景
- 拉取很老的官方镜像标签，例如
php:5.4.x、mysql:5.5.x、早期node:0.x等 - 镜像最后一次推送在 Docker 全面转向 Schema 2 / OCI 之前，清单仍为 Schema 1 格式
- 业务脚本或 compose 文件仍固定引用多年前停更的版本号
处理建议（按优先级）
1）优先升级到较新的镜像版本（推荐）
在业务允许的前提下，改用仍维护、使用现代清单格式的标签，例如 php:7.4-fpm、php:8.2-fpm、mysql:8.0 等。 到 Docker Hub 确认该镜像当前可用标签。
2）业务必须用老版本时：自行导入并推到私有仓库
若你仍持有该镜像的 tar 包或能从可信渠道获得，可用 docker load 导入后推到 Harbor 等私有仓库； 也可在仍能访问旧格式的环境中用 skopeo copy 等工具迁移。 更多离线思路见 docker save / load 离线迁移。
注意：轩辕镜像不支持 docker push，无法直接把本地镜像上传到加速域名，需使用自有 Registry。
3）此类问题无法通过「换镜像源」解决
升级轩辕镜像套餐、更换加速域名或调整 registry-mirrors 均不能恢复对 Schema 1 的支持。 根本原因是客户端与上游仓库已不再接受该格式。
延伸阅读：Docker 官方对废弃镜像格式的说明见 Deprecated image formats。若报错为泛化的 422 Unknown 且不含 schema 1 字样，请参考 422 Unknown 上游异常排查。
你可能还会遇到：
本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理