如何用轩辕镜像拉取镜像？
本文适用于：
- • 初次使用轩辕镜像的用户
- • 需要了解如何拉取 Docker 镜像的用户
- • 需要选择合适配置方式的用户
- • 遇到镜像拉取问题的用户
✅ 简要说明
轩辕镜像提供两种方式拉取镜像：登录方式和专属域名方式。您可以根据使用场景选择合适的方式。对于 Linux 系统，我们还提供一键安装配置脚本，可自动安装 Docker 并配置镜像源。
1️⃣ 两种主要拉取方式
方式一：登录方式
需要先执行 docker login 登录，然后使用标准格式拉取镜像。
详细教程：登录方式配置教程
方式二：专属域名方式（推荐）
无需登录，直接使用专属域名拉取镜像，更加便捷高效。专业版用户可在个人中心获取专属域名。
详细教程：专属域名配置教程
2️⃣ Linux 系统一键安装配置（推荐）
对于 Linux 系统，我们提供一键安装配置脚本，支持 13 种主流发行版，可自动安装 Docker、Docker Compose 并配置轩辕镜像源。
✅ 一键安装命令
支持的操作系统：
- • 国产系统：openEuler、OpenCloudOS、Anolis OS、Alinux、Kylin Linux
- • CentOS 替代：Rocky Linux、AlmaLinux
- • 传统发行版：Ubuntu、Debian、CentOS、RHEL、Oracle Linux、Fedora
脚本会自动检测系统版本，选择最快的镜像源，并完成 Docker 和镜像源的配置。
3️⃣ 基本拉取命令格式
登录方式：
示例：docker pull docker.xuanyuan.run/mysql:latest
专属域名方式：
示例：docker pull xxx.xuanyuan.run/mysql:latest
（xxx.xuanyuan.run 请替换为您的专属域名）
4️⃣ Linux 系统配置镜像源（手动方式）
如果您不想使用一键脚本，也可以手动配置 Docker daemon 文件：
⚠️ 注意：xxx.xuanyuan.run 请替换为您的专属域名，可在个人中心获取。
配置完成后，您可以直接使用标准命令拉取镜像，无需指定域名前缀：
详细教程：Linux 系统配置教程
5️⃣ 常见问题
Q: 配置了 registry-mirrors 仍然访问官方仓库？
这是 Docker 的正常回退机制。当镜像源返回错误时，Docker 会自动回退到官方源。建议使用专属域名方式直接拉取，或确保镜像源有可用流量。
Q: 出现 manifest unknown 错误？
表示镜像仓库中不存在指定的镜像名或标签。请检查镜像名称和标签是否正确，或在本站搜索确认镜像是否存在。
6️⃣ 更多使用教程
根据不同设备和系统，我们提供了详细的配置教程：
- • 完整教程列表 - 查看所有设备和系统的配置教程
- • 登录方式配置 - 通过 Docker login 方式使用
- • 专属域名配置 - 无需登录的便捷方式
- • Linux 系统配置 - Linux 服务器配置指南
- • 群晖 NAS 配置 - 群晖 DSM 系统配置
- • Docker Desktop 配置 - Windows/Mac 桌面系统
💡 总结：
- ✅ 轩辕镜像提供两种拉取方式：登录方式和专属域名方式（推荐）
- ✅ Linux 系统可使用一键安装脚本，自动完成 Docker 安装和镜像源配置
- ✅ 配置完成后，可直接使用标准 Docker 命令拉取镜像
- ✅ 如遇问题，请参考对应的常见问题解答或详细教程
你可能还会遇到：
本文由「xuanyuan.cloud」维护
专注国内 Docker / 镜像 / Registry 网络问题
内容基于真实用户环境与实测