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 用户使用。
配置优势
通过配置轩辕镜像源，您可以享受国内高速稳定的镜像下载体验，大幅提升开发效率。
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"