让 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 镜像，要怎么登录和配置？

本文适用于：

• 初次使用轩辕镜像的用户
• 需要了解如何拉取 Docker 镜像的用户
• 需要选择合适配置方式的用户
• 遇到镜像拉取问题的用户

简要说明

轩辕镜像提供两种方式拉取镜像：登录方式和专属域名方式。您可以根据使用场景选择合适的方式。对于 Linux 系统，我们还提供一键安装配置脚本，可自动安装 Docker 并配置镜像源。

1. 两种主要拉取方式

方式一：登录方式

需要先执行 docker login 登录，然后使用标准格式拉取镜像。

# 1. 登录（镜像账户和密码在个人中心查看） echo "镜像密码" | docker login -u 镜像账户 --password-stdin docker.xuanyuan.run # 2. 拉取镜像 docker pull docker.xuanyuan.run/镜像名:标签

详细教程：登录方式配置教程

方式二：专属域名方式（推荐）

无需登录，直接使用专属域名拉取镜像，更加便捷高效。专业版用户可在个人中心获取专属域名。

# 直接拉取，无需登录 docker pull ***.xuanyuan.run/镜像名:标签

详细教程：专属域名配置教程 · 专属域名专题 FAQ

2. Linux 系统一键安装配置（推荐）

对于 Linux 系统，我们提供一键安装配置脚本，支持 13 种主流发行版，可自动安装 Docker、Docker Compose 并配置轩辕镜像源。

一键安装命令

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

支持的操作系统：

• 国产系统：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/镜像名:标签

示例：docker pull docker.xuanyuan.run/mysql:latest

专属域名方式：

docker pull ***.xuanyuan.run/镜像名:标签

示例：docker pull ***.xuanyuan.run/mysql:latest

（请将 ***.xuanyuan.run 替换为您的专属域名。登录网站后，点击左侧菜单栏的「专属域名」菜单即可获取）

4. Linux 系统配置镜像源（手动方式）

如果您不想使用一键脚本，也可以手动配置 Docker daemon 文件：

# 配置 daemon.json echo '{ "insecure-registries": ["***.xuanyuan.run"], "registry-mirrors": ["https://***.xuanyuan.run"] }' | sudo tee /etc/docker/daemon.json > /dev/null # 重新加载并重启 Docker systemctl daemon-reload systemctl restart docker

注意：请将 ***.xuanyuan.run 替换为您的专属域名。登录网站后，点击左侧菜单栏的「专属域名」菜单即可获取。

配置完成后，您可以直接使用标准命令拉取镜像，无需指定域名前缀：

docker pull mysql:latest

详细教程：Linux 系统配置教程