ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像教程
本教程将详细介绍如何使用轩辕镜像Dockerhub、ghcr、gcr、quay、nvcr、k8s、mcr、elastic、oracle等各大主流镜像仓库，提升镜像拉取速度和稳定性。
2Docker Hub（docker.io）
最常用的官方镜像仓库，包含大量开源项目的官方镜像。
官方源：
docker pull docker.io/library/nginx:latest
轩辕专属域名：
docker pull xxx.xuanyuan.run/library/nginx:latest
⚠️注意：部分镜像无需 library/ 也可用（取决于原始镜像名）
3GitHub Container Registry（ghcr.io）
GitHub 提供的容器镜像仓库，支持公开镜像。
官方源：
docker pull ghcr.io/org/image:tag
轩辕专属域名：
docker pull xxx-ghcr.xuanyuan.run/org/image:tag
4Google Container Registry（gcr.io）
Google 提供的容器镜像仓库，包含 Kubernetes 官方镜像等。
官方源：
docker pull gcr.io/google-containers/pause:3.9
轩辕专属域名：
docker pull xxx-gcr.xuanyuan.run/google-containers/pause:3.9
5Quay.io
Red Hat 提供的容器镜像仓库，包含大量开源项目镜像。
官方源：
docker pull quay.io/coreos/etcd:latest
轩辕专属域名：
docker pull xxx-quay.xuanyuan.run/coreos/etcd:latest
6NVIDIA Container Registry（nvcr.io）
NVIDIA 提供的容器镜像仓库，包含深度学习框架和 GPU 相关镜像。
官方源（需要登录认证）：
docker pull nvcr.io/nvidia/pytorch:23.05-py3
轩辕专属域名（需登录或使用内部授权）：
docker pull xxx-nvcr.xuanyuan.run/nvidia/pytorch:23.05-py3
⚠️私有镜像仍需登录，详见官网获取 API Key 或使用企业授权
7Kubernetes Registry（registry.k8s.io）
Kubernetes 官方镜像仓库，包含 K8s 组件和工具镜像。
官方源：
docker pull registry.k8s.io/kube-apiserver:v1.30.1
轩辕专属域名：
docker pull xxx-k8s.xuanyuan.run/kube-apiserver:v1.30.1
8Microsoft Container Registry（mcr.microsoft.io）
Microsoft 提供的容器镜像仓库，包含 .NET、Azure 等官方镜像。
官方源：
docker pull mcr.microsoft.com/dotnet/runtime:8.0
轩辕专属域名：
docker pull xxx-mcr.xuanyuan.run/dotnet/runtime:8.0
9Elastic Registry（docker.elastic.co）
Elastic 官方镜像仓库，包含 Elasticsearch、Kibana、Logstash 等镜像。
官方源：
docker pull docker.elastic.co/elasticsearch/elasticsearch:8.13.4
轩辕专属域名：
docker pull xxx-elastic.xuanyuan.run/elasticsearch/elasticsearch:8.13.4
10Oracle Container Registry（container-registry.oracle.com）
Oracle 官方镜像仓库，包含 Oracle 数据库、Java 等企业级镜像。
官方源：
docker pull container-registry.oracle.com/database/enterprise:21.3.0
轩辕专属域名：
docker pull xxx-oracle.xuanyuan.run/database/enterprise:21.3.0
⚠️Oracle 镜像需先登录授权，详见 Oracle 官网说明。
11常见用法建议
以下是一些常见的使用场景和建议：
设置镜像源
配置 daemon.json 中的 "registry-mirrors" 为 https://xxx.xuanyuan.run用于 CI/CD 构建
在 Dockerfile 或 CI 脚本中修改镜像源前缀脚本预拉取
docker pull xxx-ghcr.xuanyuan.run/org/image:tag替换已有镜像
docker tag xxx-ghcr.xuanyuan.run/org/image image12避免的问题
使用镜像时需要注意以下问题：
- 不要用完整官方域名：避免使用
docker.io/等完整域名，优先使用专属域名。 - 各大仓库的私有镜像仍需登录： 轩辕镜像不改变权限控制，支持公开镜像，各大仓库的私有镜像仍需登录认证。
- 避免误用缓存过期镜像：建议定期更新镜像源或配置 webhook 拉取策略。
- 注意镜像标签一致性：确保专属域名和原始地址的镜像标签完全一致。
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"