V2Ray 自定义路由规则写法:domain、ip、geosite 匹配语法与生效顺序

逐一说明 domain、full、regexp、geosite 与 ip、geoip 的写法差异,解释规则自上而下匹配的优先级和 domainStrategy 的影响。

本文速览

适合正在用 v2rayN 调整分流,或直接维护 V2Ray、Xray 配置的读者。先区分域名条件和 IP 条件,再用一组可推演的规则验证顺序,最后判断问题出在匹配范围、DNS 解析,还是当前配置没有载入。

域名规则:单个主机、域名树与分类表

在 V2Ray、Xray 的字段规则中,域名条件写在 domain 数组里。数组名和条目前缀恰好都可以叫 domain,但含义不同:前者指定条件类型,后者指定匹配方式。不要把整条网址贴进去;路由匹配的目标名称不包含 https://、端口或页面路径。

domain:域名及其子域

推荐

domain:example.com 匹配 example.com 和 img.example.com,不匹配 notexample.com。如果省略前缀直接写 example.com,则是子串匹配,可能把后者也纳入。

适合:明确按一个站点及其子域分流。

full:完整主机名

full:api.example.com 只匹配这一个名字,既不匹配根域,也不匹配 v2.api.example.com。适合从一条宽规则里单独取出一个例外。

适合:单个 API、测试环境或指定主机。

regexp:按名称模式匹配

JSON 数组条目 "regexp:^img[0-9]+\\.example\\.com$" 匹配形如 img12.example.com 的主机名。首尾锚点限制整串匹配;JSON 中用两个反斜杠表达正则里的一个反斜杠,避免把点误写成任意字符。

适合:编号等规则明确、但主机名较多的场景。

geosite:引用域名分类

geosite:cn 引用当前域名数据文件里的 cn 分类,不等同于匹配所有以 .cn 结尾的名字。分类是否存在、包含哪些条目,都由实际载入的数据决定。

适合:按现有数据集维护一批站点。

一个 domain 数组中的条目是任选其一,不是依次执行的出站动作。如果想让同一站点的两个主机走不同出站,要分别写规则,而不是把它们放在同一数组中期待先后生效。

IP 规则:单地址、CIDR 与 GeoIP 分类

ip 数组匹配目标 IP。连接原本就以 IP 为目标时,不需要先解析域名;连接以名称为目标时,是否能拿解析结果做 IP 匹配,要看路由策略。下面的数字是示例网段的前缀长度,不是测速结果。

/32
IPv4 单地址前缀
/24
IPv4 示例网段前缀
/128
IPv6 单地址前缀

结论:先把分类问题缩成一条规则

分类更新后某个站点改了出站,先用 full: 对照该主机名,或用单地址前缀对照实际目标 IP,一次只验证一种条件。确认临时规则能命中,再回头检查分类文件和类别,不必先重排整张规则表。

生效顺序:先命中哪条,就采用哪条

路由按 rules 数组从上到下检查,采用第一条匹配规则。full: 不会因为比 domain: 更具体而自动提到前面。同一条字段规则如果同时填写 domain 和 ip,则两项都要满足;想表达「域名匹配或 IP 匹配就走同一出站」,应拆成两条规则。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:api.example.com"],
        "outboundTag": "proxy"
      },
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["192.0.2.0/24"],
        "outboundTag": "direct"
      }
    ]
  }
}

这是路由片段,不是完整运行配置。proxy 和 direct 必须与当前 outbounds 中的标签一致;标签本身不会创建代理或直连出站。示例域名和网段用于推演匹配,不用于验证服务是否在线。

domainStrategy:域名何时参与 IP 匹配

routing.domainStrategy 控制的是路由阶段是否为了匹配而解析目标名称,不等同于直连出站如何拨号,也不等同于应用自身的 DNS 设置。看到 DNS 请求,并不能据此断定命中了 IP 规则。

策略解析时机对规则优先级的影响
AsIs路由不为匹配主动解析目标名称。域名按名称判断,原本就是 IP 的目标仍可匹配 IP 条件。
IPIfNonMatch首轮没有匹配时,解析域名后再尝试匹配。首轮若已匹配域名条件或通用兜底,后续不会为 IP 匹配再试一轮。
IPOnDemand遇到需要目标 IP 的匹配条件时按需解析。靠前的 IP 规则可以凭解析结果先于后面的域名规则命中。

例如,想让没有明确域名归属的请求按 IP 分类,使用 IPIfNonMatch 时要特别检查末尾是否有覆盖全部测试流量的规则。若首轮就被兜底接住,仅把 IP 规则移到兜底前面也不能触发重试。可以按需求改用按需解析,或避免让兜底规则在首轮提前结束匹配,同时核对默认出站。

v2rayN 排查步骤:从当前方案到新连接

以下以 v2rayN 7.x 常见中文界面为例;小版本的入口位置可能不同。内置路由方案由客户端生成内核配置,而完整的自定义配置要从实际载入的文件核对。修改前保留一份原方案,方便做单变量对照。

  1. 确认内核

    从「设置」→「参数设置」查看内核相关选项,再核对当前服务器条目及启动日志中的实际内核。默认内核选项不能替代这一步;条目指定的内核或自定义配置可能不同。本文 JSON 是 V2Ray、Xray 风格,不可原样套给使用不同配置格式的内核。

  2. 编辑当前方案

    从「设置」→「路由设置」检查当前启用的方案,在对应规则列表核对顺序与出站。先用一条精确主机规则验证,暂时不要同时改 DNS、分类数据和默认出站,否则结果变化时很难判断是哪一项导致的。

  3. 检查载入

    保存并应用规则,必要时重启内核。先看有没有配置解析错误、分类缺失或出站标签不一致的提示。自定义配置尤其要确认编辑的是当前条目载入的文件,而不是旧导出副本。

  4. 新建连接验证

    断开旧连接后重新发起请求,查看日志里可用的目标和出站信息。应用可能复用连接,也可能先自行解析并把 IP 交给入站;这种情况下,域名规则未命中并不等于排序有误。先确认流量确实进了内核,再确认路由看到的是名称还是地址。

需要对照完整字段时,可查看路由配置参考和DNS 配置参考。如果只有部分应用表现不同,先比较它们的接入方式和目标地址形式,再决定是否调整域名策略。

下载v2rayN查看平台与安装包