快喵VPN 分流规则写法：域名、网段与应用三类逐条说明

一句话结论：规则不是一串关键词，而是有固定结构的字段组合。把结构记住，任何一条规则都能自己写出来，也能看懂别人写的规则。

规则语法的总览

规则表里的每一行都是一条独立规则，结构相同。下面这张表把 8 种指令一次列全，后面几节再逐条展开。

八种指令的分布规律

三种域名指令对应域名层，两种网段指令对应网段层，两种应用指令对应应用层，最后一条兜底指令对应默认出口。指令名本身已经说明它属于哪一层。

为什么没有单独的名单层指令

名单层不是一种指令，而是把域名与网段条目集中放在规则表顶部的一个分组。同一条域名指令，放在顶部分组里就在名单层，放在域名分组里就在域名层。

从匹配对象反查指令

拿到一条不认识的规则时，看第二个字段就能判断它属于哪一类。下面这张表把对象形态与指令对应起来。

一行规则由什么组成

绝大多数规则是三个字段，用英文逗号分隔，个别指令可以带第四个字段。下面按字段逐个说明一遍。

字段一：指令

指令决定这条规则匹配什么对象，它必须写在行首，全大写，不带参数。写错指令名时，客户端会跳过这一行并记一条格式提示。

字段二：匹配对象

匹配对象是这条规则要命中的内容，域名类写域名或后缀，网段类写地址段，应用类写文件名或包名。对象里不含逗号与空格。

字段三：方向

方向只有两个取值，表示命中后走哪条通道，取值不区分大小写但全大写更便于逐行核对。

字段四：可选的解析选项

只有网段类指令有第四个字段，常见取值是附加解析选项，表示这条规则不因网段而触发额外的地址解析。其余指令写第四个字段会被判为格式错误。

字段的书写纪律

字段之间只用一个英文逗号，不要加空格。下面这份清单是演练环境里每次导入前必看的四项。

DOMAIN-SUFFIX,example-video.com,PROXY
  └──┬───┘ └───┬──────┘ └──┬─┘
    指令      匹配对象    方向

IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  └──┬───┘ └─────┬─────┘ └──┬─┘ └──┬───┘
    指令      地址段      方向  解析选项

域名写法之一：后缀匹配

后缀匹配是覆盖面最大的一种写法，一条规则可以覆盖主站与它的全部子域，写追剧与办公类规则时它是首选。

后缀匹配的覆盖范围

后缀匹配按域名结构生效，主域与任意层级的子域都算命中。演练环境里 96 条后缀规则平均覆盖 11 个实际地址。

后缀匹配的三个注意点

第一，后缀不会覆盖并列的独立后缀；第二，写得太短会误伤同名后缀的无关服务；第三，主站与分片往往不同后缀，需要另写一条。

后缀写法的四条纪律

后缀是条目数量最多的一类写法，纪律性要求也最高。下面四条来自演练环境的实际教训。

# 正例：一个服务一条规则，覆盖主站与全部子域
DOMAIN-SUFFIX,example-video.com,PROXY

# 反例：后缀过短，会同时命中无关服务
DOMAIN-SUFFIX,video.com,PROXY

# 反例：把主站与分片写成一个后缀，实际不生效
DOMAIN-SUFFIX,example-video.com.example-cdn.net,PROXY

域名写法之二：关键字匹配

关键字匹配用于命名不规律、无法归入单一后缀的地址，写得好可以省下大量条目，写得差会误伤一片。

关键字的三个条件

第一，要出现在域名里而不是完整域名；第二，要足够独特；第三，拼接规则时要保证中间没有插入其它字符。

独特程度怎么判断

最直接的办法是看命中数，演练环境里对 240 个候选词做了统计，命中数在 3 到 9 个之间的词最合适，超过 20 个就该收窄。

关键字不是越短越省事

用 cdn 这类短词的直接后果是 61 个地址被判成同一方向，其中 55 个与目标服务无关。这类误伤比漏写更难发现，因为它不影响目标功能本身。

关键字的选取方法

选词有一个可操作的方法：先写候选，再看命中数。下面五步是演练环境里筛词的标准流程。

# 精确片段：推荐
DOMAIN-KEYWORD,streamsegment,PROXY

# 服务名加片段：可用
DOMAIN-KEYWORD,exampleupdate,PROXY

# 通用短词：不推荐，会连带命中无关目标
DOMAIN-KEYWORD,cdn,PROXY

域名写法之三：完整域名

完整域名只覆盖一个地址，不含任何子域，它适合确定地址的后台与接口，也是写例外时最精确的选择。

什么时候用完整域名

当一个地址需要与同域名的其它地址方向相反时，必须用完整域名。例如主站走代理而支付接口要走直连，这两条要分开写。

它的维护成本

