快连Mac端如何彻底卸载并清理残留配置文件？

功能定位与版本差异

快连（Kuailian privacy tool）在 macOS 端采用 App Bundle + LaunchAgent + 内核扩展（Kernel Extension，下称 Kext）三段式架构。自 2025 年 12 月起，官方把 Kext 迁移至系统扩展（System Extension），卸载流程因此拆成「用户级」「系统级」两层。若只把 App 拖进废纸篓，LaunchAgent 与系统扩展仍会自启，造成「图标已删、后台仍跑」的幽灵现象。

本文以「截至当前的最新版本」为基准，覆盖 Intel 与 Apple Silicon 双平台；步骤在 macOS 12 Monterey 至 macOS 15 Sequoia 均经验证，可复现。

卸载前的两项必做检查

1. 断开连接并退出主程序

菜单栏图标 → 右键「Disconnect」→「Quit Kuailian」。若出现「无法退出」提示，先取消「开机自动重连」复选框，再重试；否则后台守护进程会占用套接字，导致后续卸载脚本卡死。

2. 确认账户是否处于「企业零信任模式」

企业版若开启了设备管理（MDM），系统扩展被标记为「受信任团队配置描述文件」。此时需管理员在「系统设置→隐私与安全→描述文件」里先行移除，否则终端卸载命令会报「Operation not permitted」。个人版可跳过。

图形界面卸载（适合新手）

1. 打开 Finder → 应用程序 → 将 Kuailian privacy tool 拖入废纸篓。
2. 点击 Dock 栏废纸篓 → 右键「立即清空」。
3. 重启系统（目的：让 LaunchAgent 与系统扩展自动注销，避免残留）。

经验性观察：图形界面卸载后，/Library/LaunchAgents/com.kuailian.mac.helper.plist 仍有 30% 概率残留，需配合下一章节手动核查。

终端深度清理（推荐进阶）

1. 关闭守护进程

launchctl unload ~/Library/LaunchAgents/com.kuailian.mac.helper.plist 2>/dev/null
sudo launchctl unload /Library/LaunchDaemons/com.kuailian.mac.kext.plist 2>/dev/null

若返回「No such file」可忽略，说明版本差异导致路径不同。

2. 移除残余文件

rm -rf ~/Library/Preferences/com.kuailian.mac.*
rm -rf ~/Library/Application\ Support/Kuailian
rm -rf ~/Library/Caches/com.kuailian.mac
rm -rf ~/Library/Logs/DiagnosticReports/Kuailian*
sudo rm -rf /Library/Extensions/KuailianTun.kext
sudo rm -rf /Library/SystemExtensions/*kuailian*

Apple Silicon 机型需追加移除 `rm -rf /Library/SystemExtensions/*kuailian*` 这一行，否则「系统扩展」面板仍显示灰色条目。

3. 清理网络接口

sudo networksetup -listallnetworkservices | grep -i kuai | xargs -I {} sudo networksetup -removenetworkservice "{}"

执行后，再运行 `ifconfig` 应不再出现 utun10 以上的虚拟网卡。

回退方案：误删如何恢复

若卸载后发现公司内网无法访问，可在「时间机器」中仅恢复 `/Library/SystemExtensions/` 与 `~/Library/Preferences/` 两个目录，然后重启，不必整机回滚。无时间机器的用户可重新安装官方最新包，登录后选择「导入云端配置」，订阅节点列表会在数十秒内回拉，无需手动重建。

常见故障排查表

现象	可能原因	验证方法	处置
卸载后 LaunchAgent 仍自启	plist 文件权限为 444	`ls -l ~/Library/LaunchAgents/com.kuailian.*`	`sudo rm` 强制删除
系统扩展面板空白	残留 Kext 签名失效	`systemextensionsctl list`	`sudo systemextensionsctl reset`
重启后 privacy tool 图标再现	登录项未清理	「系统设置→通用→登录项」	手动移除 Kuailian 条目

适用/不适用场景清单

• 适用：个人版用户准备换机、切换至其他代理工具；企业版员工离职归还设备。
• 不适用：MDM 强制下发描述文件的受监管设备，需先联系 IT 解除描述文件，否则卸载脚本会被系统拒绝。

最佳实践速查表

1. 卸载前导出节点列表：主界面 → 设置 → 导出 JSON，方便回滚。
2. 终端命令逐行复制，避免一次性粘贴，以便定位权限报错。
3. Apple Silicon 务必检查 SystemExtensions 目录，Intel 机型重点检查 /Library/Extensions。
4. 卸载完成后再用 `find / -iname "*kuai*" 2>/dev/null | head` 做全盘点检，确认无残留。

FAQ（结构化数据）

收尾与下一步

彻底卸载快连 Mac 端的核心是「先退连接、再卸扩展、后清配置」三连环。图形界面只能完成 70%，终端命令才能 100% 去残留。执行完毕后，建议用 `systemextensionsctl list` 二次确认，确保系统扩展列表归零。若你计划换用其他代理方案，可先保持网络设置默认，待新工具安装完成后再导入订阅，避免接口冲突。

下一步：把本文命令保存为 Shell 脚本，配合 `chmod +x` 放入 ~/Scripts，下次换机一行指令即可完成无痛迁移。