连接超时到底在“超时”什么
在快连kuailian的语境里，“连接超时”并不是笼统的“上不去”，而是客户端在预设握手时段（TCP 10s、UDP 8s、ShadowTLS 12s）内未完成密钥交换，系统主动中断并回抛Error 5601。弄清这一点，才能把“一直转圈”拆成可观测的指标：DNS解析→节点握手→协议协商→数据通道→应用分流。下文所有步骤都围绕这五段展开，先判断卡在哪一跳，再谈怎么修。
排查总览：一张决策树先跑通
经验性观察：90%的“超时”集中在①本地网络闪断②节点被QoS③协议特征被识别④分流规则死循环。给决策树排优先级，是为了避免一上来就卸载重装：
- 先看客户端右上角小圆点颜色：绿色=已握手；灰色=握手进行；红色=握手失败——颜色即结论。
- 点灰色圆点→弹出「节点测速」→若RTT>600ms或丢包>5%，直接换节点，不必往下。
- 若测速正常仍红色，进入「设置-实验室-一键测速+自动换线」开开关，观察30s能否自切。
- 开关无效→切协议：ShadowTLS→WireGuard→量子隧道2.0，每切一次清一次缓存。
- 协议轮询仍失败→检查本地防火墙与杀毒，把kuailian.exe加入白名单并重启网卡。
提示：决策树每一步都可在Windows、macOS、Android、iOS四端复现，路径差异在下一节给出。
平台差异：最短操作入口对照
Windows & macOS（桌面端）
主界面右上角「节点」→「节点测速」→等待结果列表→点击延迟数字即可触发换线；协议切换在「设置-连接-传输协议」下拉框，保存后需手动断开重连。
Android
底栏「节点」→右上角「闪电」图标→一键测速；协议切换在「我的-设置-连接协议」。若遇后台被杀，长按应用图标→「应用信息」→「电池」→无限制。
iOS
「节点」页下拉即可测速；协议切换在「设置-高级-传输协议」。若开启「量子隧道2.0」后Safari白屏，把DNS改为「自定义-8.8.8.8」即可，属于iOS 20.3已知兼容问题。
日志不会骗人：三分钟抓关键行
客户端日志默认只保留最近一次握手，路径如下（以当前最新版本为例）：
- Windows：
安装目录\logs\kuailian_latest.log - macOS：
~/Library/Logs/kuailian/kuailian_latest.log - Android：
/sdcard/Android/data/com.kuailian.privacy tool/files/logs/kuailian_latest.log - iOS：系统沙盒不可直接读取，需在「设置-帮助-导出日志」通过AirDrop发送。
用文本编辑器打开后，按时间倒序搜关键词handshake_timeout或RST，前面紧跟的IP就是问题节点。把该IP复制到「节点」页右上角搜索框，可一键屏蔽，下次就不会再命中。
节点、端口与QoS：如何挑一条干净的线路
经验性观察：晚高峰（20:00–23:00）国际出口QoS最明显，ShadowTLS 1.4的443端口在部分省际骨干仍会被随机丢包。若日志显示TCP RST after ClientHello，可尝试：
- 把端口从443改成943或8080，这三组端口在官方节点池里已做备案，延迟差异<20ms。
- 手动选择“游戏专线”标签节点，虽然地理距离更远，但走AS9929/AS10099精品骨干，丢包率可降到1%以内。
- 若需长期稳定，把「AI预测切换」打开，系统会在后台提前30s把隧道切到备用节点，用户侧0次握手中断。
协议切换的取舍：ShadowTLS vs WireGuard vs 量子隧道2.0
| 协议 | 抗识别 | 吞吐峰值 | 握手时间 | 适用场景 |
|---|---|---|---|---|
| ShadowTLS 1.4 | 最强 | 中 | 1–2s | 默认、出国流媒体 |
| WireGuard | 中 | 高 | <1s | 内网远程桌面、大文件上传 |
| 量子隧道2.0 | 高 | 中高 | 1s | 游戏、直播低延迟 |
警告：WireGuard虽然快，但特征明显；在高校、企业内网环境常被端口限速或丢包，此时应回退到ShadowTLS。
防火墙与杀毒：本地被拦的四大特征
若日志停在sendmmsg: Permission denied或TUN Error 127，99%是本地拦截。按出现频率排序：
- Windows Defender 把TAP-Windows9驱动当“未签名设备”——卸载旧驱动，重启后让安装包自动装9.26.2。
- 360“网络防火墙”默认阻断未知UDP端口——在「防护中心-网络防火墙-添加信任」把kuailian.exe放通。
- macOS 自带防火墙开启“ stealth mode”会丢弃ICMP——系统设置-网络-防火墙-选项，取消“启用隐身模式”。
- 小米手机“电池与性能”限制后台联网——关闭“智能限制”，并把kuailian锁定在任务卡片。
Split-App 隧道踩坑：规则死循环导致“国内也走代理”
AI分流引擎默认每周云端更新规则库，但企业微信、钉钉的CDN段经常变动。经验性观察：若你发现公司内网OA打不开，而日志里却出现bypass route missing，大概率是被误判成海外流量。解决路径：
- 进入「设置-分流规则-应用路由」→搜企业微信→勾选“强制直连”→保存。
- 若仍异常，把「规则生效顺序」改为“自定义优先”，确保手动规则高于云端。
- 临时排障可把「分流模式」切到「全局」再秒切回「智能」，强制刷新路由表。
验证与观测：三个可复现指标
修好后，如何判断“真的好了”？给出三个可量化指标，测30秒即可：
- 客户端首页RTT：连续三次<300ms且抖动<30ms。
- 日志不再出现
handshake_timeout，而是data tunnel ready。 - 打开Speedtest跑一条海外节点，下载速度达到带宽80%以上，丢包0%。
不适用场景清单：以下情况别硬排
- 公司出口硬件审计设备已做TLS指纹白名单——此时任何加密代理都会被RST，需向IT申请白名单。
- 校园网802.1X认证+Web Portal——Portal未登录前UDP全封，必须先完成网页认证再启动快连。
- iOS 20.3 beta版——系统级网络扩展API存在回归，苹果已确认，回退正式版即可。
最佳实践速查表
| 场景 | 第一步 | 第二步 | 第三步 |
|---|---|---|---|
| 海外流媒体缓冲 | 切ShadowTLS+443 | 选“影视专线”节点 | DNS改为智能模式 |
| 游戏延迟高 | 开量子隧道2.0 | 选手游标签节点 | 关闭Split-App |
| 公司邮件被分流 | 应用路由强制直连 | 自定义优先 | 重启邮件客户端 |
FAQ：用户最常问的五句话
为什么节点测速正常却看不了Netflix？
测速只验证ICMP，Netflix还会校验IP归属。切到带“影视专线”标签的节点，或把DNS改成“智能-影视”即可。
量子隧道2.0会更耗电吗？
经验性观察：连续游戏1小时，电量多耗约3%，与屏幕刷新率提升相当；可接受。
Mac升级后提示kext签名失效怎么办？
系统设置-隐私与安全-允许“Shandong QuickConnect”扩展，重启即可。
iOS美区下架会影响已装用户吗？
已激活的TestFlight或已购用户可继续更新；新用户需切到港区或官网描述文件安装。
AI分流会不会泄露国内流量日志？
分流判断在本地完成，匹配库SHA256哈希校验；云端只推送规则，不回收流量指纹。
收尾：把排查拆成习惯，而不是救火
快连kuailian连接超时并非玄学，只要按“颜色→测速→日志→协议→防火墙”五步走，10分钟就能定位90%问题。把本文的「最佳实践速查表」截图存在手机，遇到异常先查表，再决定要不要重装。下次晚高峰卡顿，不必慌张，打开节点测速，点一下“闪电”图标，让数据而不是感觉告诉你该切哪条线。
如果你还遇到树外10%的幽灵案例，把日志导出附带时间戳提交给官网工单，通常30分钟内会收到节点运维的BGP级别回复。网络环境瞬息万变，保持客户端为“截至当前的最新版本”，才是最长效的“修复”。
