日志排障by 快连官方团队

快连lets断开后如何查看日志定位原因?

快连lets断开后如何查看日志lets线路掉线怎么定位原因快连lets日志文件路径在哪如何修改lets日志级别收集详细信息lets日志与系统日志有什么区别导出lets日志发给技术支持的步骤快连lets频繁掉线如何排查lets线路中断日志报错代码含义
快连lets断开后如何查看日志, lets线路掉线怎么定位原因, 快连lets日志文件路径在哪, 如何修改lets日志级别收集详细信息, lets日志与系统日志有什么区别, 导出lets日志发给技术支持的步骤, 快连lets频繁掉线如何排查, lets线路中断日志报错代码含义

功能定位:日志到底在解决什么问题

“快连lets断开后如何查看日志定位原因”这一关键词背后,用户真正的痛点是:掉线瞬间无提示,重连后依旧卡顿,却不知道该换节点、改协议还是找运营商。日志的价值就是把“黑盒”变成“白盒”,让每一次断开都能对应到时间戳、错误码、节点 IP、协议栈状态,从而决定下一步是手动切线、调级别,还是直接提交工单。

从版本演进看,快连在 6.2 之前只提供“连接成功/失败”两行提示;6.2 起把 WireGuard 内核日志映射到 UI;6.3 系列又加入 FastLink 2.0 私有协议栈的“AI 诊断”标签,支持一键导出 .zip 给客服。也就是说,你能看到多少字段,取决于客户端版本,而不是账号等级。换句话说,升级客户端就是升级“能见度”。

功能定位:日志到底在解决什么问题
功能定位:日志到底在解决什么问题

版本差异速览:该功能长什么样

客户端版本日志级别导出格式备注
6.1 及更早仅错误需 adb/logcat 抓取
6.2.x错误+信息.txtWin/macOS 首次引入
6.3.x错误+信息+调试.zip(含 .pcap)新增 AI 诊断标签
提示:如果你仍在 6.1,建议先升级,否则下文“导出”按钮根本不存在,只能走系统抓包,排查门槛高十倍。

操作路径:三平台最短入口

Windows / macOS

  1. 主面板右上角「≡」→ 设置 → 诊断 → 日志级别选“调试”。
  2. 复现掉线:让客户端自动重连一次,或手动点“断开”→“连接”。
  3. 同一页面点击「导出日志」,生成 QuickLink-log-日期.zip,保存到桌面。

示例:Windows 版在 6.3.2 中,若 SSD 空间不足,导出按钮会灰显并提示“磁盘剩余 < 200 MB”,此时清理临时文件即可立即恢复。

Android

  1. 首页下拉 → 设置 → 高级 → 日志级别 → 选“调试”。
  2. 回到首页 → 点“断开”→ 再连,触发一次完整握手。
  3. 设置 → 诊断 → 导出日志 → 选择「保存到下载」或「分享到邮件」。

iOS / iPadOS

  1. 我的 → 设置 → 诊断 → 打开“调试日志”开关(需 Face ID 验证)。
  2. 返回首页 → 断开 → 重连。
  3. 诊断页底部 → 导出 → 选「保存到文件」或「隔空投送」。
警告:iOS 因系统沙箱限制,导出的 .zip 仅包含应用层日志,不含内核扩展(NEPacketTunnelProvider)的详细握手包;若客服要求完整包,需借 macOS 控制台实时抓取。

字段速读:30 秒抓住关键行

打开 log.txt 后,直接搜索以下字符串,可跳过 90% 无效信息:

  • handshake_timeout → 节点未响应,换线或检查本地 UDP 被限速。
  • peer_down → 服务端主动踢掉,可能是负载均衡或 RAM-only 节点重启。
  • DNS_PROBE → 本地 DNS 污染,关闭「加密 DNS」再试。
  • keypin_mismatch → TLS 证书校验失败,大概率被中间人劫持,换网络或开「隐私隔离模式」。

经验性观察:同一节点在晚高峰出现 handshake_timeout 的概率比凌晨高 3 倍,但丢包率并不线性增加,说明是服务端主动限流,而非物理链路拥堵。

常见分支:日志级别开到“调试”后卡顿怎么办

调试级别会把每一包 WireGuard 的 initiation/response 都打印出来,在 100 Mbps 以上带宽场景下,日志写入量可达 4–6 MB/min,老电脑机械盘可能出现 UI 假死。缓解方案:

  1. 复现完掉线立即关回“信息”级别,减少持续写盘。
  2. Win 版可在设置 → 诊断 → 日志存储路径,改到 SSD 分区。
  3. Android 10 以下机型关闭「日志落盘」开关,仅保留内存环形缓冲区。

回退方案:导不出日志时的兜底手段

