让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

威联通 NAS Docker 镜像源配置教程

教程简介

在威联通NAS中配置Container Station使用轩辕镜像服务，享受高速稳定的镜像拉取体验

适用场景

适用于 QNAP 配置 等场景。

1威联通 NAS Container Station 镜像仓库配置

威联通 NAS 用户可以通过 Container Station 配置自定义镜像仓库来使用镜像服务。 请按照下方步骤进行操作，配置完成后即可享受高速的镜像拉取服务。

配置前请确保您已登录网站，并在左侧菜单栏的「专属域名」菜单中获取了专属域名镜像仓库地址。 威联通NAS推荐使用专属域名方式，更加简单便捷。

2第一步：配置自定义存储库

在 Container Station 中添加自定义镜像存储库

  1. 打开威联通 QTS 控制面板
  2. 进入"App Center"，安装 Container Station（如果尚未安装）
  3. 打开 Container Station，点击左侧的"存储库"
  4. 找到"自定义存储库"区域，点击"添加"按钮
  5. 在弹出的配置窗口中：
    • 提供商：选择"其他"
    • 名称：填写"轩辕镜像"（或您喜欢的名称）
    • URL：填写您的专属域名镜像仓库地址，如：
      • ***.xuanyuan.run - 轩辕镜像地址
  6. 点击"测试连接"验证配置是否正确
  7. 测试成功后，点击"应用"保存配置

点击图片可查看大图

✅配置成功提示：如果测试连接成功，说明自定义存储库配置正确。 之后您就可以通过轩辕镜像存储库快速拉取各种 Docker 镜像了。

3第二步：测试镜像拉取

验证自定义存储库配置是否正常工作

  1. 在 Container Station 中，点击左侧的"映像"
  2. 点击右上角的"提取"按钮
  3. 在提取映像窗口中：
    • 模式：选择"基本模式"
    • 存储库：从下拉菜单中选择"轩辕镜像"
    • 映像：填写要拉取的镜像名称，如 nginx
  4. 勾选"将存储库设置为默认设置"（可选，方便后续使用）
  5. 点击"提取"开始下载镜像

点击图片可查看大图

4日常使用说明

配置完成后的日常使用方法

后续拉取镜像：

  1. 进入 Container Station → 映像 → 提取
  2. 存储库选择"轩辕镜像"
  3. 输入要拉取的镜像名称
  4. 点击提取即可享受服务

💡小贴士：建议勾选"将存储库设置为默认设置"， 这样后续拉取镜像时会自动使用轩辕镜像服务，无需每次手动选择。 配置完成后，威联通 NAS 会自动使用轩辕镜像服务拉取镜像， 大大提升下载速度和稳定性。

服务说明：
• 轩辕镜像地址：适合国内大陆用户，访问速度更快

5流量耗尽错误提示

当您的流量用尽时，拉取镜像会显示以下错误，请及时充值：

docker pull docker.xuanyuan.run/redis Using default tag: latest Error response from daemon: unknown: {"errors":[{"code":"PAYMENT_REQUIRED","message":"capacity has use up","detail":[{"Type":"repository","Name":"library/*","Action":"pull"}]}]}

💡当您登录或拉取镜像时返回 402 Payment Required 错误，表示您的流量已耗尽。请立即充值流量包以继续使用镜像服务。

❓

常见问题解答

🐳

Q: 为什么配置后显示"存储库提供商不匹配"？

问题现象：

在威联通 Container Station 中配置自定义存储库后，拉取镜像时出现"存储库提供商不匹配"错误，导致无法正常使用镜像服务。

解决方案：

  1. 检查 DNS 配置
    将威联通 NAS 的 DNS 服务器地址修改为：114.114.114.114 和 223.5.5.5
  2. 确认专属域名流量状态
    检查您的专属域名是否有可用流量。如果地址没有充值流量，Docker 客户端请求时会返回 402 Payment Required 错误，威联通系统会认为该代理地址不可用，因而显示 "存储库提供商不匹配" 的错误。

    解决方案： 请前往充值页面充值流量包，确保您的专属域名有足够的流量支持镜像拉取服务。
  3. 检查威联通防火墙设置
    可能是威联通 NAS 防火墙拦截导致的问题。请检查威联通防火墙软件是否开启。

    判断方法：SSH 登录威联通 NAS，执行以下命令：
    curl -v docker.xuanyuan.run

    如果显示 198.18.0.x 这种不是外网的假目标地址且连接不上，大概率可以判断是防火墙拦截。

    解决办法：关闭威联通防火墙软件。

  4. SSH 命令行验证
    如果上述方法无法解决，请通过 SSH 登录威联通 NAS，执行以下命令验证：
    docker pull ***.xuanyuan.run/mysql

    如果正常拉取，说明专属域名可用且有流量；如果无法拉取，请根据具体报错信息进行排查。

💡 提示： 如无法自行解决，请提交工单寻求技术支持。

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

专业版 · 高速稳定拉取镜像
50GB 仅 ¥7/年
高速镜像下载在线技术支持99.95% SLA 保障付费会员免广告