在 Mac 上卸载 OrbStack
OrbStack 的容器、数据卷和 Linux 机器可能装着数据库或开发环境。默认情况下，这些数据都放在 ~/Library/Group Containers/HUAQ24HBR6.dev.orbstack/data，这个文件夹可能就是你工作数据的唯一副本。先迁出需要的数据，确认能在目标环境打开，再移除应用。本页覆盖 orbstack.dev 官网下载版和 Homebrew cask。
停止运行环境，再卸载
先在容器或机器内保存文件、停止数据库等写入任务，备份需要的数据，再停止对应容器和机器，从菜单栏的 OrbStack 菜单退出。只关闭窗口不等于机器已停止。
官网下载版可以从 Finder 的「应用程序」把 OrbStack 移到废纸篓，Homebrew 安装版先保留原处的 OrbStack.app，完成下方 Homebrew 步骤后再检查应用，因为普通卸载要调用包内的 orbctl。OrbStack 官方卸载说明另外列出两个清除所有数据的文件夹。在 Finder 按 Shift + Command + G 打开核对，确定不再需要这些运行环境时才删除。
OrbStack 的文件在哪里
| 位置 | 存放内容 | 保留还是删除 |
|---|---|---|
~/Library/Group Containers/HUAQ24HBR6.dev.orbstack |
其中的 data 文件夹存放容器镜像、数据卷和机器磁盘 |
这是可能丢失的数据。迁移完成后再删。 |
~/.orbstack |
OrbStack 自己的设置和状态文件（测试时约 300 KB） | 不再使用 OrbStack 时再删。 |
~/OrbStack |
OrbStack 运行时查看容器和机器的入口，不占磁盘空间 | 不能当作备份，也不要把它当成存数据的文件夹去删。 |
/usr/local/bin 里的 docker、docker-compose、docker-credential-osxkeychain、kubectl、orb、orbctl |
指向应用内部的命令链接 | 测试后它们成了失效链接。只删仍指向 OrbStack.app 的项目，已被其他 Docker 安装接管的要保留。 |
/Library/LaunchDaemons 和 /Library/PrivilegedHelperTools 里的 dev.orbstack.OrbStack.privhelper |
特权 helper | 测试后它还在。在 Finder 里用管理员授权移除，然后重启。 |
OrbStack 的登录项和 helper 也会出现在「系统设置 › 通用 › 登录项与扩展」。应用删掉后，那里还留着的 OrbStack 项目要关掉。
~/.docker 可能还供其他 Docker 环境使用，移除 OrbStack 不需要一起删掉它。
检查结果
pgrep -il orbstack
ls -d ~/Library/Group\ Containers/HUAQ24HBR6.dev.orbstack ~/.orbstack
ls -l /usr/local/bin | grep -i orbstack
ls /Library/LaunchDaemons /Library/PrivilegedHelperTools | grep -i orbstack
pgrep 正常运行且没有报错时，没有输出只表示进程名没有匹配 orbstack，不能证明另有名称的辅助进程或 Linux 任务都已停止，删除数据前在活动监视器和应用里核对。第二条命令报 No such file or directory，说明文件夹已经不在；列出了路径说明还在磁盘上，如果你打算保留数据，这是对的。第三条命令有输出，说明还有指向 OrbStack.app 的命令链接，应用删掉后它们就是失效链接。最后一条有输出，只能识别匹配的 helper 文件，不能判断它的 launchd 服务是否在运行，权限或命令报错表示这些检查尚未确认。
用 Homebrew 安装时
Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。
自己运行 brew uninstall --cask --zap orbstack 时，zap 清单不看你在 Mole 里勾了哪些行，会删除 ~/Library/Group Containers/*.dev.orbstack，也就是所有容器、镜像、数据卷和机器，同时删除 ~/.orbstack、缓存、偏好设置和网页数据。两种命令执行前都先完成并核对备份和迁移，普通 brew uninstall --cask orbstack 也会调用应用包内的 orbctl _internal brew-uninstall 脚本，这一步独立于 zap 和 Mole 的数据勾选，不带 zap 不能证明该脚本会保留所有类型的数据。当前 cask
换回 Docker Desktop 时
先启动 Docker Desktop，再切回它的 context：
docker context use desktop-linux
成功表示后续 Docker 命令选择了这个连接，并不证明数据迁移完成。若提示 context 不存在，先完成 Docker Desktop 的初始化，不要靠删除配置修复。切换 Docker context 不会把 OrbStack 的容器、镜像或数据卷搬到 Docker Desktop。先在新环境里启动所需服务，检查数据库和文件，再清除 OrbStack 的 group container。更完整的说明见 卸载 Docker Desktop。
还要用 OrbStack 时，保留它的 group container 和配置。只卸应用图标后这些数据仍在，是可恢复的选择，不是卸载失败。
Mole 会列出什么
~/.orbstack默认关闭「卸载时一并移除数据和配置」时列出但不勾选，开启后符合条件的 OrbStack 自有数据可能预先勾选，想保留设置就取消这一行的勾选，下方组容器仍单独保护。HUAQ24HBR6.dev.orbstack这个 group container：从不默认勾选。它出现在删除计划里时，迁移完成前保持不勾。~/.docker：不列出，因为其他 Docker 环境也在用。- 特权 helper 和
/usr/local/bin的命令链接：不列出，按上面的步骤自己处理。
这次检查覆盖了什么
2026 年 9 月 18 日用 Homebrew cask 安装 OrbStack，和 Docker Desktop 成对测试，再通过 Mole 卸载。Mole 的删除计划只多了一行未勾选的 ~/.orbstack，zap 仍然把这个文件夹删掉了。~/.docker 留了下来。之后特权 helper 的 LaunchDaemon 和 /usr/local/bin 的六个链接都还在。真实容器数据迁移到其他环境的过程没有测试。