让 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 pull 提示 remote trust data does not exist 怎么办?
本文适用于:
- • 报错含
remote trust data does not exist - •
docker login已成功(Login Succeeded),但docker pull失败 - • 本机可能开启了 Docker Content Trust(镜像签名验证)
一句话结论:出现该报错时,是客户端在做 Content Trust 校验,不是账号登录失败
本机 Docker 在拉取前要求校验镜像签名(trust data)。当客户端强制开启 Content Trust,而当前仓库没有可用签名数据时,就会报 remote trust data does not exist。部分新版 Docker 即便设置了 DOCKER_CONTENT_TRUST=1 也可能不再强制该校验;若你已经看到上述报错,先关闭 Content Trust 再重试即可。
典型报错示例
原因说明
- 客户端启用了 Docker Content Trust(DCT),常见标志是环境变量
DOCKER_CONTENT_TRUST=1 - 在仍强制 DCT 的 Docker CLI 上,拉取前会向 Notary 校验签名;没有 trust data 就会直接失败
- 新版 Docker 可能已弱化或忽略该校验:同一变量在新机器上可能拉成功,在旧机器上仍报该错——取决于客户端版本与是否真正强制 DCT
- 该报错与轩辕账号密码、login 是否成功无直接关系
处理建议
1)当前会话临时关闭 Content Trust
Windows cmd:set DOCKER_CONTENT_TRUST=0;PowerShell:$env:DOCKER_CONTENT_TRUST=0
2)本机自检(确认变量与客户端版本)
请用同一条命令前缀设置变量,避免 export 未生效造成误判。若 DOCKER_CONTENT_TRUST=1 仍能拉取成功,说明当前客户端已不再强制 DCT;只有仍弹出 remote trust data does not exist 的环境,才需要按第 1 步关闭。
3)需要时永久关闭
临时 export 只对当前 shell 有效。若新开终端又出现同样报错,请检查并修改:
~/.bashrc、~/.profile、/etc/environment- systemd 服务环境、CI / 编排平台中的环境变量
- 将
DOCKER_CONTENT_TRUST删除,或改为0
可复制客服回复
与相近错误的区分
- remote trust data does not exist:客户端在做 Content Trust 校验 → 按本文关闭后重试
- unauthorized:登录态缺失或 sudo / 普通用户认证不一致 → 按认证 FAQ 排查
- 连不上轩辕域名:网络 / DNS / 代理问题,与签名校验无关
你可能还会遇到:
- • docker pull 提示 no matching manifest 怎么办?
- • 镜像已拉取完成,却提示 invalid tar header 或 failed to register layer 怎么办?
- • 拉取老镜像提示 Schema 1 已废弃怎么办?
- • Docker pull 时 HTTPS / TLS 证书验证失败怎么办?
- • Docker pull 时 DNS 解析超时或连不上仓库怎么办?
- • docker 无法连接轩辕镜像域名怎么办?
- • docker login 提示 Cannot autolaunch D-Bus,还算登录成功吗?
- • docker pull 提示无法连接 docker.sock / daemon 未运行怎么办?
本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理