常见问题

请搜索你的问题，或者如果找不到答案，请提交一个问题。

OrbStack 是免费的吗？

OrbStack 现在已经不再是测试版，因此是一个付费产品。你必须购买许可证用于自由职业、商业和企业用途。

• 个人使用：免费
• 商业和企业使用：$8/用户/月
  • 包括非营利组织。
• 教育用途：可以申请免费许可证，需经批准。
• 用于开源开发：可以为非商业项目申请免费许可证，需经批准。商业开源开发者必须购买许可证。

我们希望 OrbStack 的性能、速度、可靠性、简单性和潜在的成本节约能够证明其价格是合理的。如果你有任何疑问或特殊需求，请联系我们。

你有 30 天的宽限期来购买许可证。

为什么是订阅？

我们明白：订阅让人头疼。我们也不喜欢它们。但是我们认为订阅是使我们的激励与你的需求一致的最好方式，我们希望对此保持透明。如果我们没有达到你的期望，你可以取消订阅。

我们还计划引入 在线服务 来简化开发者的工作流程，这些服务如果没有订阅将无法持续运行。

终身 许可证是不可持续的。OrbStack 的组件需要持续更新：与新版本的 macOS 兼容、Linux 内核和其他各种部分，以及保持竞争力的新功能。

主要版本升级 激励我们推迟功能发布数月，而这些功能本可以更快发布；我们更愿意逐步改进，让你持续获得价值。此外，由于缺乏逐步测试，主要升级有很高的引入破坏性更改、bug 和其他问题的风险。

1 年更新 + 备份永久版：本质上是一种变相的年度订阅？如果你不想继续支付费用，只需取消订阅。JetBrains 采用这种混合方式 + 订阅——对此并不完全反对，但它也存在很多问题（例如，激励更慢的功能开发）。实际上，谁会回滚到一年前的版本并永远使用它呢？

这是一个棘手的问题。

OrbStack 是开源的吗？

不，OrbStack 是一个闭源产品，但一些组件 是开源的。有关许可和定价计划，请参见上文。

OrbStack 与 Docker Desktop 有何不同？

OrbStack 是 Docker Desktop 的一个即插即用替代品，它快速、轻便、简单且易于使用。详细比较请参见 OrbStack 与 Docker Desktop。

从 Docker Desktop 切换很简单：只需打开 OrbStack 并开始使用。

OrbStack 与 Colima 有何不同？

OrbStack 是 Colima 的一个即插即用替代品，它快速、轻便、简单且易于使用。特别是在网络方面，它更可靠和无缝，并且与 Docker Desktop 有更好的兼容性。详细比较请参见 OrbStack 与 Colima。

从 Colima 切换很简单：只需打开 OrbStack 并开始使用。

我可以使用相同的 Docker 工具吗？

OrbStack 提供了一个未修改的 Docker 引擎，其设置类似于 Docker Desktop，因此兼容性极佳。这意味着你熟悉和喜爱的工具可以开箱即用，包括：

• Docker CLI
• Compose
• 第三方工具，如 Earthly 和 VS Code Dev Containers

详细信息请参见 第三方工具。

许可如何运作？SSO、组织、批量购买？

你可以购买多个许可证，使用 Google 和 SAML SSO，并创建带有自动许可证分配和自动邀请的组织。

详细信息请参见 许可。

为什么需要管理员权限？

OrbStack 要求管理员权限来执行可选的设置任务：

• 如果你还没有安装命令行工具，则进行安装
• 通过在 /var/run/docker.sock 创建符号链接来提高与第三方工具的兼容性

如果你不放心，可以拒绝管理员访问。

将来，我们可能会添加需要管理员权限的性能改进和功能。我们尽量避免这种情况，但有时这是不可避免的。

命令行工具

如果你选择允许管理员权限，将会安装以下工具到 /usr/local/bin：

• orb, orbctl: 管理 OrbStack 并使用 Linux 机器
• docker, docker-compose, docker-buildx: Docker 命令行工具
• docker-credential-osxkeychain: 用于在 macOS 钥匙串中保存注册表登录信息的提供程序

需要管理员权限吗？

不，管理员权限是可选的。你可以在没有管理员权限的情况下使用所有 OrbStack 功能。

支持 Kubernetes 吗？

