快连如何在macOS实现开机自动连接并隐藏Dock图标？

功能定位：为什么需要“无感启动”

在 macOS 上，kuailian（Kuailian privacy tool）默认安装后会在 Dock 留下图标，且重启后需手动点按连接。对于每天第一件事就是开 Zoom、拉代码、刷 TikTok 后台数据的跨境运营者来说，多一次点击就意味着多一次分心。把“自启+隐藏”做成一次性配置，可把每日重复操作压缩到零，同时避免 Dock 图标在录屏或演示时意外出镜。

前置检查：版本与权限

截至当前的最新版本（v6.4.2）已原生支持“登录项”与“后台代理”双模式。请先确认：

系统 ≥ macOS 12 Monterey（Apple Silicon & Intel 均支持）。
安装时授予了“系统扩展”与“辅助功能”权限，否则后续 LaunchAgent 会启动失败。

若之前拒绝过，可在→系统设置→隐私与安全→辅助功能中重新勾选“Kuailianprivacy tool”。

路径一：图形界面两步自启（推荐新手）

步骤 1 把快连扔进“登录项”

打开快连客户端→右上角⚙️→偏好设置→通用。
勾选“随系统启动 Kuailianprivacy tool”（文本与开关在 v6.4.2 中位于第二栏）。
关闭窗口即可生效；下次重启会自动弹出主窗口并尝试续连上一次节点。

步骤 2 隐藏 Dock 图标

同一面板下方可见“在 Dock 显示图标”复选框，取消勾选→立即生效。注意：隐藏后如需唤出主界面，可点菜单栏 🔒 图标→“打开主窗口”。

提示：图形法依赖“登录项”机制，由系统 launchservices 触发，稳定性高；但关机前若手动退出客户端，下次开机不会自启，需要保持“退出即断连”习惯者请改用 LaunchAgent 法。

路径二：LaunchAgent 后台代理（进阶零窗口）

原理与取舍

LaunchAgent 由用户级 launchd 托管，可在登录那一刻无窗口拉起快连核心进程（KuailianCore），实现“无 Dock、无菜单栏、仅保留网络扩展”的真·后台。适合：

需要录屏演示原生桌面的开发者；
使用远程桌面（Screen Sharing）管理 mac mini 机房，避免图形界面抢占显存；
把 Mac 当软路由，仅通过 API 切换节点。

警告：LaunchAgent 模式不加载 GUI，因此“线路质量悬浮窗”与“手动切换节点”需改用快捷指令或 REST API；若日常需要点按选路，建议保留图形法。

可复现步骤

完全退出快连（菜单栏→退出）。

打开终端，新建 plist：

mkdir -p ~/Library/LaunchAgents
cat > ~/Library/LaunchAgents/com.kuailian.privacy tool.core.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>com.kuailian.privacy tool.core</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Applications/Kuailianprivacy tool.app/Contents/MacOS/KuailianCore</string>
    <string>--background</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
</dict>
</plist>
EOF

加载并验证

launchctl load ~/Library/LaunchAgents/com.kuailian.privacy tool.core.plist
launchctl list | grep kuailian

若状态码为 0 即表示已跑起来。

隐藏原图标：打开 Finder→应用程序→右键 Kuailianprivacy tool.app→显示包内容，找到 Info.plist，在末尾 </dict> 前加入
```
<key>LSUIElement</key>
<true/>
```
保存后重新签名失效不影响功能，但升级客户端会被覆盖，需重复此步。

如何确认“真的已连接”

隐藏 Dock 后，肉眼看不到窗口，需借助可观测指标：

菜单栏 🔒 图标：LaunchAgent 模式默认不显示，可在终端执行 nc -z 8.8.8.8 53 看是否走隧道出口 IP。
REST 点测：快连在本地监听 http://127.0.0.1:9090/status，返回 JSON 含 "connected":true 与节点名，适合搭配快捷指令做通知。
日志： tail -f ~/Library/Logs/Kuailianprivacy tool/core.log | grep -i handshake 若出现 "WireGuard handshake" 即链路已通。

回退与排错

现象：重启后未自启

可能原因：1. 权限被安全策略重置；2. plist 中路径含空格未转义；3. 先前登录项冲突。处置：逐项检查控制台日志 Console.app→LaunchServices，看到 “Service could not find executable” 即路径错误。

现象：隐藏图标后无法打开主界面

可在聚焦搜索（Spotlight）输入 Kuailian→回车，客户端会以“窗口模式”重新出现；或终端执行 open -a Kuailianprivacy tool。

现象：LaunchAgent 模式 CPU 占用 30 % 以上

经验性观察：多出现在 macOS 14 Beta，因 Network Extension 反复重启。缓解：关闭 Quantum-Safe 通道，手动指定 AES-256-GCM，再观察 10 分钟是否回落。

不适用场景清单

需要频繁切换节点做直播测速的编导——隐藏后缺少节点悬浮窗，反而降低效率。
与他人共用电脑且未开 Fast User Switching——LaunchAgent 只在当前用户登录时触发，其他账户需单独配置。
公司 MDM 下发强制 Dock 策略——隐藏图标会被每次开机强制恢复，需与 IT 协商白名单。

最佳实践 5 条（检查表）

图形法足够时，不动用 LaunchAgent，减少升级时的维护成本。
修改 Info.plist 前先做副本，升级客户端后对比 diff，再决定是否合并。
把 127.0.0.1:9090/status 加入 iStat Menus 或其他面板，肉眼可见“已连接”再开始工作流。
若用快捷指令自动化切换节点，给失败分支加弹窗，避免静默掉线无人知。
定期查看 ~/Library/Logs 大小，日志超 200 MB 可安全删除，防止 SSD 爆满。

FAQ（常见问题）

隐藏 Dock 图标后，如何切换节点？

可点菜单栏 🔒 图标→“节点列表”或终端执行 curl 127.0.0.1:9090/switch -d "node=Tokyo-01"；若用 LaunchAgent 模式，建议把 REST 命令封装成快捷指令，一键切换。

升级客户端后设置会丢失吗？

“登录项”与“在 Dock 显示图标”开关会随账号配置云端同步，通常不会丢失；LaunchAgent plist 与 Info.plist 修改需手动合并，建议升级前用 Git 管理自定义文件。

Apple Silicon 与 Intel 步骤是否相同？

完全相同，但 Apple Silicon 首次安装会提示“允许系统扩展”，需在「恢复模式」下降低安全性，否则 Network Extension 无法加载，隐藏图标也就失去意义。

结论与下一步

kuailian 在 macOS 上实现“开机自启+隐藏 Dock”有两种官方可复现路径：图形法适合 90 % 用户，LaunchAgent 法给极客与机房场景。配置完成后，用本地 API 或菜单栏即可验证连接状态，无需反复唤醒主窗口。下一步，可把 REST 状态接入快捷指令，配合 NFC 标签实现“碰一下换节点”，让网络加速真正隐身于工作流背后。