快连kuailian连接失败时怎么提取日志排查？
kuailian连接失败时，通过Android/iOS/桌面端内置日志导出功能，三步提取日志并上传工单，官方平均8分钟内响应。
功能定位：日志提取到底解决什么问题
当快连弹出「连接失败」「节点超时」或「认证错误」时，界面往往只留下一句简短文案，既看不到底层握手细节，也难以判断是本地网络、中转线路还是账号权限的问题。官方在 v8.4.2 起把「本地调试日志」入口开放给用户，目的就是在提交工单前，先由用户侧把完整链路信息一次性打包，减少来回追问，把平均响应时效压进 8 分钟。
与同类产品相比，快连把日志分为「常规」与「调试」两级：前者仅记录选线、重连、错误码，体积 20 kB 左右；后者额外包含 WireGuard-NT 内核回调、TUIC v5 帧解析、IEPL 专线跳点 RTT，体积可达 2 MB。官方客服默认只需要「常规」即可定位 90% 问题，只有当常规日志出现「unknown protocol -41」这类罕见码时，才会要求补充调试包。
操作路径：Android / iOS / 桌面端最短入口
Android（以 8.4.2 为例）
- 打开快连 → 右上角「我的」→ 底部「帮助与反馈」→「导出日志」。
- 在弹窗中选择「常规日志」→ 自动生成 kuailian_log_***.zip，保存在 Download/KuailianLogs。
- 点击「分享」→ 选择邮件或 Telegram，收件人填写 [email protected]，主题写「连接失败 + 节点名」。
若导出按钮灰色，请检查「系统设置-应用权限-文件管理」是否被禁用；部分三星 OneUI 6.2 用户反馈需先关闭「省电隧道」模式才能写入 SD 卡。
iOS（TestFlight 8.4.2 及以上）
- 快连主界面 → 头像 →「帮助」→「诊断与日志」→「保存日志」。
- 系统会弹出「已复制到文件 App」提示，路径：文件-我的 iPhone-快连-Diagnostics。
- 长按 .zip 选择「分享」→ 通过「快捷指令」可直接附加到客服工单邮件，无需手动输入地址。
若出现「无法与快连通讯」弹窗，经验性观察发现多为 TestFlight 描述文件过期，重装描述文件即可复现修复。
Windows / macOS
- 任务栏图标右键 →「日志」→「导出最近 24 h」。
- 默认保存在「安装目录/logs」；macOS 用户可在 Spotlight 搜索 kuailian_log 直接定位。
- 点击「一键上传」会生成 6 位提取码，复制后粘到工单即可，无需自己发邮件。
若公司网络屏蔽 UDP 8888，上传会提示「timeout」，此时可改用「保存本地」后手动贴到网页工单。
决策树：什么时候用常规日志，什么时候必须开调试
提示
调试日志包含真实远端 IP 与端口，若你在企业合规场景（需国密算法）使用，请先确认公司安全组是否允许外泄目标地址。
| 现象 | 首选日志级别 | 原因 |
|---|---|---|
| 「认证失败 code 691」 | 常规 | 仅账号或订阅过期，无需底层帧 |
| 「握手超时 15 s」 | 常规 | 可看到节点丢包率，足够定位 |
| 「unknown protocol -41」 | 调试 | 需查看 WireGuard-NT 内核回调 |
| 「IEPL 专线跳点 RTT 999 ms」 | 调试 | 需核对每一跳 ChaCha20 解密耗时 |
常见失败分支与回退方案
分支 1：导出按钮灰色
原因：Android 13 以上默认禁止第三方应用写入根目录。回退：手动给予「所有文件访问」权限，或把保存路径改到 /sdcard/Android/data/com.kuailian.privacy tool/files，无需额外授权。
分支 2：日志文件 0 B
原因：客户端刚安装尚未触发任何事件。回退：先尝试连接一次，不论成功或失败，系统写入首条日志后再导出即可。
分支 3：邮件发送被拦截
经验性观察：部分高校邮箱把 .zip 当作可疑附件。回退：把扩展名改为 .txt 或在网页工单直接拖拽上传，客服端会自动识别。
验证与观测：如何确认日志已包含关键信息
1. 用任意文本编辑器打开 kuailian_log_***.json，搜索「stage=handshake」，若能看到「remote_ip=x.x.x.x」「downlink_rtt=68 ms」即表示握手阶段已记录。
2. 若出现「fatal: cipher negotiation failed」，说明加密套件不匹配，可据此在客户端手动切回 AES-256-GCM 再测。
3. 文件体积低于 10 kB 且只包含「app_start」「ui_click」等事件，则属于空日志，需重新连接节点后再导出。
与客服协同：最小化敏感信息暴露
警告
调试日志默认包含远端 IP。若你担心目标地址泄露，可在上传前把文件拖入任意压缩工具，删除后缀为 .pcap 的原始抓包，再重新打包。官方声明客服系统会在 30 天后自动清理附件，但本地删除仍是最保险做法。
工单模板建议写三行：①失败节点名 ②错误截图 ③提取码或附件。多余描述反而拖慢首次响应。
适用 / 不适用场景清单
- 适用：个人用户、跨境电商运营、高校科研人员，需要官方技术支持且本地无抓包能力。
- 不适用：企业内网已部署国密网关，要求全程 SM4 加密，调试日志会因包含境外 IP 被安全审计打回。
- 不适用：节点完全无法解析域名（DNS 污染 100%），此时导出日志也会因「logger_endpoint」无法回传而空白，需先换网络环境。
最佳实践 5 条检查表
- 出现连接失败 → 先切「常规日志」→ 30 秒内导出 → 体积大于 20 kB 再提交。
- 同一节点 3 次重连均失败 → 再开「调试日志」→ 记录远端 IP → 上传前手动删 .pcap。
- 公司电脑禁用 USB → 用「一键上传」生成 6 位码 → 手机扫码贴到工单，不走本地文件。
- 高校邮箱退信 → 扩展名改 .txt → 或在网页工单直接拖拽，避免被垃圾网关拦截。
- 导出后 7 日若无客服回复 → 在 Telegram 频道 @kuailian_logs 贴提取码，值班会优先打捞。
FAQ：日志提取高频疑问（FAQ Schema）
日志里会保存我的浏览记录吗？
不会。官方声明本地零日志，调试文件仅含握手、路由、加密套件协商，不含 URL 或 payload。
iOS 导出后找不到 zip 怎么办？
打开系统「文件」App → 浏览 → 我的 iPhone → 快连 → Diagnostics，长按即可分享。
调试日志太大，邮件发不出去？
Windows/macOS 客户端可用「一键上传」生成 6 位提取码，不走邮件；手机端可先用微信文件传输助手压缩后再发。
客服多久能回复？
官方承诺平均 8 分钟，经验性观察：北京时间 10:00–22:00 提交，15 分钟内响应率高于 90%。
日志可以清理吗？
可以。客户端「设置-存储-清除日志」会删除本地 7 日前的文件，不影响已上传的客服副本。
收尾：下一步行动建议
连接失败时，先按本文「常规日志 → 工单上传」走一遍，可解决九成问题；若收到客服回复「需调试日志」，再开调试并记得手动删除 .pcap。把 5 条检查表截屏存在手机相册，下次报错 30 秒就能完成导出，官方响应也会更快。保留 6 位提取码截图，方便在 Telegram 频道二次跟进，减少反复描述设备环境的沟通成本。
经验性观察，v8.5 测试版已内嵌「自动判定日志级别」的实验开关，未来有望根据错误码自动勾选常规或调试，进一步缩短用户决策时间。现在就把路径背熟，下一份工单你也能在 1 分钟内完成上传。