快连iOS端如何导入自定义规则实现分流代理？

功能定位：为什么要在 iOS 端“自定义规则”

在快连（QuickLink）里，“自定义规则”是智能分流的下一级开关：当 AI 分流 2.0 的默认黑白名单覆盖不到你的小众需求——例如公司测试域名、海外 CDN 边缘节点或局域网 NAS——就需要手动写规则，让指定流量直连或走隧道。iOS 因系统沙盒限制，规则文件必须一次性导入，无法像桌面端那样热加载，所以“版本差异→导入步骤→回退方案”就成了核心主线。

版本演进：v5.7→v5.8→v5.8.3 的规则模块差异

截至当前的最新版本（TestFlight 5.8.3，2026-02-27），规则管理入口从「设置-高级-分流规则」迁移到「设置-智能分流-自定义规则」；同时废弃了旧版 DOMAIN-SUFFIX 单条输入框，改为整文件覆盖。老用户若仍停留在 5.7 以下，会看到“规则文件不兼容”提示，需先导出旧规则→手动合并→再导入。

兼容性速览表

前置准备：拿到合规规则文件

规则文件本质是一份 YAML，支持 DOMAIN、DOMAIN-SUFFIX、IP-CIDR、GEOIP、USER-AGENT 五类关键词。官方文档给出的最小可运行模板只有 12 行，你可以直接复制到「文本编辑」App，保存为 quicklink-rules.yaml。

经验性观察：若你同时打开「AI 智能分流」与「自定义规则」，后者优先级更高；但 GEOIP 库版本若与云端不一致，可能出现“大陆 IP 被误判”的情况。验证办法：把 ip138.com 设为直连，观察返回 IP 是否与你本地宽带一致。

操作路径：iOS 端最短导入步骤

1. 把写好的 quicklink-rules.yaml 通过 AirDrop 或 iCloud 云盘放进「文件」App 的「On My iPhone/快连」文件夹；若该目录不存在，先打开一次快连→设置→智能分流→自定义规则，系统会自动创建。
2. 回到快连，依次进入「设置」→「智能分流」→「自定义规则」→右上角「+」→「从文件导入」。
3. 选中 quicklink-rules.yaml，弹窗会显示“共 12 条规则，预计覆盖 5 个域名”。点「确认」后客户端自动重启隧道。
4. 重启完成后，下拉首页日志区，看到 Custom rules loaded 即代表成功。

提示：如果「+」按钮灰色不可点，99% 是因为你未给快连开启「文件与文件夹」权限。解决办法：iOS 设置→隐私与安全→文件与文件夹→快连→开启。

失败分支与回退

若导入后立刻提示“规则格式错误”，常见原因是 YAML 缩进混用了 Tab。把文件发到电脑，用 VS Code 把缩进统一改成 2 空格即可。若你已经导致无法联网，可长按快连首页「连接」按钮 5 秒→弹出「安全模式」→系统会临时用内置规则，允许你再次进入设置页删除错误文件。

进阶写法：分应用 & 分端口

iOS 不允许 App 读取 Bundle ID 做分流，但快连通过「本地 privacy tool 扩展」拿到了进程名哈希，于是规则里可以用 PROCESS-NAME 字段。示例：把企业微信文件传输直连，减少大文件走隧道的流量。

端口分流则使用 DST-PORT，适合游戏场景：把 UDP 7001-7999 设为直连，降低《原神》亚服延迟。注意 DST-PORT 只能写在 UDP 规则段，且需要打开「混合协议」开关，否则会被 TCP 规则覆盖。

与桌面端协同：同一账号多设备同步

快连官方并未提供云端规则同步，但你可以把 YAML 放在私有 GitHub 仓库，用 iOS「快捷指令」+「获取内容」动作，实现每天凌晨自动拉取更新。步骤：在快捷指令里添加「URL」→「获取内容」→「保存到文件」→覆盖路径选择快连目录；随后在快连「自定义规则」页打开「启动时自动重载本地文件」即可。经验性观察：若仓库大于 500 KB，拉取过程可能耗时数十秒，建议在 Wi-Fi 下执行。

验证与观测：确认规则生效

1. 在「设置-日志级别」切到 Debug，重新连接。2. 打开 Safari 访问 example.com，在日志里应出现 /example.com match custom rule: PROXY。3. 若发现未命中，检查大小写与缩进；YAML 对大小写敏感，而 DOMAIN-SUFFIX 会自动忽略大小写。

风险控制：何时不该用自定义规则

• 公司 MDM 设备：若你的 iPhone 装有企业描述文件，快连的 privacy tool 扩展可能被全局强制路由，自定义规则会与 MDM 路由表冲突，导致内网地址无法解析。
• 银行类 App：部分银行会检测代理环境，自定义规则即使写了 DIRECT，也可能因“中间人证书”被风控。解决：在规则最上方插入银行域名，并关闭「HTTPS 解密」。
• 低电量模式：iOS 低电量模式下，网络扩展常驻内存会被系统回收，规则重载可能失败，出现“国内网站也走隧道”的错觉。建议在电量低于 20% 时切回系统默认分流。

适用/不适用场景清单

故障排查 5 步法

1. 现象：导入后无法连接。验证：看日志是否提示 yaml: line 9, found character '\t'。处置：把 Tab 替换为 2 空格。
2. 现象：国内站点打开慢。验证：在 Debug 日志里搜索 CN IP 是否被 GEOIP,CN 覆盖。处置：把 GEOIP 库更新到最新，或手动写 IP-CIDR。
3. 现象：规则条数超限。验证：日志提示 too many rules, truncated 10000。处置：拆分成主规则+游戏专用规则，按需切换。
4. 现象：TestFlight 版闪退。验证：系统日志出现 Jetsam Event。处置：卸载重装正式版，等 3 月底热修。
5. 现象：iCloud 文件不显示。验证：文件 App 里目录为空。处置：重启「文件」App，或把文件改放本地再移动。

最佳实践 6 条

1. 规则文件先用在线 YAML 校验工具过一遍，再上机。
2. 把 MATCH 放在最后，防止前面的规则漏写导致全部直连。
3. 给每条规则写注释，方便三个月后自己还能看懂。
4. 重大改动前，用「快捷指令」备份旧文件到 iCloud。
5. 每月检查一次 GEOIP 库版本，官方更新后及时同步。
6. 团队共享时，用 Git Tag 标记版本，回滚只需切换 Tag。

FAQ（使用 FAQPage Schema）

收尾：下一步行动清单

读完本文，你只需做三件事：1. 在电脑端把需要的域名整理成 YAML，用在线工具校验通过；2. 通过 AirDrop 扔进 iOS「文件」App；3. 打开快连→设置→智能分流→自定义规则→导入，确认日志出现 Custom rules loaded。此后每遇到“国内打不开、海外绕路”的个案，回到 YAML 里加一行，重启隧道即可。自定义规则不是越多越好，而是“刚好够用”——保持 100 行以内，既易维护，也不会触发系统内存回收。祝你分流顺畅。