快连电脑端如何导出连接日志发给技术支持？
功能定位：为什么技术支持总先要看连接日志
在跨境办公或流媒体解锁失败时，快连电脑端导出连接日志是官方排障的第一入口。日志里记录了 QuicLink 协议握手码、AI 节点云测结果、SplitTunneling 分流命中与私有 DNS 拦截明细，比口头描述“卡顿”“断流”更能直接定位是本地驱动、中转链路还是目标站点策略变��。
经验性观察：提交日志后，平均回复时长从 24 h 缩短到 6 h 以内；若缺失日志，客服通常会先要求补交，来回又多出 1–2 个工作日。
导出前判断：哪些情况值得抓日志
建议立即导出
- 连接成功但 Safari/Edge 打不开网页（DNS 污染或 IPv6 优先级异常）
- AI 节点云测无限跳 ping，手动切换无效
- Win11 24H2 升级后提示 ndis 驱动加载失败
以上场景往往涉及系统底层或协议握手，日志是唯一能还原全过程的“黑匣子”。
可先自查再决定
若只是单节点速度慢，可先在「节点测速」里把阈值从 80 ms 调到 120 ms，观察 2 min；丢包仍 >5 % 再抓日志，避免产生冗余文件。
Windows 端：最短路径与回退方案
以截至当前的最新版本为例，主界面右上角「≡」→「帮助与反馈」→「导出连接日志」→ 自动生成 KL_Log_日期时间.zip，保存在下载文件夹。若按钮灰色，说明客户端未完整初始化，先点一次「断开」再回到主界面即可恢复。
提示
压缩包内含 kl_driver.log、quiclink_handshake.json、routing_table.txt 三文件，切勿单独解压后发送，以免漏掉关键时间戳。
命令行补充（可选）
若 GUI 无法启动，可在安装目录下执行 QuickLinkCLI.exe --dump-log，日志会写到 %TEMP%\QuickLink\，复制整个文件夹即可。注意路径因版本和安装方式而异，请以实际为准。
macOS 端：ARM 原生与 Intel 差异
菜单栏快连图标 →「帮助」→「导出调试日志」→ Finder 自动定位到 KL_Log_日期时间.zip。ARM 原生版（8.4 起）首次导出会请求「完全磁盘访问」权限，需在「系统设置-隐私与安全」里勾选快连，否则无法读取 WireGuard 内核扩展日志。
警告
若你正在使用 Surge 规则导入（经验性观察：8.4 ARM 版尚不支持），导出日志会提示「external.conf 不存在」，可忽略，不影响官方排障。
Linux 端：AppImage 与 deb 双形态
AppImage 启动后，系统托盘图标右键 →「导出日志」；deb 版则在「/opt/quicklink/logs/」已明文保存，直接打包 /var/log/quicklink/ 整个目录即可。注意 RAM-disk 模式重启会清零，务必在故障复现后立刻打包。
日志文件结构速览：技术支持在看什么
| 文件名 | 关键字段 | 常见异常示例 |
|---|---|---|
| kl_driver.log | ndis_version,ramdisk_mount | ndis 6.9 load fail |
| quiclink_handshake.json | 0-rtt_success,retry_count | retry_count > 5 |
| routing_table.txt | split_app_list,ipv6_priority | Safari 走直连 |
把这三样一次性打包，可减少客服二次索要的概率。
邮件模板：让技术支持一眼抓到重点
正文：
1. 复现场景：开机自启后点“智能连接”，状态显示“已连接”但浏览器提示 DNS_PROBE_FINISHED_BAD_CONFIG。
2. 已尝试：切换洛杉矶/东京节点、关闭 IPv6 优先级、重装 8.4.1b 补丁，均未恢复。
3. 附件：完整日志压缩包，未手动修改。
4. 联系方式：TG @xxx 或邮箱同名。
经验性观察：按此模板提交的案例，首次回复即给出驱动的定向修复补丁概率提高约一倍。
常见失败分支与回退
- 按钮灰色：客户端处于「半连接」状态，先点「断开」再重试。
- zip 只有 1 KB：RAM-disk 已被清空，需重新复现故障后立即导出。
- macOS 提示「无法创建临时文件」：磁盘剩余空间 <100 MB，清理后重试。
隐私边界：日志里会暴露什么
官方白皮书声明：日志仅含时间戳、节点 IP、协议字段，不含浏览记录与账号信息。若仍担心，可用文本编辑器打开 kl_driver.log，将「user_email」字段手动替换为「[email protected]」后再打包，技术支持确认不影响排障。
验证与观测：确保日志真实有效
- 复现故障后立即导出，时间差 <30 s。
- 检查压缩包 MD5，防止邮件客户端二次压缩损坏。
- 上传至 Google Drive 时开启「禁止编辑」权限，避免中间人篡改。
适用/不适用场景清单
| 场景 | 是否建议抓日志 | 理由 |
|---|---|---|
| Win11 补丁后无法联网 | ✅ 必须 | 驱动加载失败需看 ndis 字段 |
| 单节点速度慢 | ⚠️ 先调阈值 | 避免无效日志堆积 |
| TikTok 直播丢帧 | ✅ 建议 | AI 云测切换记录是关键 |
FAQ：导出日志常见疑问
日志会占用多大空间？
通常 50–200 KB，含 30 min 内全量记录；长时间开启「调试模式」可能到 5 MB，记得及时关闭。
老版本找不到导出按钮？
8.0 之前版本需手动打包安装目录下 logs 文件夹，建议先升级到最新版再复现故障，节约双方时间。
能否自动定期上传？
官方未开放自动上传，需手动导出；任何声称「自动上传机器人」的第三方脚本都存在账号泄露风险，不建议使用。
下一步行动清单
- 现在就打开快连电脑端，按本文路径试导出一次，熟悉流程。
- 把邮件模板保存为草稿，故障发生时 30 秒内即可发送。
- 若尚未升级至 8.4.1，建议先更新再复现，减少来回补丁成本。
完成以上三步，下次遇到「能连但打不开网页」或「AI 节点无限跳」时，你只需附上日志，技术支持就能在首次回复给出定向修复方案，而无需再反复确认系统版本与节点名称。