V2Ray 自定义路由规则写法:domain、ip、geosite 语法与匹配优先级

路由判断的核心是“从上到下，首次命中”。核心依次读取规则列表，一旦某条规则的全部条件成立，就使用这条规则指定的出站，不再继续检查后面的规则。因此，同一个域名同时属于广告分类和地区分类时，放在前面的拦截规则会先于后面的直连规则生效。

domain 数组支持多种前缀。最稳妥的做法不是把所有地址都写成普通字符串，而是先确认需要匹配精确主机、整个根域名，还是名称中带有某段字符的站点。匹配范围写得过宽，会让无关域名一起进入同一个出站；写得过窄，则可能漏掉静态资源、接口和登录子域名。

regexp: 可使用正则表达式，例如 regexp:^([a-z0-9-]+\.)*example\.com$。它可以描述更复杂的主机名结构，但维护成本高于 domain:。如果目标只是覆盖根域名和所有子域名，直接写 domain:example.com 更清楚，也更不容易因为转义错误导致规则失效。

geosite:cn 表示引用名为 cn 的域名分类，geosite:category-ads-all 常用于匹配广告相关域名。分类内容来自客户端使用的数据文件，规则本身只保存分类名。核心升级后如果日志提示分类不存在，应同步检查 geosite 数据是否完整、分类名称是否受当前数据版本支持。

ip 字段可以写单个地址、CIDR 网段或 geoip 分类。CIDR 中斜杠后的数字表示网络前缀长度，例如 192.168.0.0/16 覆盖从 192.168.0.0 到 192.168.255.255 的地址；10.0.0.0/8 覆盖整个 10 开头的私有网段。需要处理家庭路由器、存储设备和局域网服务时，直接使用 geoip:private 通常比逐条罗列网段更省事。

域名请求能否进入 IP 规则，取决于路由的 domainStrategy。设为 AsIs 时，路由模块按原始目标判断，域名不会为了 IP 匹配而主动解析；设为 IPIfNonMatch 时，域名规则没有命中后再解析 IP，并继续尝试 IP 规则；设为 IPOnDemand 时，匹配过程遇到需要目标 IP 的规则便可能触发解析。

一个常见错误是在同一条规则里同时写 domain:example.com 和 geoip:cn，原意是“域名或地区 IP 任一命中就直连”，实际却变成“域名属于 example.com，并且解析结果属于该 IP 分类才直连”。要表达“或者”，应拆成两条规则，并让它们指向相同的 outboundTag。

结论:域名规则在前，IP 规则负责补漏

匹配优先级与可直接套用的规则顺序

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "domain": [
          "full:portal.example.com",
          "domain:intranet.example"
        ],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": [
          "geosite:category-ads-all"
        ],
        "outboundTag": "block"
      },
      {
        "type": "field",
        "ip": [
          "geoip:private"
        ],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": [
          "geosite:cn"
        ],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": [
          "geoip:cn"
        ],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

在 v2rayN 中录入并验证规则

• 准备 4 类测试目标：自定义例外、geosite 分类、IP 网段与未分类域名。
• 每类连续测试 3 次，共记录 12 条请求，排除缓存或偶发解析失败。
• 在实时日志中核对目标地址、命中的出站标签和失败原因。
• 修改规则后重启核心，不要用旧连接判断新规则是否生效。
• 测试局域网时直接填写设备 IP，例如 192.168.1.1，确认它命中 private 直连规则。

curl --proxy socks5h://127.0.0.1:10808 https://example.com
curl --proxy socks5h://127.0.0.1:10808 https://www.example.org

常见异常与定位方法