MacOS OrbStack 镜像教程
在 MacOS 系统上配置 OrbStack 使用轩辕镜像源，让所有 Docker 操作都享受优化访问体验
1获取专属域名
登录网站后，在左侧菜单栏的「专属域名」菜单中获取您的专属域名，格式为：xxx.xuanyuan.run
请将 xxx.xuanyuan.run 替换为您的专属域名。登录网站后，点击左侧菜单栏的「专属域名」菜单即可获取。
2配置 OrbStack 镜像
通过配置 ~/.orbstack/config/docker.json 中的 registry-mirrors，我们能够实现使用 docker 的镜像功能。然而，在 macOS 上，相较于 docker 桌面版本，OrbStack 以其更低的资源占用显得更为出色。那么，如何在 OrbStack 中配置国内镜像源呢？实际上，这一过程相当简便。
🖥️ 图形界面操作方式（推荐）
- 在菜单栏中点击 OrbStack 菜单，选择 Settings...（或使用快捷键 ⌘,）
- 在设置窗口的左侧边栏中，点击 Docker 选项
- 找到 Advanced engine configuration 部分
- 在配置编辑器中添加或修改
registry-mirrors配置 - 点击 edit the config file 链接可以直接编辑配置文件
或者，您也可以直接创建并编辑 ~/.orbstack/config/docker.json 文件：
{
"registry-mirrors": [
"xxx.xuanyuan.run"
]
}此配置文件将设置 OrbStack 的镜像源
⚠️请将 xxx.xuanyuan.run 替换为您的专属域名。登录网站后，点击左侧菜单栏的「专属域名」菜单即可获取。
3重启 OrbStack 服务
完成配置后，重启 OrbStack 服务：
💡在 MacOS 上，您可以通过以下方式重启 OrbStack：
- 图形界面方式：在菜单栏中点击 OrbStack 图标，选择 "Restart"
- 终端方式：在终端中运行
orb restart - 设置界面方式：在 Settings 窗口中修改配置后，OrbStack 会自动提示重启
4验证配置
验证配置是否生效：
如果配置成功，您应该能看到您的轩辕镜像地址
✅成功配置后，输出信息中 Registry Mirrors 部分应该包含您所配置的镜像地址：
Registry Mirrors:
https://xxx.xuanyuan.run5开始使用
配置完成后，您可以直接使用标准的 Docker 命令拉取镜像：
拉取镜像：
⚠️PS: 不加 TAG 默认为 latest，建议指定具体的 TAG 版本进行下载。
6配置说明
为什么选择 OrbStack？
相较于 Docker Desktop，OrbStack 具有更低的资源占用、更快的启动速度和更好的性能表现，特别适合 MacOS 用户使用。
配置优势
通过配置轩辕镜像源，您可以享受国内高速稳定的镜像下载体验，大幅提升开发效率。
镜像拉取常见问题
使用与功能问题
错误码与失败问题
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服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"