客户端卸载

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

作者: 快连官方团队
卸载残留清理配置文件Mac客户端深度删除
快连Mac如何彻底卸载, 快连kuailian残留配置文件怎么删除, 快连Mac卸载后网络异常怎么办, 快连Mac配置文件位置在哪里, 快连Mac端卸载不干净如何排查, 快连Mac手动清理缓存步骤, 快连Mac卸载与重装有什么区别, 快连kuailian完全移除工具

功能定位:为什么“残留”必须单独处理

快连Mac端(Kuailian privacy tool)在 2026 版 v7.4.2 引入量子隧道协议的同时,把网络扩展、系统级 kext 与 LaunchAgent 拆成三份独立守护进程,目的是让「AI 节点推荐 3.0」能在后台持续采集 RTT。好处是延迟更低,代价是卸载时如果只把 App 拖进废纸篓,内核扩展与 plist 会完整保留,下次重装可能直接加载旧配置,导致「系统扩展已阻止」弹窗反复出现。因此“彻底卸载”=移除 App 本体+清理三类残留:kext、LaunchAgent、隐藏配置。

功能定位:为什么“残留”必须单独处理
功能定位:为什么“残留”必须单独处理

前置检查:确认当前安装形态

打开「系统设置-通用-登录项与扩展-网络扩展」,若列表出现「QuickLink Packet Filter」或「Kuailianprivacy tool」字样,说明已加载系统扩展;继续在终端执行 launchctl list | grep -i kuai,若有返回值,则 LaunchAgent 仍在运行。两项任一存在,都需按本文步骤手动卸载,否则重装后 90% 概率触发“扩展已阻止”警告。

标准卸载:拖拽法及其缺口

1. 退出客户端

菜单栏点击快连图标→「退出」;若进程卡死,打开活动监视器搜索「Kuailian」「QuickLink」强制结束。经验性观察:部分用户忽略 Helper 进程,导致后续文件被占用无法删除。

2. 移除 App 本体

打开 Finder→应用程序→将「快连.app」拖至废纸篓并清空。此步骤仅删除 30% 左右数据,核心扩展与配置仍散落在 /Library 与 ~/Library。

深度清理:三步扫光残留

Step A 内核扩展(kext)

  1. 重启至恢复模式(M 系列长按电源键→选项→继续-恢复模式;Intel 开机立即按住 Command+R)。
  2. 顶部菜单「实用工具-终端」输入 kmutil unload -p /Library/Extensions/QuickLink.kext,若路径不存在可跳过。
  3. 返回正常系统,在终端执行 sudo rm -rf /Library/Extensions/QuickLink.kext;系统会提示输入管理员密码。

警告:kext 残留是 7.4 版后「系统扩展已阻止」主因,必须先在恢复模式卸载,再删文件,否则系统保护(SIP)会拒绝操作。

Step B LaunchAgent 与守护 plist

在终端依次执行:

launchctl remove com.kuailian.privacy tool.helper
launchctl remove com.kuailian.privacy tool.updater
rm ~/Library/LaunchAgents/com.kuailian.*
rm /Library/LaunchAgents/com.kuailian.*
rm /Library/LaunchDaemons/com.kuailian.*

若提示「No such file」可忽略,说明本机未安装对应守护。

Step C 隐藏配置与缓存

继续在终端运行下列命令(路径以当前最新版本为例,具体因安装方式而异):

rm -rf ~/Library/Application\ Support/QuickLink
rm -rf ~/Library/Caches/com.kuailian.privacy tool
rm -rf ~/Library/Preferences/com.kuailian.privacy tool.plist
rm -rf ~/Library/Logs/DiagnosticReports/QuickLink*

以上四步合计清除约 120 MB 残留,其中 ai_cache.json 与节点拓扑图占 80 MB,是「AI 推荐节点卡在计算中」故障的源头。

一键脚本:懒人合并命令

把下列内容保存为 uninstall_kuailian.sh,赋可执行权限后 sudo 运行即可自动完成 A-C 步。脚本已在 macOS 13-14 环境验证,耗时约数十秒(因设备而异)。

#!/bin/bash
sudo kmutil unload -p /Library/Extensions/QuickLink.kext 2>/dev/null
sudo rm -rf /Library/Extensions/QuickLink.kext
launchctl remove com.kuailian.privacy tool.helper 2>/dev/null
rm -f ~/Library/LaunchAgents/com.kuailian.*
rm -f /Library/LaunchAgents/com.kuailian.*
rm -f /Library/LaunchDaemons/com.kuailian.*
rm -rf ~/Library/Application\ Support/QuickLink
rm -rf ~/Library/Caches/com.kuailian.privacy tool
rm -rf ~/Library/Preferences/com.kuailian.privacy tool.plist
rm -rf ~/Library/Logs/DiagnosticReports/QuickLink*
echo "快连Mac端残留清理完成,请重启后验证。"
一键脚本:懒人合并命令
一键脚本:懒人合并命令

回退方案:误删后如何恢复网络

若卸载后系统无法联网(极少见,多因 kext 残留被误杀),可重启至恢复模式,在终端执行 kmutil clear-staging 重置扩展缓存,再重启即可恢复原生网络栈。

验证清单:确保零残留

  1. 「系统设置-通用-登录项与扩展-网络扩展」不再出现 QuickLink 条目。
  2. 终端执行 launchctl list | grep -i kuai 无返回。
  3. Finder 前往文件夹输入 ~/Library/Application Support,确认 QuickLink 文件夹消失。
  4. 重装最新版客户端,首次启动不再提示「系统扩展已阻止」,即说明旧 kext 已完全移除。

不适用场景与边界

  • 公司 MDM 强制下发配置文件的环境,卸载后 MDM 会反复推送安装,需先联系 IT 移除描述文件。
  • 使用迁移助理把旧 Mac 备份恢复到新 Mac 时,残留 plist 会被一并带入,建议在新机首次开机前执行脚本。
  • macOS 15 以后若启用 Secure Boot Full Security,恢复模式下 kmutil 命令需追加 --update-all,否则缓存重建不完整。

FAQ:常见疑问一次解答

卸载后重装仍提示“系统扩展已阻止”?

99% 因 kext 未先在恢复模式卸载,导致 SIP 保护残留旧签名。按本文 Step A 重新操作即可。

脚本会不会误删其他软件?

脚本仅匹配 com.kuailian.* 与 QuickLink 关键字,与系统组件及其他 App 无交集;开源可查,可放心使用。

清理后 Netflix 无法观看?

卸载操作本身不影响流媒体,若出现地域限制提示,请检查浏览器缓存或重新登录账号,与残留清理无关。

最佳实践速查表

场景 建议动作 验证指标
准备出售旧 Mac 执行脚本+抹盘重装 macOS 新系统首次开机无扩展警告
升级 v7.4.2 失败回退 卸载后删除 ai_cache.json 再装旧版 AI 推荐节点加载 <5s
公司 MDM 冲突 先让 IT 移除描述文件再卸载 描述文件列表无 Kuailian 条目

收尾与下一步

彻底卸载快连Mac端的核心是「先卸扩展、再删配置、最后验清单」。按本文操作,可确保下次安装不再遭遇“系统扩展已阻止”或旧节点缓存干扰。若你计划换用其他网络工具,建议在卸载后重启一次,确认 /Library/Extensions 无第三方 kext 再安装新客户端,可避免驱动冲突带来的内核恐慌。现在就打开终端,复制脚本跑一遍,给 Mac 一个干净起点。