连接失败时怎么在快连桌面端提取诊断日志？

为什么连接失败必须第一时间提取诊断日志

跨境办公或游戏加速场景里，快连桌面端一旦握手超时，后台 AI 路由引擎会立即切换节点；此时若用户反复手动重试，新日志极易覆盖旧记录，根因随之沉没。官方工单系统仅保留最近 30 分钟全栈日志，错过窗口就只能苦等复现，排障时长翻倍。第一时间提取诊断日志，相当于为技术支持递上“黑匣子”：在不泄露访问内容的前提下，完整还原协议协商、虚拟网卡状态、系统路由表三大要素，平均可把定位时间从数小时压到十分钟以内。

日志里到底记录了什么

诊断日志采用分级采样：ERROR 级记录握手失败代码，WARN 级捕捉节点延迟跳变，INFO 级登记虚拟网卡上下线事件，DEBUG 级才打印原始协议包前 64 字节。企业合规仪表盘默认关闭 DEBUG，防止 URL 意外落盘；个人用户若未开“详细模式”，所见仍是脱敏内容，与零日志政策声明保持一致。

Windows 端最短提取路径

以当前最新版为例，主界面右上角“≡”→帮助与反馈→诊断工具→一键导出，约 10 秒生成 KuailianDiag_日期时间.zip，默认落在下载文件夹。若软件卡死无法进入界面，可直接在安装目录双击 diag-cli.exe，命令行追加 /output D:\ 指定路径，同样有效。

macOS 端最短提取路径

顶部菜单栏快连图标→诊断→保存日志到桌面，系统会弹出钥匙串授权，输入开机密码即可。若图标意外消失，打开终端执行 /Applications/KuailianPrivacyTool.app/Contents/MacOS/diag-helper -d ~/Desktop，日志依旧完整。经验性观察：macOS 15 以上若开启“系统扩展”隔离，首次运行需到设置→隐私与安全→允许加载扩展，否则虚拟网卡事件会缺失。

Linux 端最短提取路径

AppImage 版在连接失败时自动于终端回显日志路径，复制即可。DEB 版需执行 sudo kuailian-cli --diag，输出位于 /var/log/kuailian/。若使用 WireGuard 内核模块，需额外授予 CAP_NET_ADMIN 权限，否则路由表快照可能为空。

常见失败分支与回退方案

分支一：点击“一键导出”后提示“日志写入失败”。原因多为杀毒软件锁住虚拟网卡驱动句柄，临时回退：先暂停实时防护，再执行导出，完成后立即恢复防护。

分支二：压缩包仅 1 KB，打开为空。经验性观察：软件在启动后 30 秒内崩溃，采样线程尚未初始化，此时可改用命令行工具，强制指定 --level=debug 重新捕获。

日志文件结构速览

文件名	用途	是否含敏感 URL
conn.log	节点握手代码、RTT	否
driver.log	虚拟网卡上下线	否
route.log	系统路由表 diff	否
debug.pkg	仅当用户手动开启	可能含 IP

如何验证日志完整性

解压后先用系统自带文本编辑器打开 conn.log，若末尾出现 [DiagExport]EOF 标记，说明采样正常结束；若最后一行时间戳与当前时间相差超过 5 分钟，则日志被截断，需要重新提取。

上传前的脱敏自检清单

确认未手动开启“记录全流量”实验开关。
检查 debug.pkg 大小，若超过 5 MB，建议删除或改用官方工单提供的加密上传通道。
用压缩包自带 hash.txt 校验 SHA-256，防止二次传输损坏。

企业合规仪表盘能否替代手动提取

仪表盘仅汇总流量异常事件，粒度到“设备+小时”，不含握手细节。若需定位协议级错误，仍需终端侧原始日志。经验性观察：在 GDPR 审计场景，两者结合可将举证时间缩短一半。

与第三方排障工具的协同

官方支持把 conn.log 导入 Wireshark 插件 kuailian-dissector（开源，GitHub 可验），可图形化查看握手往返。若使用第三方网络质量监测脚本，请关闭“自动重连”，否则 RTT 会被重连脉冲污染。

何时不该提取日志

若设备正在运行高敏感业务（如医疗影像传输），且本地法规要求“先审计后出境”，建议先断开外网，仅在内网环境脱机分析，避免日志被动同步到云端缓存。

最佳实践速查表

连接失败三次内必提日志，防止循环重连覆盖。
命名格式统一为 工单号_日期.zip，减少客服往返。
上传后本地留档 7 天，到期自动删除，节省磁盘。

FAQ - 诊断日志常见疑问

日志会保存我的浏览记录吗？

默认不记录 URL，仅采集协议握手代码与延迟。如未手动开启“全流量调试”，浏览记录不会出现。

压缩包太大无法上传工单怎么办？

可删除 debug.pkg 或改用官方提供的加密分片上传通道，客服会回传下载口令。

提取日志会导致二次断网吗？

不会。诊断工具只读取本地缓存，不触发重连；但为防杀毒冲突，建议先暂停实时防护再导出。

总结与下一步行动

连接失败时，第一时间用桌面端内置诊断工具导出日志，是缩短排障链路的最小成本动作。记住“三次失败必提取、命名带工单、留档七天即删”三原则，下次再遇节点握手超时，你只需 30 秒就能给官方提交完整证据链，而无需反复描述现象。现在就打开帮助菜单试走一遍路径，把本文收藏为应急手册，真正出问题才能不慌。