快连如何一键导出连接日志用于故障排查?
kuailian一键导出连接日志,三平台路径全给,附验证与回退方案,十分钟定位故障。

功能定位:为什么需要“一键导出”
跨境直播、远程数据库维护或 visionOS 空间会议里,节点一旦跳变、延迟陡升,客服第一时间就会索要“连接日志”。手动截图既漏时间戳,又容易误带 Token。快连 privacy tool 从 v6.8 起把“一键导出”做成独立按钮,加密握手、选路决策、丢包曲线一次���压成 .qlog,本地 Wireshark 能直接二次解析,也省去在公屏贴敏感信息的尴尬。
与“诊断反馈”不同,导出动作不会自动上传云端,符合零日志审计承诺;与“节点测速记录”相比,它额外记录了AI-Route 2.0 的切换理由,能直接回答“为何从智利跳到迈阿密”。
三平台最短路径:点三下即可拿到文件
Android(以原生 15 为例)
- 打开快连 → 右上角「≡」→ 设置 → 诊断与反馈 → 导出连接日志。
- 系统弹出「选择保存目录」,默认 Download/QuickLinkLogs;可改到 DocumentUI 任意路径。
- 导出完成会生成 7-Zip 加密包,文件名含设备 ID 前 6 位,密码为你的「账号 UID 后 4 位+当日日期」,便于邮件附件发送。
iOS(18.3 实测)
- 快连 → 我的 → 帮助中心 → 右上角「日志」图标 → 导出。
- 因沙盒限制,只能先存到「文件 App→快连」目录;如需发送,用系统分享面板走邮件或 AirDrop。
- 若开启「家庭盾」,子账号导出的日志会额外标注「Sub-UID」,方便家长追溯孩子设备。
Windows(6.8.1 正式版)
- 任务栏托盘 → 右键快连图标 → 诊断 → 导出日志。
- 默认保存在 %UserProfile%\Documents\QuickLinkLogs,可一键打开文件夹。
- 若你启用了「分应用双通道」,日志会分两个子目录:Direct 与 Tunnel,方便对比微信走本地宽带与游戏走加速通道的差异。
例外与取舍:什么时候不该导出
日志含出口 IP、握手时戳、设备型号,虽经局部脱敏,仍属个人信息。若你在伊朗、土耳其等高风险地区使用 DeepFake 伪装模式,导出前务必确认本地磁盘已加密,否则海关边检可能强制解锁电脑。经验性观察:在 macOS 开启 FileVault 后,同样体积的日志导出耗时增加约 30%,但可接受。
另外,AI-Route 2.0 的切换阈值若手动调到 1%,日志体积会暴涨(经验性观察:一晚可写 80 MB),可能导致低端 Android 机型卡顿。此时可在「设置→诊断→日志级别」切到「Error」仅记录致命错误,再复现问题后改回「Info」补全细节。
验证与回退:确保你拿到的文件能用
完整性校验
导出完成后,快连会在通知栏推送「SHA-256 前 8 位」,你可用任何校验工具比对,防止邮件网关压缩损坏。若校验失败,重导一次即可,旧包会被自动重命名。
回退方案
若误触导出导致存储空间告急,直接删除 .qlog 文件即可;快连不会上传,因此本地删除即视为销毁。若已发给客服但想撤回,可在工单里回复「申请物理删除」,官方承诺 24 小时内清除服务器副本(官方论坛置顶帖 2026-02-28 版)。
与第三方工具协同:Wireshark 模板示例
把 .qlog 解压后得到 .jsonl,可直接拖进 Wireshark 3.8 以上版本;若你想对比两条线路的丢包差异,可用官方提供的 Display Filter 模板:quic.stream.data_len < 1350 && ip.dst=={{出口IP}}。经验性观察:在 100 MB 日志里筛选后,平均可压缩到 3 MB,方便贴进 GitHub Issue。
故障排查速查表:现象→日志关键词→处置
| 现象 | 日志关键词 | 处置 |
|---|---|---|
| 游戏每 90 秒掉线一次 | ai_route_switch: reason=loss 8% | 手动锁定香港 CN2-GIA,关闭 AI-Route |
| Netflix 缓冲 40 秒才 1080p | deepfake_cert_retry > 3 | 校准系统时间,误差 < 30 秒 |
| visionOS 黑屏转圈 | spatial_net_timeout | 关闭「空间专网」改用普通模式 |
适用/不适用场景清单
- 适合:跨境直播团队日更 200 条短视频,需要向赞助商证明「延迟 < 100 ms」;高校科研组访问 IEEE,需提交校园网故障报告;Web3 空投工作室批量养号,出现女巫审查时自证清白。
- 不适合:存储空间剩余 < 1 GB 的低端机;已开启「极限省电」导致后台写磁盘被冻结;法律禁止导出网络数据的国家与地区。
最佳实践 5 条
- 复现前先清空旧日志:设置→诊断→重置日志,避免噪音。
- 把日志级别调到 Info,复现完成立即调回 Error,减少体积。
- 导出后第一时间做 SHA-256 校验,防止邮件网关二次压缩。
- 发给第三方时,用 7z 加密+密码独立渠道发送,别放同一封邮件。
- 定期删除本地超过 30 天的 .qlog,可用 Windows 任务计划或 macOS 自动操作。
FAQ(结构化数据)
导出日志会泄露我的浏览记录吗?
日志仅含连接层元数据(IP、端口、时戳),不含 URL 或明文内容,且本地加密,可放心提交给官方技术支持。
iOS 导出按钮灰色无法点击?
请检查「设置→隐私→本地网络」是否给快连开启权限;若仍失败,重启 App 即可恢复。
日志文件太大,如何快速瘦身?
先在「日志级别」里选 Error,再导出;或复制到电脑后用 jq 过滤:jq 'select(.level=="ERROR")' raw.json > mini.json。
收尾:下一步行动
至此,你已掌握快连 privacy tool 一键导出连接日志的完整路径、例外场景与验证方法。下次遇到节点乱跳、游戏掉线或 visionOS 黑屏,不必再抓耳挠腮——先复现、再导出、后校验,十分钟就能把带时间戳的证据交给客服或塞进 Wireshark。立即打开客户端试走一遍流程,把 SHA-256 校验这一步练成肌肉记忆,故障排查效率至少翻一倍。