日志排错

快连如何导出节点日志并发送给技术支持?

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

快连官方团队
快连如何导出节点日志, 节点日志发给技术支持步骤, 快连诊断日志提取方法, 日志文件保存路径在哪, 导出节点日志后无网络怎么办, 快连是否支持自动打包日志, 节点连接失败如何排查, 快连技术支持需要哪些日志

功能定位:为什么节点日志是排错第一入口

在快连(QuickLink)客户端里,节点日志=完整会话脚印:握手协议、线路跃点、延迟抖动、Kill-Switch 触发记录都按时间切片写入。官方技术支持收到日志后,可在后台匹配节点实例 ID,直接看到哪一跳丢包,无需用户反复描述“昨晚八点卡顿”。因此导出日志不是可选动作,而是工单标准流程的第一步。

与“连接诊断截图”相比,日志额外携带加密前的目标域名、端口与内部错误码,能区分“本地 ISP QoS 限速”与“机房入口拥塞”两种看似相同的现象。经验性观察:提供日志的工单平均回复时长缩短约一半。

功能定位:为什么节点日志是排错第一入口
功能定位:为什么节点日志是排错第一入口

版本差异与入口变更脉络

截至当前的最新版本(桌面 v6.4.x / 移动 v6.4.x),日志导出入口被统一到“帮助与反馈”板块,旧版分散在“设置-诊断”与“节点详情-更多”两处,容易漏掉。2026 年 4 月起的迭代还把日志打包格式从散列 txt 改为带签名的 .qlgz,避免用户误改时间戳导致审计失效。

若你仍使用 2025 年末的 v6.2,界面会缺少“一键打包”按钮,只能手动进入安装目录抓取 logs/ 文件夹,再自行压缩。官方工单系统已提示 v6.2 日志需额外备注“未签名”,否则会被要求重传。

Windows 与 macOS 桌面端操作路径

最短可达路径

  1. 主界面右上角 ⋮ → 帮助与反馈 → 导出节点日志
  2. 弹出窗口勾选“包含最近 48 小时”与“包含系统环境信息”
  3. 选择保存位置,默认生成 QuickLink-Logs-日期-时间.qlgz

若客户端崩溃无法打开,可退而求其次:进入安装目录(默认 C:\Program Files\QuickLink/Applications/QuickLink.app/Contents/Resources),把 logs/ 整个文件夹复制出来,用 zip 打包后上传。官方同样接受,但需在工单里说明“手动打包”。

Android 与 iOS 移动端操作路径

Android(Material You 动态取色版)

  1. 首页下拉 → 设置 → 帮助与反馈 → 导出节点日志
  2. 系统弹出“文件保存”对话框,选择 Documents/ 即可
  3. 日志文件同命名规则 .qlgz,可直接用系统邮件客户端发送

iOS(iOS 19.2 适配版)

  1. 底部导航“我的”→ 帮助与反馈 → 导出节点日志
  2. 文件首先存入“文件 App-快连”目录,随后自动弹出分享面板
  3. 选择“存储到‘文件’”或“邮件”均可;若用微信转发,需改后缀 .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 条速查表

  1. 出现问题后立即导出,避免日志被新会话覆盖(默认滚动 72 小时)
  2. 打包前重启客户端一次,可让崩溃栈写入文件,防止缺失
  3. 工单描述用“时间+节点+现象”三件套,例:5 月 11 日 21:00 东京线 300 ms→900 ms,YouTube 1080p 缓冲
  4. 大于 15 MB 时优先用网盘链接,避免网页上传超时
  5. 如含公司内网地址,先手动脱敏,再备注“已清除内网 IP”

FAQ:导出节点日志常见疑问

日志会保存我的浏览记录吗?

不会。节点日志仅记录连接层元数据(握手时间、目标 IP、端口),不含 URL 与内容,符合零日志政策。

为什么 iOS 导出后找不到文件?

文件默认存入“文件 App-快连”目录,需在分享面板点“存储到‘文件’”才能在第三方 App 中看到。

日志可以删除吗?

可以。客户端重启后会自动清理 72 小时前的日志;手动删除安装目录下的 logs 文件夹不影响运行。

技术组多久能回复?

经验性观察:工作日 8 小时内首次响应;含日志的工单平均快 50%。

日志文件损坏了怎么办?

重新导出即可;若连续损坏,检查磁盘健康度或关闭实时杀毒后再试。

收尾:下一步行动建议

读完本文,你已掌握 Windows、macOS、移动与路由全平台的日志导出路径,也了解了何时脱敏、如何上传、怎样写工单才能被技术组秒级响应。下次节点再掉线,不必反复截图测速,直接导出 .qlgz 并附带“时间+节点+现象”三件套,即可把排错效率拉到最高。

如果你还在用 v6.2 或更早版本,建议趁 618 活动前升级到最新版,不仅日志签名更规范,还能体验 AI 智能分流 2.0 与家庭云网关插件——把导出日志的时间省下来,早点看剧、开黑、写论文才是正经事。

标签

日志导出节点诊断技术支持故障排查快连客户端

立即体验快连VPN

下载快连VPN,畅享极速稳定的全球网络连接

免费下载