快连kuailian如何导出节点日志发给技术支持？
快连节点日志导出完整指南：三端路径、打包格式与客服工单附件规范，确保技术支持秒级定位故障。
功能定位：为什么节点日志是排障第一入口
在快连（Kuailian）的工单系统里，节点日志被官方列为「必传附件」之首。它记录了客户端与边缘节点间每一次握手、重传、协议回落与选线决策，相当于给技术支持一张「现场照片」。没有日志，客服只能凭用户文字描述反向推测，平均往返次数会从 1.4 轮升至 4.8 轮（经验性观察，样本为 2026 年 3 月工单）。
从 v8.2 起，快连把「本地零日志」与「可导出诊断包」拆成两条独立策略：日常运行依旧不写入硬盘，仅在用户主动点击「导出」时一次性打包内存缓冲区。这样既通过新加坡 PwC 无日志审计，又满足 GDPR「数据可携带权」要求。
版本演进：导出入口的两次迁移
v8.0 之前：藏在「关于」里的彩蛋
早期入口被放在「设置 → 关于 → 连续点击版本号 7 次」，没有文字提示。很多用户误以为是隐藏调试模式，实际上生成的 .kdiag 包就是节点日志。
v8.1–v8.3：显性化到「帮助与反馈」
官方收到大量「找不到日志」投诉后，在「帮助与反馈」顶部新增「导出节点日志」按钮，但仍需二次确认「是否同时包含抓包文件」，容易让新手误以为可选而跳过。
v8.4.2（当前最新版本）：整合为「诊断包」
入口统一到「我的 → 客服中心 → 生成诊断包」，系统默认勾选「节点日志 + 基础环境 + 最近一次抓包」，打包耗时约 5–8 秒，体积 80–300 KB，可直接跳转到系统分享面板。
三端最短路径对照表
| 平台 | 路径（截至当前最新版本） | 快捷方式 |
|---|---|---|
| Windows | 主界面右上角「≡」→ 客服中心 → 生成诊断包 | 托盘图标右键 → 快速诊断 |
| Android | 我的 → 客服中心 → 生成诊断包 | 长按悬浮球 → 诊断 |
| iOS | 我的 → 客服中心 → 生成诊断包 | 快捷指令「获取快连日志」动作* |
* 需先在「设置 → 快捷指令 → 共享设备分析」开启，否则动作返回空值。
生成原理：内存快照如何变成 .kdiag
点击「生成」后，客户端先把循环缓冲区（默认 512 KB）锁定，防止新事件覆盖；随后按 timestamp|node_id|proto|event|latency 的管道格式写入临时目录；最后再用 ZIP 压缩，文件名规则为 kuailian_diag_{uid}_{timestamp}.kdiag。整个过程不经过云端，压缩完立即弹出系统分享面板，文件仍保存在本地「下载/KuailianDiag」文件夹，方便二次转发。
打包内容清单：哪些必开，哪些可关
- 节点日志（默认开）：含握手、选线、重连原因，体积 50–150 KB。
- 基础环境（默认开）：系统版本、客户端版本、当前选路 IP，脱敏后约 2 KB。
- 最近一次抓包（默认开）：仅保留最新 30 秒，循环覆盖，体积 200 KB 左右。
- 账号哈希（可选）：用于客服关联工单，建议开启；脱敏后仅保留前 8 位。
- 全量抓包（可选）：若客服要求复现特定闪断，可手动开启，上限 10 MB，用完即焚。
注意
若您处在流量敏感环境（如 4G 共享热点），请关闭「全量抓包」，否则可能一次性消耗 10–20 MB 上行带宽。
发送给技术支持的四种合规通道
- App 内工单（推荐）：生成诊断包后，分享面板选择「返回快连」→ 自动附加，客服系统可直解 .kdiag，无需再解压。
- 邮件：发送至
[email protected]，主题注明「节点日志 + 工单号」，附件若 > 5 MB 会被拒收，需改用网盘链接。 - Telegram 工单机器人：搜索官方认证机器人
@kuailian_support_bot，输入/log后上传文件，机器人自动返回 Ticket ID。 - 国内官网 Web 工单：上传限制 3 MB，若文件超标，可先用系统「压缩包分割」功能（设置 → 高级 → 诊断包分割为 2 MB 卷）。
失败分支与回退方案
现象：点击「生成」后卡在 0%
可能原因：循环缓冲区被占用（多出现在 Windows 端同时开启 WireGuard-NT 与 RAW 模式）。回退：先断开连接，再次点击；若仍失败，重启客户端，系统会强制释放句柄。
现象：文件生成但分享面板空白
Android 国产 ROM 阉割了系统文件选择器。解决：手动进入「下载/KuailianDiag」目录，长按 .kdiag 文件 → 分享 → 选择邮件或 Telegram。
现象：客服反馈「包已损坏」
经验性观察：90% 是因为用户用微信文件助手转发，微信自动加 .txt 后缀导致校验失败。回退：原文件重命名删除多余后缀，或改用邮件原附件发送。
验证与观测：如何确认日志有效
把 .kdiag 解压后，用任意文本编辑器打开 node.log，检查是否包含最近 2 分钟的时间戳（UTC+8）。若最后一条记录早于「当前时间 – 5 分钟」，说明缓冲区已被覆盖，需重新复现问题并立即导出。
提示
Windows 用户可把 .kdiag 拖进 PowerShell，执行 Get-Date; cat node.log -Tail 5，快速确认时效。
不适用场景清单
- 仅想查询流量剩余：诊断包不含计费数据，请直接在「我的 → 流量明细」查看。
- 需要历史 7 天日志：客户端循环缓冲区仅保留 30 分钟，旧数据已被覆盖，无法回溯。
- 公司合规要求本地永久留存：快连奉行「零本地存储」，导出动作是瞬时快照，无法满足审计留档需求。
最佳实践 6 条检查表
- 出现问题 → 先断开重连一次，确认可复现 → 立即导出，防止缓冲区滚动。
- 导出前关闭「全量抓包」开关，避免附件超限。
- 若客服要求「复现 + 全量抓包」，先在设置里打开，再手动触发问题，30 秒内完成操作。
- 文件名自带 UID 与时间戳，无需重命名即可上传，防止 UID 泄露可本地压缩加密。
- 微信/QQ 转发会改后缀，务必改用邮件或 Telegram 原文件发送。
- 上传后记录 Ticket ID，与客服沟通时直接引用，减少反复询问。
FAQ（Schema 版）
导出日志会暴露浏览记录吗？
不会。节点日志仅含握手、延迟、重连事件，不含 URL 与 payload；抓包默认 30 秒且本地循环覆盖，除非手动开启「全量抓包」。
iOS 快捷指令无法获取日志怎么办？
需升级 TestFlight 版 ≥8.4.2，并在系统设置里允许「共享设备分析」；若仍失败，改用 App 内「客服中心 → 生成诊断包」手动导出。
诊断包太大被邮箱退信，如何拆分？
在「设置 → 高级 → 诊断包分割」开启后，系统会按 2 MB 一卷生成 .kdiag.001/.kdiag.002…，客服收到后自动合并解析。
Android 13 以上提示「无法访问下载目录」？
请授予「所有文件访问」权限，或手动将文件从「Android/data/im.kuailian.privacy tool/files/Diag」复制到公共 Download 再分享。
客服要求「复现三次日志」是否必须？
经验性观察：闪断类故障若仅单次日志，客服定位率约 55%；提供三次连续日志可把命中率提升到 87%。若时间允许，建议配合。
收尾：下一步行动
读完本文，你已掌握快连节点日志的生成原理、三端最短路径、常见失败分支与客服通道规范。下次遇到延迟突增或闪断，不必再写长篇文字描述，只需 10 秒导出 .kdiag，按「App 内工单 → 自动附加 → 提交」三步即可。把本页加入浏览器书签，或复制一份检查表到备忘录，排障效率至少翻倍。
