Sean
3.2 KiB
OrbStack Docker 镜像源配置教程
在 MacOS 系统上配置 OrbStack 使用轩辕镜像源，让所有 Docker 操作都享受优化访问体验
目录
获取专属域名
登录网站后，在左侧菜单栏的「专属域名」菜单中获取您的专属域名，格式为：***.xuanyuan.run
注意：请将 *.xuanyuan.run 替换为您的专属域名。登录网站后，点击左侧菜单栏的「专属域名」菜单即可获取。
配置 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": [
"***.xuanyuan.run"
]
}
此配置文件将设置 OrbStack 的镜像源
⚠️ 请将 *.xuanyuan.run 替换为您的专属域名。登录网站后，点击左侧菜单栏的「专属域名」菜单即可获取。
重启 OrbStack 服务
完成配置后，重启 OrbStack 服务：
💡 在 MacOS 上，您可以通过以下方式重启 OrbStack：
- **图形界面方式：**在菜单栏中点击 OrbStack 图标，选择 "Restart"
- **终端方式：**在终端中运行
orb restart - **设置界面方式：**在 Settings 窗口中修改配置后，OrbStack 会自动提示重启
验证配置
验证配置是否生效：
docker info | grep -A 10 "Registry Mirrors"
如果配置成功，您应该能看到您的轩辕镜像地址
✅ 成功配置后，输出信息中 Registry Mirrors 部分应该包含您所配置的镜像地址：
Registry Mirrors:
https://***.xuanyuan.run
开始使用
配置完成后，您可以直接使用标准的 Docker 命令拉取镜像：
拉取镜像：
docker pull mysql:latest
⚠️ PS: 不加 TAG 默认为 latest，建议指定具体的 TAG 版本进行下载。
配置说明
为什么选择 OrbStack？
相较于 Docker Desktop，OrbStack 具有更低的资源占用、更快的启动速度和更好的性能表现，特别适合 MacOS 用户使用。
配置优势
通过配置轩辕镜像源，您可以享受国内高速稳定的镜像下载体验，大幅提升开发效率。