让 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 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

Docker 拉取出现 410 Gone 怎么办？

本文适用于：

• Docker 1.x 或较低版本的 Docker 17.x/18.x
• 遇到 410 Gone 错误
• 需要升级 Docker 到 20+ 版本
• Registry V1 协议不兼容问题

⚠️ 重要提示

这不是镜像仓库的问题，而是您的 Docker 版本过低导致的协议不兼容。Docker 1.x 或较低版本的 Docker 17.x/18.x 仅支持 Registry V1 协议，而本站镜像仓库仅支持 Registry V2 协议。请将 Docker 升级至 20.x 或更高版本。

当您遇到 410 Gone 错误时，这通常是由于 Docker 版本过低导致的协议不兼容问题。

错误示例

[root@nats1 ~]# docker login -u 1585**** -p **** docker.xuanyuan.run Login Succeeded [root@nats1 ~]# docker pull docker.xuanyuan.run/structurizr/lite:latest Trying to pull repository docker.xuanyuan.run/structurizr/lite ... Pulling repository docker.xuanyuan.run/structurizr/lite Error: Status 410 trying to pull repository structurizr/lite: "<html>\r\n<head><title>410 Gone</title></head>\r\n<body>\r\n<center><h1>410 Gone</h1></center>\r\n<hr><center>openresty</center>\r\n</body>\r\n</html>\r\n"

问题原因

Docker 1.x 或较低版本的 Docker 17.x/18.x 默认仅支持 Registry V1 协议，而本站镜像仓库仅支持 Registry V2 协议。当客户端尝试使用不兼容的 V1 协议访问时，会返回 410 Gone 错误。

解决方案

请将 Docker 升级至 20.x 或更高版本，以支持 V2 协议。

💡参考Linux Docker 安装与升级教程

升级完成后，使用 docker info 检查版本，重新执行登录与拉取命令即可正常使用。

你可能还会遇到：

本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理