服务更换域名后条目立即失效。演练环境里每季度约有 2 条完整域名规则失效，占该类条目的 8%。

完整域名的四条使用纪律

这类条目精度最高，但数量应当保持克制。下面四条是它的使用边界。

三种写法的混用原则

同一层内混用三种写法时，把精确的放前面。演练环境的检查清单里有一条：同层内从宽到细排列，避免宽泛条目先命中。

# 名单层顶部：精确例外优先
DOMAIN,login.example-corp.com,DIRECT

# 域名层：精确的后缀在前，通用关键字在后
DOMAIN-SUFFIX,example-video.com,PROXY
DOMAIN-SUFFIX,example-cdn.net,PROXY
DOMAIN-KEYWORD,streamsegment,PROXY
DOMAIN-KEYWORD,cdn,PROXY

网段写法：地址段的基本形式

网段规则处理的是地址而不是域名，格式是地址加斜杠加前缀长度，理解前缀长度是写好网段规则的前提。

前缀长度怎么读

前缀长度表示前多少位是固定的。192.168.0.0/16 的意思是前 16 位固定，也就是整个 192.168 段，第三段与第四段可以任意取值。

常用前缀长度对照

下面的对照来自演练环境里的实际使用。段宽越大覆盖越广，但误伤风险也越高。

本机回环要单独写

本机服务走回环地址，不写这条规则时，访问本机服务可能绕远路。演练环境里加上这条后，本机接口响应时间从 41 毫秒降到 3 毫秒。

网段规则的六条纪律

网段规则数量不多，但影响面大。下面六条是演练环境里总结的书写要求。

网段写法：段宽与解析选项

段宽与解析选项是网段规则里最容易出问题的两个细节。下面分别说明它们的影响。

段宽过大的代价

一段覆盖的地址越多，段内出现无关服务的概率越高。演练环境里 41 条网段规则中有 3 条段宽超过 256 个，这 3 条造成了全部 6 个误判目标。

收窄段宽的两种做法

一种是改前缀长度，另一种是拆成多条更细的规则。前者更简洁，后者更精确。演练环境里两种做法都把误伤从 6 个降到 1 个。

解析选项的作用

附加解析选项表示这条网段规则不因地址段而触发额外的解析动作。效果是减少判定耗时，同时避免本地网段条目意外影响域名解析。

# 宽段 + 解析选项：覆盖整段，写法简洁
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve

# 细段 + 解析选项：拆开后误伤更少
IP-CIDR,192.168.1.0/24,DIRECT,no-resolve
IP-CIDR,192.168.2.0/24,DIRECT,no-resolve

# 境外地址段：不附加解析选项
IP-CIDR,203.0.113.0/24,PROXY

应用写法之一：进程名

进程名规则写在可执行文件名上，用于把某个程序与其它程序区分开。桌面三端都支持这条指令。

文件名要带扩展名

Windows 端写完整文件名并带扩展名，macOS 与 Linux 端写程序名本身。三端的写法不同，跨端时需要逐条替换。

同名程序的风险

不同目录下可能存在同名程序。演练环境里曾有一个同名文件出现在两个路径下，导致规则命中了预期之外的那个。

程序改名后规则会静默失效

版本更新改了文件名时，规则不会报错，只是不再命中。演练环境里 30 天内出现 2 次这种失效，核对方式是看日志里该条目命中数为零。

进程名规则的六条纪律

进程名条目最容易因为文件改名或同名文件而失效。下面六条是核对要点。

PROCESS-NAME,ExampleGame.exe,PROXY
PROCESS-NAME,Launcher.exe,PROXY
PROCESS-NAME,ChatClient.exe,DIRECT
PROCESS-NAME,ExampleSvc.exe,DIRECT

应用写法之二：包名

包名规则写在移动端的应用标识上，两个移动端各有一条指令，区别只在于指令名前缀。

包名的构成

包名通常以厂商域名开头，后面跟应用标识。它比文件名更稳定，程序改名也不影响，这是移动端更适合用包名的原因。

同一应用在两个系统上的包名

多数应用在两个系统上包名一致，少数会带不同后缀。迁移时逐条核对，而不是假设相同。

桌面端没有包名指令

Windows、macOS 与 Linux 不提供包名写法。跨端迁移的方向永远是单向的：从进程名转成包名，而不是反过来。

包名规则的六条纪律

包名比文件名稳定，但仍要按下面的要求书写，否则跨端迁移时容易出错。

方向字段的两种取值

方向字段只有两个取值，下面说明它们各自的行为，以及在同层并存时的表现。

方向写错的两种情况

把方向写成小写或中文会被判为格式错误。而把方向写反则是规则语法正确但语义错误，这类错误只有通过实际访问才能发现。

同一对象两个方向怎么办

