快连kuailian如何导入自定义分流规则文件？
kuailian自定义分流规则文件导入全攻略，含合规审计、平台差异、回退与例外场景。
功能定位：为什么需要“自定义分流规则文件”
在快连（Kuailian privacy tool）里，Split-App 隧道只能把“哪些应用走代理”这件事做到进程级；一旦企业或团队想按域名、IP 段、甚至 URL 关键字做更细颗粒度的审计与分流，就必须把外部规则文件一次性导入。导入后，客户端在本地生成一份只读缓存，任何匹配动作都会先写进内存日志，再定期滚动到加密沙盒，方便后续导出给合规部门留痕。
经验性观察：规则文件大于 2 MB 时，首次编译缓存大约需要数十秒（视机型而异），之后切换节点不会再重复编译；因此建议把“常用固定规则”与“临时实验规则”拆成两个文件，先导入固定、后追加临时，降低回退成本。
文件格式与命名约束
1. 基础语法
快连目前兼容 Clash-like YAML 与 Surge-compatible Rule-set（DOMAIN-SET、IP-CIDR、USER-AGENT）。如果你从第三方仓库下载，通常后缀是 .yaml 或 .list；官方对文件名无强制要求，但路径中不能出现空格与中文，否则 Android 端会提示“非法文件名字符”。
2. 合规字段
为了审计可追溯，建议在文件头部加两行注释：# Generator=YourTeamName 与 # Version=20260324。客户端导入时会把这两行写进日志索引，方便后期 grep。
平台差异与最短入口
Android（以当前最新版为例）
- 打开侧边栏 → 设置 → 分流管理 → 右上角“⋮” → 导入规则文件
- 系统文件选择器会默认定位到
Download/目录；选中文件后，底部出现“校验中…”进度条，0–100% 完成后自动弹出“导入成功”。 - 若校验失败，日志提示“Rule parse error at line N”，点“查看详情”可直接跳转到出错行；修改后重新导入即可，旧版缓存会被自动覆盖。
iOS / iPadOS
由于沙盒限制，必须先点“共享到快连”或存入“文件”App 的“快连”子目录，再进入 设置 → 分流管理 → 导入 → 从“我的 iPhone”选取。iOS 端不支持通配符 *.list 多选，只能单文件导入；如需批量，请提前合并。
Windows / macOS
桌面端提供“拖拽”入口：把规则文件直接拖进客户端主窗口，会弹出“确认导入”浮层；若文件编码非 UTF-8，将提示“转换失败”。桌面端还隐藏了命令行通道（安装目录下 kuailian-cli rule import <path>），适合管理员批量推送。
回退与版本管理
每导入一次，客户端会在本地备份旧缓存，命名为 rules.backup.timestamp。若新规则导致内网无法访问，可在 分流管理 → 右上角“⋮” → 回退到上一版本，无需重新下载文件。经验性观察：回退操作会立即触发内存重载，已建立的 TCP 长连接不会断开，但新连接按旧规则重新匹配，因此切换瞬间可能出现 1–2 个请求 404，属于预期行为。
例外与取舍：哪些场景不该用自定义文件
- 仅需要“国内直连、海外代理”的二元策略：直接用 Split-App 隧道即可，额外文件反而增加 200–300 ms 的匹配开销。
- 节点经常变动且规则依赖 IP 段：IP 段一旦过期，需要频繁更新文件；此时建议使用官方“AI 智能选线 3.0”自带的动态分流，而非静态文件。
- 合规要求“必须留痕到外部 SIEM”：客户端日志是加密沙盒，无法直接对接 Splunk；需要额外写脚本导出，维护成本高。
与第三方机器人协同的最小权限原则
部分团队用 Telegram 频道做规则推送，配合“第三方归档机器人”自动把最新 .yaml 丢到群文件。为降低风险，应给机器人仅“上传”权限，不给删除或管理权限；同时在文件头部加 # SHA256=xxxx 注释，客户端导入前会校验，防止中间人篡改。
故障排查：导入失败常见现象
| 现象 | 最可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| “非法文件名字符” | 路径含中文或空格 | 把文件复制到 /sdcard/Download/ 重试 |
改名后重新导入 |
| “Rule parse error” | YAML 缩进错误 | 用 VS Code 开 YAML 插件看红色波浪线 | 修正缩进再导入 |
| 导入后无网络 | 规则把网关 IP 也代理了 | 关闭代理后看本地网关是否通 | 在文件最前加 IP-CIDR,192.168.0.0/16,DIRECT |
最佳实践 6 条
- 规则文件拆三层：基础直连、国内 CDN、海外代理，逐层 include，方便回退。
- 每次变更先在测试机导入，用
curl -x验证域名是否走到预期出口，再推到全员。 - 在文件头写注释生成者与版本，方便审计 grep。
- 桌面端用
kuailian-cli批量导入前，先--dry-run做语法检查。 - 导入后 24 h 内观察“分流日志”是否有大量 UNKNOWN，及时调整。
- 对金融、政务类 App 单独写一条 PROCESS-NAME 直连，避免跳 IP 触发风控。
FAQ（使用 FAQPage Schema）
导入后想完全清空规则怎么做？
在 分流管理 → 右上角“⋮” → 重置为默认规则，即可一次性清空所有自定义文件并恢复官方默认，操作会生成一条审计日志。
规则文件能否加密传输？
客户端只接受明文 YAML/list；如需加密，请在外层用加密网盘或加密封装通道分发，落地到本地后再导入。
iOS 端导入失败却没有任何提示？
大概率是文件未放入“快连”专属目录，系统弹窗被屏蔽；请用“文件”App 确认路径，并重新点“共享到快连”。
总结与下一步行动
快连的自定义分流规则文件导入，本质上是把“进程级”隧道能力扩展到“域名/IP/关键字”级，并附带本地加密日志，方便合规审计。只要遵循“先测试、后全员”“文件头留版本”“例外最小化”三条原则，就能在性能、安全、审计之间取得平衡。
下一步建议你：①把现有 Split-App 策略导出为模板，②在此基础上追加公司内网网段与 SaaS 域名，③用 kuailian-cli --dry-run 做语法校验，④选一台测试机跑 24 h 无异常后再全员推送。这样，你就能在不触碰任何敏感配置的前提下，完成一次可审计、可回退、可观测的分流升级。
