让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像教程
教程简介
这里是多仓库镜像下载与配置教程的总览入口。每个仓库都有独立的配置文档页，便于搜索与收录；你可以按仓库类型直接进入对应页面查看示例命令与注意事项。
适用场景
适用于 ghcr、Quay、nvcr 等场景。
2仓库教程入口
选择你需要的仓库类型进入独立文档页（每个仓库页都有独立 SEO 标题、示例命令与注意事项）。
Docker Hub（docker.io）
Docker Hub（docker.io）最常用的官方镜像仓库拉取教程：给出 library/nginx 等官方命令、轩辕专属域名写法与 library/ 命名规则，适合新手与国内宽带环境快速验证加速效果。
查看教程 →
GHCR（ghcr.io）
GitHub Container Registry（ghcr.io）拉取教程：给出 org/image 官方命令与轩辕 GHCR 专属域名替换示例，适合 CI 构建、开源项目镜像在国内网络下的加速部署。
查看教程 →
GCR（gcr.io）
Google Container Registry（gcr.io）镜像拉取教程：对比官方 docker pull 与轩辕专属加速域名写法，说明 google-containers 等命名空间规则，适合 GKE 与云原生组件在国内环境稳定拉取。
查看教程 →
Quay（quay.io）
Red Hat Quay.io 镜像拉取教程：以 coreos/etcd 等为例对比 quay.io 官方源与轩辕 Quay 专属域名写法，适合 OpenShift 生态与企业私有仓库前置缓存场景。
查看教程 →
NVCR（nvcr.io）
NVIDIA NVCR（nvcr.io）镜像拉取教程：涵盖 PyTorch 等 AI 镜像的官方 pull 命令、轩辕 NVCR 专属域名替换方式，并说明 API Key 与企业授权等认证要求。
查看教程 →
K8s（registry.k8s.io）
Kubernetes 官方 registry.k8s.io 拉取教程：以 kube-apiserver 等组件为例，对比官方源与轩辕 K8s 专属域名命令，适合集群升级与离线节点镜像预热场景。
查看教程 →
MCR（mcr.microsoft.com）
Microsoft MCR（mcr.microsoft.com）镜像拉取教程：以 dotnet/runtime 等为例说明官方 pull 与轩辕 MCR 专属域名替换，适合 .NET 与 Azure 相关容器在国内 CI/CD 中加速拉取。
查看教程 →
Elastic（docker.elastic.co）
Elastic 官方 docker.elastic.co 拉取教程：以 Elasticsearch 等组件为例对比官方 registry 与轩辕 Elastic 专属域名写法，适合 ELK 栈在国内环境的镜像加速与版本固定部署。
查看教程 →
Oracle（container-registry.oracle.com）
Oracle Container Registry 拉取教程：说明 database/enterprise 等镜像的官方 pull 命令、轩辕 Oracle 专属域名替换方式，并提示官网授权登录等前置要求。
查看教程 →
GitLab（registry.gitlab.com）
GitLab Container Registry 拉取教程：以 gitlab-org/gitlab-runner 为例说明官方 pull 命令、轩辕 GitLab 专属域名替换方式，并提示仅支持 SaaS 公共镜像。
查看教程 →
3常见用法建议
以下是一些常见的使用场景和建议：
设置镜像源
配置 daemon.json 中的 "registry-mirrors" 为 https://***.xuanyuan.run用于 CI/CD 构建
在 Dockerfile 或 CI 脚本中修改镜像源前缀脚本预拉取
docker pull ***-ghcr.xuanyuan.run/org/image:tag替换已有镜像
docker tag ***-ghcr.xuanyuan.run/org/image image4避免的问题
使用镜像时需要注意以下问题：
- registry-mirrors 仅对 docker.io 生效：daemon.json 中的镜像加速配置不会自动代理 GHCR、Quay、GCR 等第三方仓库。 拉取
ghcr.io/...等官方地址时仍会直连官方源； 需在命令或 Dockerfile 中显式使用专属域名（如***-ghcr.xuanyuan.run/...）。 各仓库详情见对应子页「daemon.json 仍很慢？」章节。 - 不要用完整官方域名：避免使用
docker.io/等完整域名，优先使用专属域名。 - 各大仓库的私有镜像仍需登录： 轩辕镜像不改变权限控制，支持公开镜像，各大仓库的私有镜像仍需登录认证。
- 避免误用缓存过期镜像：建议定期更新镜像源或配置 webhook 拉取策略。
- 注意镜像标签一致性：确保专属域名和原始地址的镜像标签完全一致。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"