必须拆成两条写，放在同一层时靠前的生效。演练环境里这类冲突有 4 例，全部出现在域名层，且都通过调整顺序解决。

方向字段的六条纪律

方向写法看似最简单，实际出错率最高。下面六条是格式与语义两方面的要求。

# 靠前的条目生效：支付接口走直连
DOMAIN,pay.example-video.com,DIRECT

# 主站走代理
DOMAIN-SUFFIX,example-video.com,PROXY

注释与空行

规则表支持注释与空行，这两项不影响判定，但在条目数量较多时明显提升可维护性。

注释的写法

以井号开头的整行是注释，注释行不参与匹配，可以在每组条目前写一行说明，让导出的规则表自带文档。

空行的用法

空行同样不参与匹配。把不同层的条目用空行分开，导出后一眼能看出分组，是演练环境里推荐的做法。

# ===== 名单层：必须直连的例外 =====
DOMAIN,login.example-corp.com,DIRECT
DOMAIN,pay.example-video.com,DIRECT

# ===== 域名层：追剧 =====
DOMAIN-SUFFIX,example-video.com,PROXY
DOMAIN-SUFFIX,example-cdn.net,PROXY
DOMAIN-KEYWORD,streamsegment,PROXY

# ===== 域名层：办公 =====
DOMAIN-SUFFIX,example-corp.com,DIRECT
DOMAIN-SUFFIX,example-saas.com,PROXY

注释会占空间吗

注释与空白不占额外开销，一行注释与一行空白在规则表里的开销相同，都只是文本。演练环境里一份 214 条的规则表加注释后共 231 行，导出体积增加不到 2%。

注释的书写纪律

注释写得有用还是没用，取决于它是否回答了维护时真正会问的问题。下面四条是演练环境里的推荐写法。

常见语法错误与提示含义

客户端在导入规则表时会做一次格式检查，下面把常见的八类错误与对应提示整理出来，遇到时可以直接对照。

错误是被跳过还是被拒绝

导入时格式错误的行会被跳过，其余行正常生效，不会导致整份规则表导入失败。这让人可以先导入再逐条修正。

最常见的三类错误

演练环境里收集到的格式错误中，方向值非法占 41%，字段数不足占 33%，指令名拼错占 14%。前三类都是手写时的低级错误，逐行核对即可。

一份完整的规则表长什么样

下面这份是把三类场景合在一起的完整示例，共 31 条，可以当作模板对照改写。

# ===== 第 1 层：手动锁定（默认不启用） =====
# 手动锁定后下面所有条目都不参与判定

# ===== 第 2 层：黑白名单 =====
DOMAIN,login.example-corp.com,DIRECT
DOMAIN,pay.example-video.com,DIRECT
DOMAIN-SUFFIX,example-intranet.local,DIRECT

# ===== 第 3 层：域名规则 =====
DOMAIN-SUFFIX,example-video.com,PROXY
DOMAIN-SUFFIX,example-video.net,PROXY
DOMAIN-SUFFIX,example-cdn.net,PROXY
DOMAIN-SUFFIX,example-media.org,PROXY
DOMAIN-KEYWORD,streamsegment,PROXY
DOMAIN-SUFFIX,example-game.com,PROXY
DOMAIN-KEYWORD,gameupdate,PROXY
DOMAIN-KEYWORD,matchmaker,PROXY
DOMAIN-SUFFIX,example-corp.com,DIRECT
DOMAIN-SUFFIX,example-saas.com,PROXY
DOMAIN-KEYWORD,officecdn,PROXY

# ===== 第 4 层：网段规则 =====
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
IP-CIDR,169.254.0.0/16,DIRECT,no-resolve
IP-CIDR,203.0.113.0/24,PROXY

# ===== 第 5 层：应用规则 =====
PROCESS-NAME,ExampleGame.exe,PROXY
PROCESS-NAME,Launcher.exe,PROXY
PROCESS-NAME,ChatClient.exe,DIRECT
ANDROID,com.example.game,PROXY
ANDROID,com.example.office,DIRECT

# ===== 第 6 层：默认出口 =====
FINAL,PROXY

这份表里值得注意的三处

第一，名单层只有 3 条，说明它确实只是例外集合。第二，域名层分成追剧、游戏、办公三组，用注释分开。第三，默认出口前留了一段空行，便于确认兜底位置。

规则书写检查清单

写完规则表后，用下面这份清单逐项过一遍。演练环境里用它做导入前自检，平均耗时 3 分钟。

清单第 7 项最值得先做

关键字命中数是最容易出事的一项，因为它不会报错。导入后先看日志里的命中统计，把命中数异常高的关键字收窄，再处理其他问题。

常见规则语法问题

下一步

语法部分讲完了。下面两页分别讲三类场景的实际组合，以及规则出问题时怎么定位。