如何在 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 的数据放在哪里
备份还要的镜像、数据卷和快照,完成 Factory Reset 并退出后,在访达按 Shift + Command + G 打开下面存在的精确路径,只把不再需要的 Rancher Desktop 专属项目移到废纸篓。通配符名称从对应父目录里辨认,不把 * 粘贴进「前往文件夹」,保留组织管理的部署配置,官方文档列出了移除应用后留下的文件夹。
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
~/.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、~/Library/Preferences/ByHost/io.rancherdesktop.app* |
App 偏好设置和按主机的偏好设置 | 默认勾选 |
~/Library/Saved Application State/io.rancherdesktop.app.savedState |
窗口恢复状态 | 默认勾选 |
~/Library/Preferences/io.rancherdesktop.profile.{defaults,locked}.plist |
部署配置文件,你的 Mac 上有的话 | 官方卸载有意保留部署配置,组织管理的文件保留,单独核对 |
~/.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里的部署配置单独核对,组织管理的文件保留,不依赖固定的 Mole 勾选状态,检查实际行并取消勾选要留的配置,~/.kuberlr不在 Mole 的清单里。
这次检查覆盖了什么
2026 年 9 月 19 日,从官网 DMG 里把 App 拷进「应用程序」,从头到尾没有启动它的虚拟机或容器引擎,当天用 Mole Preview 277 卸载。App 本身加上 Helper 和 Renderer 一共 6 个进程,没有 qemu 或 Lima 后端,在状态页折成一行,也没有记录到登录项。Mole 精确列出 ~/.rd 和 Preferences/rancher-desktop 这两行,就是从这次测试来的。恢复出厂设置、跑着 Lima 虚拟机的情况和 Homebrew cask 都不在这次测试范围内。
