ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像教程
本教程将详细介绍如何使用轩辕镜像Dockerhub、ghcr、gcr、quay、nvcr、k8s、mcr、elastic、oracle等各大主流镜像仓库，提升镜像拉取速度和稳定性。
目录
1前置说明
本教程默认您的专属域名为 xxx.xuanyuan.run（请替换为您在个人中心获取的真实地址）
💡如果您还没有专属域名，请先前往 个人中心 获取您的专属域名。
2Docker Hub（docker.io）
最常用的官方镜像仓库，包含大量开源项目的官方镜像。
官方源：
轩辕专属域名：
⚠️注意：部分镜像无需 library/ 也可用（取决于原始镜像名）
3GitHub Container Registry（ghcr.io）
GitHub 提供的容器镜像仓库，支持公开镜像。
官方源：
轩辕专属域名：
4Google Container Registry（gcr.io）
Google 提供的容器镜像仓库，包含 Kubernetes 官方镜像等。
官方源：
轩辕专属域名：
5Quay.io
Red Hat 提供的容器镜像仓库，包含大量开源项目镜像。
官方源：
轩辕专属域名：
6NVIDIA Container Registry（nvcr.io）
NVIDIA 提供的容器镜像仓库，包含深度学习框架和 GPU 相关镜像。
官方源（需要登录认证）：
轩辕专属域名（需登录或使用内部授权）：
⚠️私有镜像仍需登录，详见官网获取 API Key 或使用企业授权
7Kubernetes Registry（registry.k8s.io）
Kubernetes 官方镜像仓库，包含 K8s 组件和工具镜像。
官方源：
轩辕专属域名：
8Microsoft Container Registry（mcr.microsoft.io）
Microsoft 提供的容器镜像仓库，包含 .NET、Azure 等官方镜像。
官方源：
轩辕专属域名：
9Elastic Registry（docker.elastic.co）
Elastic 官方镜像仓库，包含 Elasticsearch、Kibana、Logstash 等镜像。
官方源：
轩辕专属域名：
10Oracle Container Registry（container-registry.oracle.com）
Oracle 官方镜像仓库，包含 Oracle 数据库、Java 等企业级镜像。
官方源：
轩辕专属域名：
⚠️Oracle 镜像需先登录授权，详见 Oracle 官网说明。
11常见用法建议
以下是一些常见的使用场景和建议：
配置 daemon.json 中的 "registry-mirrors" 为 https://xxx.xuanyuan.run在 Dockerfile 或 CI 脚本中修改镜像源前缀docker pull xxx-ghcr.xuanyuan.run/org/image:tagdocker tag xxx-ghcr.xuanyuan.run/org/image image12避免的问题
使用镜像时需要注意以下问题：
- 不要用完整官方域名：避免使用
docker.io/等完整域名，优先使用专属域名。 - 各大仓库的私有镜像仍需登录： 轩辕镜像不改变权限控制，支持公开镜像，各大仓库的私有镜像仍需登录认证。
- 避免误用缓存过期镜像：建议定期更新镜像源或配置 webhook 拉取策略。
- 注意镜像标签一致性：确保专属域名和原始地址的镜像标签完全一致。
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"