快连如何导出节点日志并发送给技术支持?
快连节点日志导出教程:三平台路径、打包格式与官方工单上传入口,助技术支持秒级定位故障。

功能定位:为什么节点日志是排错第一入口
在快连(QuickLink)客户端里,节点日志=完整会话脚印:握手协议、线路跃点、延迟抖动、Kill-Switch 触发记录都按时间切片写入。官方技术支持收到日志后,可在后台匹配节点实例 ID,直接看到哪一跳丢包,无需用户反复描述“昨晚八点卡顿”。因此导出日志不是可选动作,而是工单标准流程的第一步。
与“连接诊断截图”相比,日志额外携带加密前的目标域名、端口与内部错误码,能区分“本地 ISP QoS 限速”与“机房入口拥塞”两种看似相同的现象。经验性观察:提供日志的工单平均回复时长缩短约一半。
版本差异与入口变更脉络
截至当前的最新版本(桌面 v6.4.x / 移动 v6.4.x),日志导出入口被统一到“帮助与反馈”板块,旧版分散在“设置-诊断”与“节点详情-更多”两处,容易漏掉。2026 年 4 月起的迭代还把日志打包格式从散列 txt 改为带签名的 .qlgz,避免用户误改时间戳导致审计失效。
若你仍使用 2025 年末的 v6.2,界面会缺少“一键打包”按钮,只能手动进入安装目录抓取 logs/ 文件夹,再自行压缩。官方工单系统已提示 v6.2 日志需额外备注“未签名”,否则会被要求重传。
Windows 与 macOS 桌面端操作路径
最短可达路径
- 主界面右上角 ⋮ → 帮助与反馈 → 导出节点日志
- 弹出窗口勾选“包含最近 48 小时”与“包含系统环境信息”
- 选择保存位置,默认生成
QuickLink-Logs-日期-时间.qlgz
若客户端崩溃无法打开,可退而求其次:进入安装目录(默认 C:\Program Files\QuickLink 或 /Applications/QuickLink.app/Contents/Resources),把 logs/ 整个文件夹复制出来,用 zip 打包后上传。官方同样接受,但需在工单里说明“手动打包”。
Android 与 iOS 移动端操作路径
Android(Material You 动态取色版)
- 首页下拉 → 设置 → 帮助与反馈 → 导出节点日志
- 系统弹出“文件保存”对话框,选择
Documents/即可 - 日志文件同命名规则
.qlgz,可直接用系统邮件客户端发送
iOS(iOS 19.2 适配版)
- 底部导航“我的”→ 帮助与反馈 → 导出节点日志
- 文件首先存入“文件 App-快连”目录,随后自动弹出分享面板
- 选择“存储到‘文件’”或“邮件”均可;若用微信转发,需改后缀
.qlgz→.zip否则被拦截
Linux CLI 与路由器固件场景
快连提供 quicklink-cli 包,日志命令如下:
quicklink-cli log export --hours 48 --output /tmp/qlog.qlgz
OpenWrt 插件版路径为 /usr/bin/quicklink,参数相同。若路由器存储不足,可加 --stream 直接管道到 ssh 远端主机,避免先写临时文件。
如何回传日志:官方工单上传入口
官网 → 右上角头像 → 工单 → 提交新问题 → 问题类型选“节点故障”→ 在附件区点击“上传日志”即可,系统仅接受 .qlgz/.zip,单文件 <15 MB。若超时上传失败,可拆分为 24 小时片段或改用 Google Drive 链接(需设为“任何拥有链接者可查看”)。
提示
上传后请把工单号写进邮件标题,例如【日志已传 #123456】,技术组会优先拉取。
例外与取舍:什么时候不该导出完整日志
在公共网吧或 borrowed 电脑,日志可能残留敏感域名(如公司后台地址)。此时可在导出窗口取消“系统环境信息”,并在上传前用文本编辑器删除顶部 system_info 段落,仅保留 node_session 部分。官方仍接受,但需备注“已手动脱敏”。
若你担心隐私,可先在本地解压 .qlgz(本质是 gzip),用 grep 排除含“username”“token”的行,再压缩上传;只要时间戳与节点 ID 保持完整,不影响排错。
故障排查:常见导出失败及处置
| 现象 | 可能原因 | 验证与处置 |
|---|---|---|
| 点击导出无响应 | 日志目录被安全软件锁定 | 把 QuickLink 加入白名单后重试 |
| 文件大小 0 B | 磁盘剩余空间 <100 MB | 清理回收站,确保系统盘可用空间 >1 GB |
| 提示“签名失败” | 系统时间误差 >5 分钟 | 同步网络时间,再次导出即可 |
适用/不适用场景清单
- 适用:节点突然掉线、延迟周期性飙升、Kill-Switch 误触发、跨区解锁失效
- 不适用:账号登录失败(需先确认账密)、支付页面加载慢(多为浏览器插件冲突)、设备数超限(需进控制台解绑)
经验性观察:约 30% 的“网速慢”投诉最终归因本地 DNS 污染,而非节点本身;上传日志后技术组会返回一份简要结论,用户可据此判断是否需要继续深挖。
最佳实践 5 条速查表
- 出现问题后立即导出,避免日志被新会话覆盖(默认滚动 72 小时)
- 打包前重启客户端一次,可让崩溃栈写入文件,防止缺失
- 工单描述用“时间+节点+现象”三件套,例:5 月 11 日 21:00 东京线 300 ms→900 ms,YouTube 1080p 缓冲
- 大于 15 MB 时优先用网盘链接,避免网页上传超时
- 如含公司内网地址,先手动脱敏,再备注“已清除内网 IP”
FAQ:导出节点日志常见疑问
日志会保存我的浏览记录吗?
不会。节点日志仅记录连接层元数据(握手时间、目标 IP、端口),不含 URL 与内容,符合零日志政策。
为什么 iOS 导出后找不到文件?
文件默认存入“文件 App-快连”目录,需在分享面板点“存储到‘文件’”才能在第三方 App 中看到。
日志可以删除吗?
可以。客户端重启后会自动清理 72 小时前的日志;手动删除安装目录下的 logs 文件夹不影响运行。
技术组多久能回复?
经验性观察:工作日 8 小时内首次响应;含日志的工单平均快 50%。
日志文件损坏了怎么办?
重新导出即可;若连续损坏,检查磁盘健康度或关闭实时杀毒后再试。
收尾:下一步行动建议
读完本文,你已掌握 Windows、macOS、移动与路由全平台的日志导出路径,也了解了何时脱敏、如何上传、怎样写工单才能被技术组秒级响应。下次节点再掉线,不必反复截图测速,直接导出 .qlgz 并附带“时间+节点+现象”三件套,即可把排错效率拉到最高。
如果你还在用 v6.2 或更早版本,建议趁 618 活动前升级到最新版,不仅日志签名更规范,还能体验 AI 智能分流 2.0 与家庭云网关插件——把导出日志的时间省下来,早点看剧、开黑、写论文才是正经事。