安装 OrbStack

请遵循快速入门指南开始使用。

替换 Docker Desktop

切换到 OrbStack 是完全无缝的：只需打开 OrbStack 并开始使用。

一切都会继续正常工作。

详细信息

建议停止 Docker Desktop 以节省资源，并卸载其命令行工具，以确保你继续从 OrbStack 接收更新版本。

如果你有管理员权限，OrbStack 会自动更新 /var/run/docker.sock 的符号链接以指向其自己的 Docker 引擎。这提高了某些第三方工具的兼容性。

数据迁移

安装后，OrbStack 将提供自动迁移你的 Docker Desktop 数据，包括容器、卷、镜像等。这是可选的，你可以随时通过 文件 > 迁移 Docker 数据 或通过命令行迁移：

orb migrate docker

这会复制你旧的数据，因此如果一切顺利，你可以重置 Docker Desktop 中的数据。

并行运行

你可以使用 Docker 上下文来并行运行 OrbStack 和 Docker Desktop。切换上下文会影响你之后运行的所有命令：

# 切换到 OrbStack
docker context use orbstack
# 切换到 Docker Desktop
docker context use desktop-linux

你可能还需要更改凭据存储。

恢复

如果你打算离开 OrbStack，请告诉我们原因！我们一直在寻找改进的方式。

要切换回去，停止 OrbStack 并启动 Docker Desktop，然后运行 docker context use desktop-linux 来恢复上下文。

替换 Colima

切换到 OrbStack 同样是无缝的：只需打开 OrbStack 并开始使用。

你可以选择停止 Colima 以节省资源。

并行运行

你可以使用 Docker 上下文来并行运行 OrbStack 和 Colima。切换上下文会影响你之后运行的所有命令：

# 切换到 OrbStack
docker context use orbstack
# 切换到 Colima
docker context use colima

恢复

如果你打算离开 OrbStack，请告诉我们原因！我们一直在寻找改进的方式。

要切换回 Colima，停止 OrbStack 并重启 Colima。上下文将自动恢复。

命令行工具

orb 和 orbctl 命令用于从命令行管理和使用 OrbStack 及其 Linux 机器。最新的 Docker 命令行工具（如 docker, docker compose, docker buildx 等）也包括在内。

启动 OrbStack 时，如果你没有安装这些命令，它们会自动安装。然而，如果你已经从其他来源（如 Docker Desktop 或 Homebrew）安装了这些工具，它们将不会被修改。要切换到 OrbStack 的版本，卸载或删除旧版本（如 /usr/local/bin/docker*）并重启应用。

工具将通过链接到 /usr/local/bin（为兼容性）并添加 ~/.orbstack/bin 到你的 PATH（为灵活性）进行安装。如果你不想全局安装它们，你总是可以在 ~/.orbstack/bin 找到它们。

卸载

如果你打算离开 OrbStack，请告诉我们原因！我们一直在寻找改进的方式。

要卸载 OrbStack，请从应用程序文件夹中删除该应用。你还可以删除 ~/.orbstack 目录以移除所有数据。

如果你要返回 Docker Desktop，切换 Docker 上下文回 desktop-linux。对于 Colima，不需要采取任何操作。

docker context use desktop-linux