若客户端崩溃到无法点击“导出”,可用系统级工具兜底:

  • Windows:事件查看器 → Windows 日志 → 应用程序 → 来源 QuickLinkprivacy tool,筛选“错误”级别。
  • macOS:控制台 app → 位置 → 系统日志 → 筛选进程 QuickLink。
  • Android:adb logcat | grep quicklink(需开启 USB 调试)。
  • iOS:macOS 控制台 → 选中设备 → 筛选进程 QuickLinkprivacy tool。
提示:系统日志不含 AI 诊断标签,但能看到 NE 扩展崩溃的 Exception Type,足够判断是系统杀进程还是自身 OOM。
回退方案:导不出日志时的兜底手段
回退方案:导不出日志时的兜底手段

与客服协同:如何一次性把日志丢对工单

官方工单系统(https://support.quicklink.com)支持最大 30 MB 附件,无需压缩二次,直接把生成的 .zip 拖进去即可。填写字段时,把“掉线时间点”写成 UTC+8,方便客服用日志时间戳对齐。若节点为“智能选择”,请额外备注当时 AI 预测的延迟值(可在“连接记录”里复制),否则客服会反复让你手动指定节点再测一次。

风险控制:哪些场景不该长期开调试

  1. 公司合规电脑:调试日志可能把内网 DNS 打印出来,被 DLP 软件判成敏感外泄。
  2. 电池焦虑的移动场景:持续写盘会让 Android 系统无法进入 Doze,待机缩短约 8%(经验性观察)。
  3. 直播推流机:磁盘 IO 竞争可能导致 OBS 丢帧,建议用外接采集卡电脑分开抓日志。

验证与观测:怎么确认日志真的记录了断点

一个可复现的极简步骤:

  1. 打开日志目录,按修改时间排序。
  2. 记下最新文件的字节数 A。
  3. 客户端首页点“断开”→ 等 10 秒 → 点“连接”。
  4. F5 刷新目录,若字节数 A 增加 >3 KB,说明握手过程已落盘。

如果字节数不变,大概率是级别未切到“调试”或磁盘权限被安全软件拦截,此时导出按钮也会给出“0 B”提示。

适用/不适用场景清单

场景推荐级别理由
偶尔掉线,想自查信息足够看到 timeout 原因
游戏每 10 min 卡顿一次调试需看 AI 预测切换细节
公司合规笔记本错误避免内网信息外泄
低电量手机信息减少写盘耗电

最佳实践 5 条检查表

  1. 出现掉线先别急着换节点,第一时间固定级别→复现→导出,避免错过现场。
  2. 导出前用系统时间校准手机/电脑,确保时差 ≤2 s,方便客服对齐。
  3. zip 包命名改成「工单号+日期」,客服下载后可直接归档,减少来回。
  4. 若日志大于 20 MB,优先选邮件发送而不是在线上传,避免浏览器超时。
  5. 提交后把调试级别及时调回“信息”,防止下次开机持续写爆硬盘。

FAQ:日志相关高频疑问

调试级别会泄露我的浏览记录吗?

不会。日志仅记录握手、重传、DNS 查询域名,不含完整 URL 与 POST 正文,已通过 PwC 无日志审计。

为什么 iOS 导出按钮是灰色?

系统日志体积超过 5 MB 时,iOS 需要额外验证 Face ID;验证通过后即可高亮。

客服让我重测,但节点已被撤下,怎么办?

在“连接记录”里找到该节点 ID,复制给客服,后台仍可拉取该节点当时的负载与重启记录,无需复测。

Android 日志落盘开关打不开?

部分国产 ROM 把“写入外部存储”权限默认拒绝,需手动在系统设置→应用→快连→权限→文件与媒体,改为“允许”。

调试日志会影响带宽吗?

不会占用额外带宽,只增加本地磁盘写入;在 SSD 上测得 CPU 占用提升 <1%,机械盘可能因寻道出现偶发卡顿。

收尾总结与下一步行动

日志不是“万能钥匙”,却是你与客服、与开发者之间最省时的“共同语言”。记住“先固定级别、再复现、最后导出”的三步曲,就能把一次玄学掉线拆成可追踪的时间线。下次再遇到快连 lets 断开,不妨先别急着换节点,按本文路径把日志抓出来,三分钟就能判断是本地 UDP 被限速,还是服务端负载高。若问题仍超出个人能力,直接把 .zip 和 UTC+8 时间点丢进工单,客服通常能在 12 小时内给出节点或协议层面的确切答复。

立即行动:打开客户端,把日志级别调到“信息”,顺手跑一次导出,确认按钮可用——真掉线时才不会手忙脚乱。

未来趋势:经验性观察显示,快连正在灰度 6.4 内测版,日志页面新增“自动清理 7 天前文件”开关,可进一步降低磁盘占用;正式版预计 2024 Q3 推送,届时可省去手动清理步骤。