如何在 Mac 上卸载 Rancher Desktop
Rancher Desktop 在虚拟机里跑着容器和 Kubernetes 引擎,动 App 之前先把这个引擎清掉,它的恢复出厂设置会删掉虚拟机和大部分数据,还要用的镜像和数据卷先存好,快照在恢复出厂设置之后仍会保留。这份指南覆盖官网 DMG 下载的版本和 Homebrew cask rancher,Rancher Desktop 官方文档推荐用 DMG,并写明 Homebrew 上的包不是他们团队维护的。
先恢复出厂设置,再退出、移除 App
打开 Rancher Desktop,在 Troubleshooting 页面执行 Factory Reset,或者运行 rdctl reset --factory,清掉虚拟机和大部分数据(见 Rancher Desktop 安装与卸载文档)。然后从菜单退出 Rancher Desktop,在「活动监视器」里确认没有 Rancher Desktop 进程,再把它从「应用程序」拖进废纸篓。
Rancher Desktop 的数据放在哪里
Rancher Desktop 官方文档把下面这些列为删掉 App 之后还会留下的文件夹。
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
~/.rd |
Rancher Desktop 装的命令行工具 | 默认列出但不勾选 |
~/Library/Preferences/rancher-desktop |
偏好设置文件夹 | 默认列出但不勾选 |
~/Library/Application Support/Rancher Desktop |
以显示名命名的应用数据 | 默认列出但不勾选 |
~/Library/Application Support/rancher-desktop |
应用数据,快照放在里面的 snapshots 文件夹 |
默认列出但不勾选,恢复出厂设置不会删快照,移除前先看一眼 |
~/Library/Caches/rancher-desktop、~/Library/Logs/rancher-desktop |
缓存和日志 | 默认勾选 |
~/Library/Caches/io.rancherdesktop.app* |
bundle id 下的应用缓存 | 默认勾选 |
~/Library/Preferences/io.rancherdesktop.app.plist、ByHost/io.rancherdesktop.app* |
App 偏好设置和按主机的偏好设置 | 默认勾选 |
~/Library/Saved Application State/io.rancherdesktop.app.savedState |
窗口恢复状态 | 默认勾选 |
~/Library/Preferences/io.rancherdesktop.profile.{defaults,locked}.plist |
部署配置文件,你的 Mac 上有的话 | 按设计卸载后仍保留,默认列出但不勾选,公司统一管理 Rancher Desktop 的话就别动 |
~/.kuberlr |
Homebrew zap 清单里写到的数据 | 不在 Mole 的清单里 |
检查结果
pgrep -il "rancher desktop"
ls -d ~/.rd
ls -d ~/Library/Application\ Support/Rancher\ Desktop ~/Library/Application\ Support/rancher-desktop
pgrep没有输出,说明 Rancher Desktop 已经退出。- 第二行打印出
~/.rd,说明你留着这些命令行工具,提示「No such file or directory」说明已经不在了。 - 第三行同时检查两个 Application Support 文件夹,打印出哪个路径,哪个就还在。
用 Homebrew 安装时
Mole 会先检查 zap 清单,涉及未勾选的数据、共用的文件或无法确认的内容时不执行 --zap,已勾选的残留仍由 Mole 清理。
rancher 这个 cask 的 zap 清单会把 ~/.rd 和 ~/.kuberlr 移进废纸篓,这两个都不在 ~/Library 里,所以 Mole 卸载 Homebrew 装的 Rancher Desktop 时一律不带 --zap,只移除你勾选的行。
跟 zap 无关,这个 cask 的卸载步骤本身会退出 Rancher Desktop,删掉 /opt/rancher-desktop、给 Lima 虚拟机用的一个 sudoers 文件,以及 /private/var/run 下的 Docker socket 文件,加不加 --zap 都会做,这一步可能会弹出密码框。
brew uninstall --cask rancher
自己加上 --zap,还会把 cask zap 清单里的每一项都移进废纸篓,包括 ~/.rd、~/.kuberlr、连同快照在内的两个 Application Support 文件夹和 ~/Library/Preferences/rancher-desktop,不看 Mole 里勾了什么。
Mole 会列出什么
~/.rd和~/Library/Preferences/rancher-desktop是专门为 Rancher Desktop 列的精确行,默认列出但不勾选。~/Library/Application Support/Rancher Desktop和~/Library/Application Support/rancher-desktop默认列出但不勾选,快照在后一个里面。~/Library/Caches/rancher-desktop、~/Library/Logs/rancher-desktop、io.rancherdesktop.app的缓存、偏好设置文件和窗口恢复状态默认勾选。~/Library/Preferences里的部署配置文件默认列出但不勾选,~/.kuberlr不在 Mole 的清单里。
这次检查覆盖了什么
2026 年 9 月 19 日,从官网 DMG 里把 App 拷进「应用程序」,从头到尾没有启动它的虚拟机或容器引擎,当天用 Mole Preview 277 卸载。App 本身加上 Helper 和 Renderer 一共 6 个进程,没有 qemu 或 Lima 后端,在状态页折成一行,也没有记录到登录项。Mole 精确列出 ~/.rd 和 Preferences/rancher-desktop 这两行,就是从这次测试来的。恢复出厂设置、跑着 Lima 虚拟机的情况和 Homebrew cask 都不在这次测试范围内。