是的。OrbStack 可以运行一个轻量级集群用于本地开发，并具备 GUI 和网络集成。详细信息请参见 Kubernetes。

为什么有一个 8 TB 的数据文件？

OrbStack 数据中的 8 TB data.img 文件是一个虚拟磁盘映像。不用担心大小；它是一种称为稀疏文件的特殊文件，这意味着它只占用你实际使用的空间，并在你删除数据时自动缩小。它不会占用 8 TB 的磁盘空间。

稀疏文件是 APFS 的一种功能，提供了一种快速、高效、灵活的方式来存储具有可变使用量的大文件。Time Machine 支持它们，因此你的备份不会受到影响。8 TB 的大容量允许 OrbStack 动态管理磁盘，所以你不必担心磁盘空间过多或过少。

要查找文件的实际大小，请运行 du -h ~/.orbstack/data/data.img，或在 Finder 的信息面板中查看“磁盘上的大小”。稀疏文件有两个大小：表面大小（在本例中为 8 TB）和磁盘上的大小（实际使用量）。许多工具显示的是表面大小，但磁盘上的大小才是磁盘空间的重要指标。

如果有第三方应用程序对该文件有意见，请参见 GitHub 问题。由于 macOS 广泛使用稀疏文件，我们希望推动生态系统向前发展并解决与之相关的兼容性问题。

这是一个 Electron 应用吗？

不是，OrbStack 是一个用 Swift 编写的原生 macOS 应用。底层组件使用 Go、Rust 和 C 混合编写。

如何从备份中排除数据？

要排除容器、镜像、卷和 Linux 机器的数据，请将 ~/.orbstack/data 添加到排除列表中。

为什么 Intel 和 Apple Silicon 分开？

从技术上讲，OrbStack 完全可以是一个通用应用。然而，OrbStack 的大部分体积来自特定于架构的 Linux 镜像和二进制文件，这意味着作为一个通用应用，应用和更新的大小将翻倍。我们认为这不值得，但我们可能会在未来重新审视这个决定。

你不能做什么？

好问题！我们认为 OrbStack 非常棒，我们一直在改进它，但有些事情我们目前还做不到。以下是一些常见的问题，许多问题我们正在计划中：

• Linux 图形应用程序和 GPU
• USB 直通
• 动态内存（被 macOS bug 阻止）

在大多数情况下，我们的效率目标没有做出任何妥协。

它是如何工作的？为什么它很快？

OrbStack 使用一个轻量级的 Linux 虚拟机，并紧密集成、专门构建的服务和网络，使用 Swift、Go、Rust 和 C 混合编写。详细信息请参见 架构。

如何回到 Docker Desktop？

在应用中停止 OrbStack 并将 Docker 上下文更改回 desktop-linux：

bash

docker context use desktop-linux

docker context use desktop-linux

详细信息请参见 恢复。

如何回到 Colima？

在应用中停止 OrbStack，然后重启 Colima。详细信息请参见 恢复。

Colima 将自动恢复 Docker 上下文。

我可以使用 Podman 吗？

内置的 Podman 支持正在考虑中。请在功能请求中投票，帮助我们确定优先

级。

同时，你可以创建一个 Linux 机器并在其中使用 Podman。绑定挂载、端口转发等将按预期工作。例如：

bash

orb create ubuntu
orb sudo apt install podman
orb sudo podman run -it --rm -p 80:80 docker.io/docker/getting-started

orb create ubuntu
orb sudo apt install podman
orb sudo podman run -it --rm -p 80:80 docker.io/docker/getting-started

为什么需要 macOS 12.3+？

支持 macOS Catalina 10.15 是不可行的，因为当时没有 OrbStack 使用的虚拟化 API。

理论上，支持 macOS Big Sur 11 是可能的，但仍有一些缺失的 API 会导致不良体验。而且，这种请求很少。

macOS Monterey 12.0–12.2 有必要的 API，但存在关键的虚拟化错误，会导致不良体验（性能问题和崩溃）。因此我们只支持 macOS 12.3 及更新版本。

无法连接到 unix://.orbstack/run/docker.sock 的 Docker 守护进程

此错误表示 Docker 客户端在 OrbStack 未运行时尝试使用它。启动 OrbStack 以修复此错误。

如果你刚刚卸载了 OrbStack

更改 Docker 上下文回 default 以修复错误。

bash

docker context use default

详细信息请参见 恢复。