威联通 NAS Docker 镜像源配置教程
教程简介
在威联通NAS中配置Container Station使用轩辕镜像服务,享受高速稳定的镜像拉取体验
适用场景
适用于 QNAP 配置 等场景。
1威联通 NAS Container Station 镜像仓库配置
威联通 NAS 用户可以通过 Container Station 配置自定义镜像仓库来使用镜像服务。 请按照下方步骤进行操作,配置完成后即可享受高速的镜像拉取服务。
配置前请点击下方按钮获取专属域名镜像仓库地址。 威联通NAS推荐使用专属域名方式,更加简单便捷。
格式 ***.xuanyuan.run
2第一步:配置自定义存储库
在 Container Station 中添加自定义镜像存储库
- 打开威联通 QTS 控制面板
- 进入"App Center",安装 Container Station(如果尚未安装)
- 打开 Container Station,点击左侧的"存储库"
- 找到"自定义存储库"区域,点击"添加"按钮
- 在弹出的配置窗口中:
- 提供商:选择"其他"
- 名称:填写"轩辕镜像"(或您喜欢的名称)
- URL:填写您的专属域名镜像仓库地址,如:
•***.xuanyuan.run- 轩辕镜像地址
- 点击"测试连接"验证配置是否正确
- 测试成功后,点击"应用"保存配置

✅配置成功提示:如果测试连接成功,说明自定义存储库配置正确。 之后您就可以通过轩辕镜像存储库快速拉取各种 Docker 镜像了。
3第二步:测试镜像拉取
验证自定义存储库配置是否正常工作
- 在 Container Station 中,点击左侧的"映像"
- 点击右上角的"提取"按钮
- 在提取映像窗口中:
- 模式:选择"基本模式"
- 存储库:从下拉菜单中选择"轩辕镜像"
- 映像:填写要拉取的镜像名称,如
nginx
- 勾选"将存储库设置为默认设置"(可选,方便后续使用)
- 点击"提取"开始下载镜像

4日常使用说明
配置完成后的日常使用方法
后续拉取镜像:
- 进入 Container Station → 映像 → 提取
- 存储库选择"轩辕镜像"
- 输入要拉取的镜像名称
- 点击提取即可享受服务
💡小贴士:建议勾选"将存储库设置为默认设置", 这样后续拉取镜像时会自动使用轩辕镜像服务,无需每次手动选择。 配置完成后,威联通 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 中配置自定义存储库后,拉取镜像时出现"存储库提供商不匹配"错误,导致无法正常使用镜像服务。
解决方案:
- 检查 DNS 配置
将威联通 NAS 的 DNS 服务器地址修改为:114.114.114.114和223.5.5.5 - 确认专属域名流量状态
检查您的专属域名是否有可用流量。如果地址没有充值流量,Docker 客户端请求时会返回 402 Payment Required 错误,威联通系统会认为该代理地址不可用,因而显示 "存储库提供商不匹配" 的错误。
解决方案: 请前往充值页面充值流量包,确保您的专属域名有足够的流量支持镜像拉取服务。 - 检查威联通防火墙设置
可能是威联通 NAS 防火墙拦截导致的问题。请检查威联通防火墙软件是否开启。
判断方法:SSH 登录威联通 NAS,执行以下命令:curl -v docker.xuanyuan.run如果显示
198.18.0.x这种不是外网的假目标地址且连接不上,大概率可以判断是防火墙拦截。
解决办法:关闭威联通防火墙软件。 - SSH 命令行验证
如果上述方法无法解决,请通过 SSH 登录威联通 NAS,执行以下命令验证:docker pull ***.xuanyuan.run/mysql如果正常拉取,说明专属域名可用且有流量;如果无法拉取,请根据具体报错信息进行排查。
💡 提示: 如无法自行解决,请提交工单寻求技术支持。
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务