5.4 KiB
威联通 NAS Docker 镜像源配置教程
在威联通NAS中配置Container Station使用轩辕镜像服务，享受高速稳定的镜像拉取体验
目录
Container Station 镜像配置
威联通 NAS 用户可以通过 Container Station 配置自定义镜像仓库来使用镜像服务。请按照下方步骤进行操作，配置完成后即可享受高速的镜像拉取服务。
💡 配置前请确保您已登录网站，并在左侧菜单栏的「专属域名」菜单中获取了专属域名镜像仓库地址。威联通NAS推荐使用专属域名方式，更加简单便捷。
配置自定义存储库
在 Container Station 中添加自定义镜像存储库
- 打开威联通 QTS 控制面板
- 进入"App Center"，安装 Container Station（如果尚未安装）
- 打开 Container Station，点击左侧的"存储库"
- 找到"自定义存储库"区域，点击"添加"按钮
- 在弹出的配置窗口中：
- 提供商：选择"其他"
- 名称：填写"轩辕镜像"（或您喜欢的名称）
- URL：填写您的专属域名镜像仓库地址，如：
***.xuanyuan.run- 轩辕镜像地址
- 点击"测试连接"验证配置是否正确
- 测试成功后，点击"应用"保存配置
✅ 配置成功提示： 如果测试连接成功，说明自定义存储库配置正确。之后您就可以通过轩辕镜像存储库快速拉取各种 Docker 镜像了。
测试镜像拉取
验证自定义存储库配置是否正常工作
- 在 Container Station 中，点击左侧的"映像"
- 点击右上角的"提取"按钮
- 在提取映像窗口中：
- 模式：选择"基本模式"
- 存储库：从下拉菜单中选择"轩辕镜像"
- 映像：填写要拉取的镜像名称，如
nginx
- 勾选"将存储库设置为默认设置"（可选，方便后续使用）
- 点击"提取"开始下载镜像
日常使用说明
配置完成后的日常使用方法
后续拉取镜像：
- 进入 Container Station → 映像 → 提取
- 存储库选择"轩辕镜像"
- 输入要拉取的镜像名称
- 点击提取即可享受服务
💡 小贴士： 建议勾选"将存储库设置为默认设置"，这样后续拉取镜像时会自动使用轩辕镜像服务，无需每次手动选择。配置完成后，威联通 NAS 会自动使用轩辕镜像服务拉取镜像，大大提升下载速度和稳定性。
服务说明：
- 轩辕镜像地址：适合国内大陆用户，访问速度更快
流量耗尽错误提示
当您的流量用尽时，拉取镜像会显示以下错误，请及时充值：
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如果正常拉取，说明专属域名可用且有流量；如果无法拉取，请根据具体报错信息进行排查。
💡 提示： 如无法自行解决，请提交工单寻求技术支持。