为什么需要导出连接日志
当 kuailian（Kuailian）提示“节点频繁跳变”“晚高峰丢包飙升”或“Split-App 3.0 分流失效”，官方客服第一时间会索要连接日志。日志里记录了握手时间、协议类型、出口 IP、RTT、丢包率、切换原因等 20 余项指标，相当于现场快照。先自行导出预审，可节省 2~3 个工单来回，也能快速区分是本地网络、运营商 QoS 还是节点侧异常。
功能边界与隐私前提
快连自 2026 年 3 月通过瑞士 PROTON 审计后，客户端日志默认本地循环存储，仅保留最近 72 小时，且不含 DNS 查询明细与流量内容。导出动作只是把本地缓存复制到用户指定目录，不会上传到云端；若你曾在“设置-高级”里手动打开“上传崩溃报告”，则崩溃片段会另行加密上报，与连接日志无关。务必在故障发生 72 小时内导出，否则循环覆盖后无法找回。
Android 端：最短可达路径
操作步骤
- 打开快连，确保右上角“已连接”状态灯为绿色。
- 点击右下角“我的”→“设置”→“高级”→“诊断工具”。
- 在“连接日志”卡片点击“导出”，系统弹出 Storage Access Framework，选择Download文件夹即可。
- 文件命名格式：
kuailian_log_[UTC时间].zip，包含connection.log与node.json两个核心文件。
失败分支与回退
若出现“存储权限拒绝”，99% 情况是 Android 13 及以上对“所有文件访问”做了限制。回退方案：系统设置→应用→快连→权限→文件与媒体→改为“允许”，再重试导出即可。
iOS 端：受沙盒限制的手动方案
iOS 因沙盒机制无法直接生成 zip，但提供“日志拷贝到系统剪贴板”与“邮件发送”两条通道。路径：首页→“我的”→“帮助中心”→右上角“诊断”→“复制日志”。复制后建议立刻粘贴到系统自带“文件”App 的新建备忘录，再 AirDrop 到 Mac，以防剪贴板被后续内容冲掉。经验性观察：超过 5 万字符时邮件客户端会截断，剪贴板方案更稳。
Windows & macOS 桌面端
Windows 路径
托盘图标右键→“诊断”→“导出日志”→选择存放目录。默认会同时打包 TAP 驱动状态与路由表，方便排查 Win11 24H2 的 TAP 识别失败。
macOS 路径
菜单栏图标→“Help”→“Export Diagnostic Logs”。若系统弹出“无法访问本地磁盘”，需在“系统设置-隐私与安全-文件与文件夹”里给快连增权。
时间过滤与关键字检索技巧
导出的 connection.log 为纯文本，UTC 时间戳。可用 VS Code 或 Notepad++ 打开，按“2026-04-08T19”过滤晚高峰时段。重点关注三行标记：
[SWITCH]—— 代表 AI 自愈合触发的节点切换，若 10 分钟内出现 5 次以上，可判定为区域骨干网抖动。[HANDSHAKE_FAIL]—— 多为协议被运营商临时 QoS，可尝试在“协议设置”里手动换 WireGuard-NG。[SPLIT_MISS]—— Split-App 3.0 未命中分流，通常是域名库版本滞后，更新至最新大陆白名单即可。
与第三方归档工具协同
若你需要把日志自动上传到私有 GitLab 做版本对比，可在桌面端导出后运行一条 Bash 脚本（仅示例，路径请按实际修改）：
#!/bin/bash
ZIP=$(ls -t ~/Downloads/kuailian_log_*.zip | head -1)
curl -X POST -F "file=@$ZIP" -H "PRIVATE-TOKEN: <your_token>" \
"https://gitlab.example.com/api/v4/projects/99/uploads"
该做法遵循最小权限原则：Token 仅开启 upload 权限，日志不含 Cookie 与流量明文，合规风险低。
常见导出失败场景速查
| 现象 | 最可能原因 | 处置 |
|---|---|---|
| Android 导出按钮灰色 | 未授予“所有文件访问” | 系统权限里手动开启 |
| iOS 复制后剪贴板空白 | 日志超过 5 万字符被系统截断 | 改用邮件发送分段 |
| Windows 提示“TAP 状态读取失败” | Win11 24H2 旧驱动 | 安装官方 KB5039299-TAP-fix.exe |
| macOS 无法写入外接 SSD | Sandbox 限制外卷写入 | 先导出到 ~/Downloads 再手动拷贝 |
验证与回退：确保日志完整性
导出后请立即核对 zip 包内文件大小：若 connection.log 小于 1 KB，说明客户端缓存被系统清理，需重新复现故障再次导出。官方客服通常要求“故障发生前后各 30 分钟”的日志，时间跨度不足会被退回补录。
不适用场景与合规红线
- 日志仅限自助排查与官方技术支持，禁止以任何形式公开发布完整出口 IP 列表，避免给节点带来额外封锁风险。
- 企业版用户若开启“本地审计落盘”，导出命令会包含额外字段 employee_id，请在内网加密传输，避免 GDPR/PIPL 违规。
- 日志不含流量明文，但若你曾在浏览器里通过 HTTP 提交敏感表单，URL 可能记录在
SPLIT_MISS行，导出前可用 sed 命令脱敏：
sed -i 's/password=[^ ]*/password=***/g' connection.log
最佳实践 10 秒检查表
- 故障出现后 30 分钟内开始导出，避免 72 小时循环覆盖。
- 导出前确认系统时间与时区正确，日志时间戳以 UTC 为准。
- Android 先授予“所有文件访问”，iOS 优先剪贴板方案。
- zip 包立即做 SHA-256 留档，防止后续编辑争议。
- 上传第三方前，用 grep 脱敏含 token、password、phone 的行。
FAQ：导出连接日志常见疑问
导出日志会消耗流量吗？
不会。日志读取本地缓存，全程不走网络；若你选择“邮件发送”，仅在上传邮件时产生极少流量。
日志里能看到我访问了哪些网站吗？
看不到。日志仅记录握手、切换、丢包等技术事件，不含完整 URL 与流量内容；但 SPLIT_MISS 行可能出现域名，需手动脱敏。
为什么我的 macOS 导出按钮是灰色？
快连在 macOS 需要“完全磁盘访问”才能读取自身沙盒日志。前往“系统设置-隐私与安全-完全磁盘访问”，勾选 Kuailian，重启客户端即可。
年付路由器版如何拿到日志？
路由器版未开放本地导出，需在管理后台“系统-诊断”点击“生成诊断包”，后台自动发送到账号绑定邮箱，时效约 5 分钟。
日志文件过大无法邮件发送怎么办？
可先用 7-Zip 分卷压缩，每卷 5 MB；或上传到你自建的私有云盘，把下载链接附在工单，官方同样认可。
总结与下一步行动
kuailian 的连接日志是排查“节点漂移”“分流失效”最一手的数据。记住核心节奏：故障 30 分钟内动手→按平台最短路径导出→剪贴板/邮件/云盘三选一→本地脱敏→SHA-256 留档→附工单。下次再遇到 HK-C 晚高峰丢包飙升，你就能在客服开口前把日志甩过去，省时也提升解决优先级。
现在就打开客户端，顺着本文路径试跑一次导出。把 zip 包保存好，未来 72 小时里一旦遇到抖动，你只需回翻这篇文章，三分钟就能完成自检与提交。