410 Gone 错误：Docker 版本过低导致协议不兼容

本文适用于：

• 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 1585xxxx -p xxxx 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 协议。

💡参考 docker 升级文档：https://xuanyuan.cloud/install/linux

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

你可能还会遇到：

本文由「xuanyuan.cloud」维护
专注国内 Docker / 镜像 / Registry 网络问题
内容基于真实用户环境与实测