飞牛fnOS Docker 镜像配置教程
在飞牛fnOS中配置Docker使用轩辕镜像服务，享受高速稳定的镜像拉取体验
1飞牛fnOS Docker 镜像配置
飞牛fnOS 用户可以通过配置镜像仓库镜像源来使用镜像服务。 请按照下方步骤进行操作，配置完成后即可享受高速的镜像拉取服务。
💡配置前请确保您已登录网站，并在左侧菜单栏的「专属域名」菜单中获取了专属域名。 飞牛fnOS推荐使用专属域名方式，更加简单便捷。
2第一步：进入镜像仓库设置
打开飞牛fnOS的Docker应用，进入镜像仓库设置页面
- 打开飞牛fnOS的Docker应用
- 点击左侧的"镜像仓库"
- 点击右上角的"设置"按钮
3第二步：配置镜像源设置
在设置页面中配置镜像源
- 在设置页面中，找到"镜像源设置"选项
- 点击"添加URL"按钮
- 在输入框中填写您的专属域名，如：
•https://xxx.xuanyuan.run- 轩辕镜像地址 - 点击"添加"或"确定"按钮保存
⚠️注意事项：必须是 https://xxx.xuanyuan.run 这种带协议头的完整链接，否则会报错：镜像源地址无效
4第三步：设置轩辕镜像为首选镜像源
将轩辕镜像源设置为最高优先级
- 在镜像源列表中，找到刚添加的轩辕镜像源
- 使用拖拽或上下箭头按钮，将轩辕镜像源移动到最上面
- 确保轩辕镜像源位于列表顶部，成为首选镜像源
- 保存配置并退出设置页面
✅配置完成：设置完成后，飞牛fnOS将优先使用轩辕镜像服务拉取Docker镜像， 大大提升下载速度和稳定性。
5日常使用说明
配置完成后的日常使用方法
后续拉取镜像：
- 在Docker应用中搜索您需要的镜像
- 系统会自动优先使用轩辕镜像源
- 点击下载即可享受高速的镜像拉取服务
💡小贴士：将轩辕镜像源设置为最高优先级后， 系统会优先使用我们的服务，确保获得最佳的下载体验。
服务说明：
• 轩辕镜像地址：适合国内大陆用户，访问速度更快
6流量耗尽错误提示
当您的流量用尽时，拉取镜像会显示以下错误，请及时充值：
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 错误，表示您的流量已耗尽。请立即充值流量包以继续使用镜像服务。
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"