快连导入自定义代理规则后连接失败如何排查？
快连导入自定义代理规则后连接失败，按日志→规则→节点三步排查，十分钟定位问题。
功能定位：自定义规则到底管什么
在快连里，自定义代理规则（Split Tunneling 3.0）允许用户按域名、IP 段、进程名三维度决定“哪些流量走隧道、哪些直连”。它解决的是“精细分流”而非“全局翻墙”——一旦规则写错，常表现为部分网站打不开、应用提示无网、连接图标亮但数据不动。理解这一点，就能把“连接失败”缩小到“规则冲突”而非整网崩溃。
变更脉络：v6.4.2 之后为何更容易踩坑
截至当前最新版，规则匹配引擎已换成前缀树+进程指纹，解析更快，却要求每条规则用英文逗号结尾，且不支持行尾注释。老版本遗留下来的“# 注释”会被当成域名，于是瞬间匹配失败，日志里出现unreachable domain:#netflix这类诡异条目。升级后第一次导入旧文件，90 % 的连接失败都源于此。
连接失败现象速查表
| 现象 | 最可能根因 | 验证动作 |
|---|---|---|
| privacy tool 图标亮，但网页白板 | 规则把 DNS 也分流到隧道，但隧道 DNS 未响应 | 关闭“私有 DNS”再刷新 |
| 仅微信能发消息，浏览器全挂 | 进程规则把浏览器排除在隧道外，却未给浏览器配直连出口 | 临时切全局模式，恢复即证伪 |
| 导入瞬间提示“规则无效” | 文件含中文全角符号或 BOM 头 | 用 VS Code 转 UTF-8 无 BOM |
排查路径：日志→规则→节点三步法
1. 拉日志：30 秒定位红色关键词
Android / iOS：主界面右上角「⋯」→ 诊断 → 导出日志，过滤“ERR”。桌面端：系统托盘右键 → 诊断 → 一键打包。出现rule match fail或dns hijack即说明规则已生效但匹配对象不存在。
2. 验规则：用“分段二分法”回滚
把 500 行规则拆成两半，先导入前 250 行，观察是否恢复。若正常，问题在后 250 行；若仍失败，继续对半砍。经验性观察：通常十行内就能锁定写错的正则或缺少逗号。
3. 测节点：排除“规则背锅”假象
切到“全局模式”若能秒开，说明节点健康，可 100 % 确认是规则导致；若全局也超时，优先换节点或检查本地防火墙。
平台差异：最短入口与回退按钮
- Android 16：首页 → 分流设置 → 自定义规则 → 右上角“导入” → 失败提示框内“一键回退到上次生效配置”。
- iOS 18：设置 → Split Tunneling → Import Rules → 若解析失败自动弹出“Revert”。
- Windows 12：主界面左侧“分流” → 编辑 → 文件 → 加载 → 右下角“Restore Default”。
提示：回退按钮只在导入后 30 分钟内可见，重启客户端即消失，请第一时间点按。
常见规则错误与修正样板
| 错误写法 | 后果 | 修正后 |
|---|---|---|
| *.example.com #代理 | 整行被当域名，匹配失败 | *.example.com, |
| 192.168.0.0/16, 直连 | 中文“直连”被识别为域名 | 192.168.0.0/16, |
| PROCESS,com.chrome.beta | 缺少动作关键字 | PROCESS,com.chrome.beta,PROXY |
何时不该用自定义规则
公司笔记本装有 MDM（移动设备管理），进程名随时被随机化，规则会瞬间失效；网络环境为“强制门户认证”机场 Wi-Fi，首次认证需本地 IP，若把 Portal 域名误分流会导致无法弹出认证页；需要审计留痕：规则分流后，部分流量未经隧道，无法计入“零日志”审计范围，合规团队或要求全程走隧道。
与第三方规则仓库协同的最小权限原则
快连官方维护的 ACL4SSR 每周同步，但 GitHub 上也有第三方精简规则。导入前务必：
- fork 到自己仓库，开启 GitHub Action 定时扫描域名存活，避免死域拖慢匹配。
- 删除
PROCESS段，防止泄露本机软件清单。 - 用
grep -E过滤.*cn$,.*aliyun$等国内域名，减少不必要的绕行。
警告：直接拉取他人订阅链接相当于授予对方“随时改写分流策略”的权限，一旦作者误把0.0.0.0/0写进规则，你的所有流量会被强制代理，可能触发网银风控。
验证与观测方法：用 curl 看是否走到隧道
Windows PowerShell 执行：
curl -I https://ipinfo.io # 若返回的 IP 与快连节点一致，说明已走隧道；若仍显示本地宽带，即规则未命中。
Android 可用 Termux，iOS 可用 iSH，同理。经验性观察：首次导入规则后，缓存需 10–15 秒重新加载，连续 curl 三次才能稳定。
最佳实践 12 条检查表
- 文件保存为 UTF-8 无 BOM，Windows 记事本另存时选“UTF-8”。
- 每行以英文逗号结束，末行留空。
- 注释另起新行，行首用 #。
- 先写白名单（直连），再写黑名单（代理），匹配顺序自上而下。
- PROCESS 行务必大写，包名用英文逗号分隔，不含空格。
- 导入前在“规则检查”里跑语法扫描，零报错再保存。
- 重大会议 / 网银场景前，提前 24 小时锁定规则并截图留档。
- 每月第一周复查 GitHub 源，删除 30 天未解析的域名。
- 打开“节点漂移通知”，当 IP 变化>2 国即弹窗，防止 AI 模式切到高风险区。
- 把公司内网 DNS 写在规则最前，防止隧道 DNS 覆盖导致内网失联。
- EdgePoint 共享上传限速 10 Mbps，避免流量超标被运营商降速。
- 规则变更后导出备份存 iCloud / OneDrive，文件名带日期，回退不求人。
FAQ：必须用 Schema.org 格式
导入规则后 Netflix 打不开，其他站正常？
检查是否把 netflix.com 误写到直连段；流媒体需走隧道。把规则里 *.netflix.com,*.nflxvideo.net,*.nflxext.com 全部设为 PROXY 并置顶即可。
规则文件过大导致客户端卡顿？
超过 2 万行时匹配性能下降明显。建议按使用场景拆成“工作.conf”“娱乐.conf”，用快捷指令切换，减少一次性加载。
如何确认规则已实时生效？
在分流设置页底部有“命中计数器”，每匹配一次+1；访问测试站后数字增加即生效。若无变化，说明写法或顺序有误。
总结与下一步行动
快连导入自定义代理规则后连接失败，九成以上是语法或顺序问题。先拉日志找红色关键词，再用二分法回滚规则，最后切全局验证节点，十分钟即可定位。下次导入前，跑一遍官方语法扫描，按本文 12 条检查表存档备份，就能把“失败”变成“秒开”。现在就打开客户端，把旧规则拖进 VS Code，删掉行尾中文注释，重新保存 UTF-8 无 BOM，再导入验证——你的下一次流媒体追剧或跨国会议，值得一次零失败的网络体验。
