遇到快连105错误时如何按最佳实践顺序排查?

快连105错误是什么?先对齐认知
“快连105错误”指客户端在握手阶段收到服务器显式拒绝(RST)并回显代码105。与常见的10054超时不同,105意味着“服务器已到达但拒绝继续”,多数由节点侧策略触发,而非本地网络彻底不可达。
在2026-03-25发布的QuickLink v11.2.0中,官方把105从“通用网络错误”拆成独立提示,并写入AI节点医生的判定树,方便用户一眼识别“可自愈”还是“需人工干预”。
版本演进:105错误提示的三次变化
v10.x 及更早:一锅端提示
旧版把超时、拒绝、证书校验失败全部归为“连接失败,请重试”,用户只能盲切节点,日志里才看得到105字样。
v11.0–11.1:错误码外露
UI弹窗开始带括号代码,但无后续动作指引;很多用户误以为“重启软件”就能解决,结果反复撞墙。
v11.2 至今:AI节点医生+链路自愈
检测到105后,客户端先在200 ms内重试同机房备用入口;若依旧RST,则标记“节点拒绝”并自动切换,同时把事件写进本地日志ql_diag.db,方便后续溯源。
最佳实践排查顺序(官方推荐三步法)
Step 1 看日志:确认是105而非其他
macOS:~/Library/Logs/QuickLink/conn-yyyyMMdd.log
Android:/sdcard/Android/data/com.quicklink/files/log/conn.log
iOS:系统设置→隐私→分析与改进→分析数据→QuickLink-*.ips 同步到Mac后查看
搜索关键字“code=105”即可定位;若看到“code=10054/10060”则归到超时类,按另一套流程处理。
Step 2 节点体检:用AI节点医生一键扫描
桌面端:主界面右上角“⚡”图标→AI节点医生→开始扫描;移动端:首页下拉→节点医生→立即体检。
经验性观察:在晚高峰(UTC 18:00–22:00)部分香港CN2节点会被运营商限速,医生会把这类节点标为“间歇性拒绝”,建议避开。
若报告提示“节点侧策略拒绝”且同机房多入口均失败,可直接点击“切换至推荐节点”,客户端会优先选择同区域非CN2线路,降低再次触发105的概率。
Step 3 协议降级:从QLink 2.3→WireGuard→TCP
部分企业专线入口为兼容旧防火墙,会丢弃QLink 2.3首包。设置→协议→依次选择“WireGuard UDP”或“TCP 443”→保存后手动重连。
平台差异与回退方案
| 平台 | 关闭AI自动迁移 | 一键生成诊断包 | 回退到上一版本 |
|---|---|---|---|
| Windows | 设置→诊断→自动迁移 OFF | 帮助→反馈→打包日志 | 系统设置→应用→QuickLink→高级选项→回滚 |
| macOS | 偏好设置→高级→自动迁移 OFF | 菜单栏→帮助→导出诊断 | Time Machine 还原或官网下载旧版DMG |
| Android | 我的→设置→智能切换 OFF | 关于→诊断→发送日志 | GitHub APK 历史版本(需允许未知来源) |
| iOS | 设置→智能节点→自动跳转 OFF | 设置→帮助→导出日志(需Mac+Finder) | TestFlight 上限90天,超时需卸载重装 |
常见分支场景与取舍
场景A:同一节点上午正常、下午105
原因多为运营商晚高峰QoS。可打开“节点医生-时段质量”视图,若丢包曲线在本地18:00陡增,建议把该节点设为“低优先级”,让客户端自动避开。
场景B:企业控制台批量分配节点,员工大量105
管理员在后台把“香港CN2-GIA”设成默认,但出口防火墙未放行QLink 2.3。解决:控制台→策略模板→协议白名单→勾选“WireGuard+TCP 443”,推送后全员生效。
场景C:游戏加速要求固定IP,但固定IP节点频繁105
此时不建议再开AI自动迁移,可手动锁定“日本东京-游戏专线”并在设置里把“超时阈值”从默认3 s提到8 s,牺牲一点Failover灵敏度换取稳定性。
验证与观测方法
- 复现前先清空日志,确保无旧数据干扰。
- 打开“实时浮窗”(Windows: Ctrl+Shift+Q;macOS: Cmd+Shift+Q),观察握手阶段RTT。
- 若RTT<50 ms却立即出现105,可排除本地带宽问题,重点怀疑节点策略。
- 切换协议后连续ping 1.1.1.1 100次,若丢包>3%则继续降级到TCP 443。
- 每次变更仅改一项,记录ql_diag.db里的error_tag,方便对照。
不适用场景清单
- 本地物理网络已断(网卡打叉)→应先检查路由/网卡驱动。
- 机场订阅已过期→客户端会收到403而非105,需续费。
- 公司出口防火墙做深度包检测(DPI)并随机注入RST→此时105随机出现,解决需走TLS隧道或申请白名单,而非简单换节点。
FAQ(FAQPage Schema)
105错误会一直重试吗?
v11.2默认同节点重试2次,若仍RST则标记“节点拒绝”并自动切换;关闭“自动迁移”后仅弹窗提示,不再动作。
切到TCP 443后延迟变高是否正常?
TCP三次握手+TLS多一个RTT,经验性观察延迟增加约10–20 ms属正常范围;若>50 ms建议切回UDP并换节点。
节点医生误判怎么办?
设置→诊断→关闭“自动迁移”,手动选节点;同时点击“上报误判”,官方会在下一个列表更新剔除异常IP。
总结与下一步行动
快连105错误并非无解,但需要“先日志、后节点、再协议”的严谨顺序。只要你在v11.2里善用AI节点医生,配合时段质量视图,就能把90%的拒绝事件消弭在自动切换阶段;剩下10%再人工降级协议,基本可保证业务不中断。
下一步建议:今晚就打开日志目录,搜索一次“code=105”,按本文表格记录现象与切换结果;一周后导出ql_diag.db做对比,你会得到一份专属于自己的“节点黑名单”,日后换机或给同事部署都能直接导入,省时又省心。
