配置 · 配置文档

Rules 规则如何根据请求信息选定流量去向

请求的域名、目标地址、端口或来源进程都能成为分流条件;选好条件后,再指定处理策略并检查解析行为。

  • DOMAIN
  • DOMAIN-SUFFIX
  • IP-CIDR
  • RULE-SET
  • MATCH
章节索引

旧配置的版本边界

这里涉及旧版内核的规则行为,历史限制应结合相应版本理解。现用程序是否支持某项能力,需另查当前项目说明,再决定如何迁移设置。

现用内核的语法请查看 当前配置说明;安装、界面和授权相关操作,应查阅 客户端项目说明。

规则把匹配条件与处理策略连在一起。理解基础分流后,可继续按域名、地址、端口或进程等信息选用具体条件。

txt
# 类型,参数,策略(,no-resolve)
TYPE,ARGUMENT,POLICY(,no-resolve)

no-resolve 用于避免规则主动触发 DNS 查询。GEOIP、IP-CIDR、IP-CIDR6 或 SCRIPT 若不需要立刻将域名转成地址,可追加这一选项。

命中之后如何处理

条件匹配后,处理目标可以是直连、拒绝、指定出站或策略组。

  • DIRECT:依 interface-name 指定的接口直接连接;这里记录的行为不查询系统路由表。
  • REJECT:不再转发命中的数据包。
  • Proxy:使用配置中指定的代理出站发送数据。
  • Proxy Group:把连接交给所选策略组处理。

按请求信息选择条件

各类型读取的信息不同,应先确认想匹配什么,再选择对应写法。

DOMAIN:精确核对域名

DOMAIN,www.example.com,policy 先比对完整的 www.example.com;完全一致便选用 policy。

DOMAIN-SUFFIX:匹配域名尾部

DOMAIN-SUFFIX,example.org,policy 以 example.org 为域名边界,匹配该域或其子域后交给 policy。

因此 www.example.org、foo.bar.example.org 这样的子域,也会选择 policy。

DOMAIN-KEYWORD:查找域名片段

DOMAIN-KEYWORD,example,policy 检查域名内是否含 example 片段,找到后选择 policy。

例如 www.example.com 或 api.example.com 都包含该片段,因而能进入 policy。

GEOIP:按目标地址地区匹配

先取得目标 IP,再依据地区数据库判断其国家代码,以选择处理策略。

解析提示

若请求尚无 IP,这类条件会先进行 DNS 查询;不希望触发查询时,可附加 no-resolve。

GEOIP,CN,policy 表示目标 IP 被识别为 CN 时选择 policy。

IP-CIDR:检查目标地址范围

以目标 IPv4 是否落入指定网段作为匹配条件。

解析提示

对域名请求会先取得 IPv4 地址;若需避免主动查询,使用 no-resolve。

IP-CIDR,127.0.0.0/8,DIRECT 以 127.0.0.0/8 为目标范围,符合时选择 DIRECT。

IP-CIDR6:检查目标地址范围

当目标使用 IPv6 时,以地址是否属于给定网段判断命中。

解析提示

对域名请求会先取得 IPv6 地址;追加 no-resolve 可避免该条件主动发起查询。

IP-CIDR6,2620:0:2d0:200::7/32,policy 把 2620:0:2d0:200::7/32 作为目标地址筛选范围,命中则交给 policy。

SRC-IP-CIDR:检查请求来源

读取来源 IPv4,并检查它是否属于给定地址范围。

SRC-IP-CIDR,192.168.1.201/32,DIRECT 检查来源是否属于 192.168.1.201/32,满足时交给 DIRECT。

SRC-PORT:检查来源端口

此条件关注数据发送一侧的端口。

SRC-PORT,80,policy 检查来源端口是否为 80,再对命中请求选择 policy。

DST-PORT:检查远端端口

此条件关注请求要访问的目标端口。

DST-PORT,80,policy 读取目标端口,数值为 80 的请求使用 policy。

PROCESS-NAME:按进程名称匹配

通过发起请求的程序名称判断是否命中。

环境提示

旧版说明列出的适用环境为 Windows、FreeBSD、Linux 和 macOS;使用时仍须确认现用实现。

PROCESS-NAME,nc,DIRECT 让名为 nc 的来源进程使用 DIRECT。

PROCESS-PATH:按程序所在路径匹配

将发起请求的进程路径与指定路径进行比对。

环境提示

适用平台须结合内核版本核对;旧版列有 Windows、FreeBSD、Linux 及 macOS。

PROCESS-PATH,/usr/local/bin/nc,DIRECT 检查来源程序是否位于 /usr/local/bin/nc,对应时交给 DIRECT。

IPSET:查询地址集合

IPSET 以集合查询结果决定匹配;相关框架可参阅 项目说明。

Linux 内核中的 IP 集可借助 ipset 管理,按集合类型保存地址、网络、端口、MAC 或接口信息,也能使用这些信息的组合。

这项旧版用法依赖 Linux 环境,并要求安装 ipset。

解析提示

对域名会先取得 IP,再查询是否属于给定集合;需要避免查询时,可增加 no-resolve。

IPSET,chnroute,policy 以 chnroute 集合筛选目标 IP,命中后交给 policy。

RULE-SET:引用外置规则

版本提示

旧版将此能力归入 扩展版本;当前是否可用须查现用内核。

RULE-SET 会读取指定的 外置规则集,逐项检查其中条件;任一项命中便采用指定策略,未命中则继续后续规则。

解析提示

地址型规则集可能先触发域名查询;若不希望主动解析,可在 RULE-SET 中追加 no-resolve。

RULE-SET,my-rule-provider,DIRECT 以 my-rule-provider 为外置来源,加载其中条目参与判断。

SCRIPT:以脚本判断条件

版本提示

这项能力在旧版归入 扩展版本,使用前应确认当前实现支持。

SCRIPT 调用所指定的脚本,并依据执行结果决定请求的处理方向。

解析提示

脚本条件会触发域名解析;不需要该行为时,可添加 no-resolve。

SCRIPT,script-path,DIRECT 指定 script-path,让执行结果参与请求的分流判断。

MATCH:接住剩余请求

尚未被前面条件选中的数据由 MATCH 接续处理;旧版规则将它作为必需的末尾兜底项。

MATCH,policy 对剩余请求统一选择 policy。