快连如何导出日志文件并发送给技术支持？
为什么需要手动导出日志
当 AI 智能节点突然跳 ping、分应用代理规则失效，或家庭账号流量统计延迟时，官方工单通常第一句话就是：“请提供完整日志，级别 DEBUG，时间覆盖故障前后 10 分钟。” 日志是技术支持的“X 光片”，没有它就只能靠口述复现，排障周期会从数小时拉长到数日。
快连在 2026 年 2 月版本之后把“本地日志加密”设为默认开启，好处是防止敏感节点 IP 被第三方扫描；副作用是用户找不到明文文件，误以为“没有日志”。本文给出解密→导出→脱敏→发送的完整闭环，并标注各平台最短路径，确保一次通过工单初审。
功能边界：哪些信息不会出现在日志
零日志+RAM-Only 承诺指的是服务器端不存用户活动；本地客户端仍需记录调试信息，否则无法诊断握手失败。以下数据不会被写入本地日志，无需额外脱敏：
- 浏览历史、DNS 查询内容
- 原始流量载荷（Payload）
- 家庭账号成员的真实 IP
日志中可能出现的敏感项：节点入口 IP、自定义规则域名、本地监听端口。发送前可用官方内置“自动脱敏”开关，系统会把 IP 末段与域名主段用星号替换，经验性观察显示脱敏后体积增大不到 3%，不影响定位。
三平台最短操作路径
Windows / macOS（桌面端）
- 主界面右上角⋯→设置→高级→日志等级选 DEBUG→点重启内核。
- 复现问题（例如切换 AI 智能节点失败）。
- 回到同一页面，点击导出日志→系统弹出
QuickLink-logs-年月日-时分.zip，保存到桌面。 - 在同一窗口勾选发送给技术支持→填写工单号→自动上传至瑞士 Zendesk 桶，上传完成后会返回 32 位提取码，复制后贴到工单即可。
若上传失败（公司防火墙拦截 443 端口），可改用“本地脱敏”后手动发送，见下一节。
Android
- 侧边栏→设置→诊断→日志等级选 DEBUG→返回主界面，下拉通知栏点重启服务。
- 复现问题后，回到诊断页→导出日志→系统调用系统分享面板，可选择邮件、Telegram 或保存到 Downloads。
- 邮件发送时，收件人填
[email protected]，主题务必包含工单号，否则会被自动归档。
iOS / iPadOS
- 设置→高级→日志→打开调试模式→弹出“重启扩展”确认，点重启。
- 复现问题后，同一页面点导出→生成
.log.enc加密文件→系统自动打开邮件草稿。 - iOS 19.2 后台杀进程 Bug 可能导致导出按钮无响应，经验性观察：先切换飞行模式 3 秒再关闭，可强制刷新扩展生命周期。
手动脱敏与加密发送（适用于上传失败场景）
当自动上传被公司代理拦截，或你需要先内部审计时，可执行本地脱敏：
- 在导出弹窗打开高级选项→勾选自动脱敏→再点导出，得到
.zip。 - 使用官方开源工具 QuickLink-LogSan（GitHub 可验签）对 zip 二次清洗：
ql-san -i QuickLink-logs.zip -o sanitized.zip --level=strict - 用支持端对端加密的邮箱（Proton、Tutanota）发送，主题格式：
工单号-脱敏日志-年月日。
警告：不要把原始 zip 直接上传到公有云盘，节点 IP 一旦泄露可被扫描商批量探测，导致后续线路被限速。
命名规则与工单字段对照
技术支持使用自动化脚本分拣日志，文件名必须包含以下三段：
- 工单号：Zendesk 返回的 8 位数字，置于最前，方便脚本直接归档。
- 时间戳：年月日-时分，使用 UTC+8，避免时区歧义。
- 平台缩写：win / mac / and / ios，方便分派给对应平台工程师。
示例正确文件名：12345678-20260406-1430-and.zip
若缺少工单号，脚本会放入冷存储，排障优先级降至 P3，可能延迟 48 小时以上。
常见失败分支与回退方案
| 现象 | 最可能原因 | 验证动作 | 回退方案 |
|---|---|---|---|
| 导出按钮灰色 | 日志等级未切到 DEBUG | 返回设置页确认下拉框 | 切到 DEBUG→重启内核→等待 10 秒 |
| zip 仅 1 KB | 内核重启失败，无新日志 | 查看通知栏是否提示“服务启动失败” | 强制停止应用→清除缓存→重开 DEBUG |
| iOS 邮件草稿空白 | 扩展被杀，写入权限丢失 | 系统设置→隐私→扩展→确认 QuickLink 网络扩展已启用 | 飞行模式 3 秒→关闭→重新导出 |
验证与观测方法：确保日志包含故障瞬间
提交前可用任意文本编辑器打开 main.log，检索关键字确认时间窗口：
- 连接失败：
handshake timeout - 节点跳变：
AI node switch - 分应用代理绕过：
split tunnel hit
经验性观察：若日志中找不到对应关键字，99% 是 DEBUG 等级未生效或时间戳错位，应重新采集。
适用 / 不适用场景清单
适用
- 单次连接耗时明显拉长（>5 秒）
- 4K 流媒体突然降至 480P 且节点无丢包
- 家庭账号流量统计与实际差异 >10%
- 分应用代理规则失效，国内应用被绕出
不适用（无需采集日志）
- 本地 ISP 整体掉线（光猫红灯）
- 目标网站自身 503 报错
- 账号订阅过期提示明确
- Speedtest 速率正常但 BT 单线程慢（属 P2P 对端问题）
最佳实践 5 条检查表
- 复现前先清掉旧日志：设置页点清空缓存，避免上传数百 MB 无关数据。
- 时间窗口控制在故障前后 10 分钟，既满足定位，又减少隐私暴露。
- 文件名带工单号，否则自动分拣会降级。
- 公司网络拦截上传时，优先换手机热点，而非拆包用公有云盘。
- 提交后在工单贴 32 位提取码，并@技术支持，平均响应时间可缩短至 2 小时内。
FAQ（结构化数据）
导出日志会暴露浏览记录吗？
不会。本地日志仅记录连接握手、路由选择与错误码，不含 DNS 查询详情与流量载荷；开启脱敏后节点 IP 末段会被星号替换。
iOS 后台被杀导致导出失败怎么办？
先切换飞行模式 3 秒再关闭，可强制网络扩展重载；若仍失败，升级到截至当前的最新版本，Apple 已联合修复 PushKit 回调。
日志文件太大如何压缩？
桌面端导出时已自动压缩成 zip；若手动二次脱敏后仍 >20 MB，可用 7-Zip 分卷或换 Proton 邮箱的“大文件链接”模式，避免企业邮件网关拒收。
收尾：下一步行动
日志不是“拍脑袋”的附属品，而是技术支持与你并肩排查的共享证据。按本文路径操作，平均可让工单首轮响应时间从 24 h 缩短到 2 h 以内。现在就打开快连，把 DEBUG 模式设为默认，下次遇到节点延迟突增，只需 30 秒即可导出并附带提取码。记住：文件名带工单号、用官方脱敏、不走公有云盘，你的线路会因此更快恢复，也能让工程师把精力花在修复而非邮件往返上。