V2Ray 自定义路由规则语法详解：domain、ip 与 geosite 的匹配顺序

路由处理链与首条命中原则

V2Ray 与 Xray 的路由模块不负责建立节点连接，而是在请求进入内核后，根据目标域名、目标 IP、端口、网络类型和入站标签等信息选择出站。最终选择结果通常由 outboundTag 指向一个已定义的出站，例如 proxy、direct 或 block。

规则存放在 routing.rules 数组中，内核从第一条开始向下检查。某条规则满足全部条件后，扫描立即停止，后面的规则不再参与本次请求。因此，“更具体的规则在前、更宽泛的规则在后”是稳定配置的基础。

同一条规则中的不同字段通常是“并且”关系。例如一条规则同时写了 domain 和 port，目标必须同时符合域名条件和端口条件。一个字段内部的多个项目通常是“或者”关系，例如 domain 数组列出三个域名，命中其中任意一个即可满足该字段。

domain：精确域名、子域名与关键词匹配

domain 字段处理目标主机名。常用前缀包括 full:、domain:、keyword:、regexp: 和 geosite:。前缀决定匹配范围，选择不当会造成规则覆盖过宽或根本无法命中。

full:example.com 只匹配完整主机名 example.com，不会把 www.example.com 视为同一个目标。domain:example.com 则匹配该域名及其子域名，适合把同一站点体系交给相同出站。

{
  "type": "field",
  "domain": [
    "full:api.example.com",
    "domain:static.example.net",
    "keyword:media",
    "regexp:^cdn-[0-9]+\\.example\\.org$"
  ],
  "outboundTag": "proxy"
}

• full: 适合登录接口、更新接口等明确主机名，匹配范围最窄。
• domain: 适合主域名及全部下级子域名，是日常规则中更常用的形式。
• keyword: 只要目标域名包含指定字符串就可能命中，短关键词容易误伤无关域名。
• regexp: 适合结构固定但编号变化的域名，表达式复杂时会增加维护成本。
• geosite: 引用预先整理的域名分类集合，适合按服务类别或区域批量分流。

如果精确域名需要作为分类规则的例外，应把精确规则放在前面。例如先把 full:download.example.com 指向直连，再把 domain:example.com 指向代理。顺序颠倒后，下载域名会提前被整站规则接收。

ip 与 geoip：地址段匹配和域名解析条件

ip 字段可以写单个地址、CIDR 地址段以及 geoip: 分类。单个 IPv4 地址可以写成 198.51.100.20，网段可写成 198.51.100.0/24。IPv6 地址段同样使用 CIDR 表示，例如 2001:db8:1200::/48。

geoip:private 常用于匹配局域网、回环和其他非公网地址。把这类地址放到直连规则前部，可以避免本地路由器管理页、局域网文件服务或本机接口被送往远端代理。

{
  "type": "field",
  "ip": [
    "geoip:private",
    "192.0.2.0/24",
    "2001:db8:1200::/48"
  ],
  "outboundTag": "direct"
}

IP 规则能否处理一个最初以域名形式发起的请求，还取决于 domainStrategy。目标只有域名而没有目标 IP 时，内核必须决定是否解析该域名，再把解析结果交给 ip 规则比较。

geosite 与 geoip 的边界

geosite 是域名集合，geoip 是 IP 地址集合。两者解决的是不同阶段的信息分类问题，不能互相替代。站点采用动态地址、共享云服务或频繁调整解析结果时，域名集合通常比固定 IP 段更适合表达服务归属。

一条 geosite:cn 规则依据目标域名是否存在于对应分类中作出判断；一条 geoip:cn 规则依据目标 IP 是否落入对应地址集合中作出判断。域名与服务器所在地并非必然一致，因此两条规则可能对同一连接给出不同分类结果。

数据文件需要与内核版本和配置能力相匹配。出现“failed to load geosite”或分类名称无法识别时，应先确认数据文件位于内核实际读取的目录，再确认分类名称存在。仅调整规则顺序无法修复数据文件缺失。

outboundTag 与完整规则组合

outboundTag 的值必须与 outbounds 数组中某个出站的 tag 完全一致，包含大小写差异也会被视为不同名称。规则写成 "outboundTag": "direct" 时，配置中必须存在标签为 direct 的出站。

典型顺序可以拆成四层：私有地址直连、精确例外、分类分流、兜底处理。阻断规则如果涉及特定域名或端口，应放在可能覆盖它的宽泛代理规则之前。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "domainMatcher": "hybrid",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["full:updates.example.com"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:cn"],
        "outboundTag": "direct"
      }
    ]
  }
}

1. 第一条处理局域网与本机地址，避免内部服务进入代理链路。
2. 第二条定义明确例外，使指定更新域名始终采用直连。
3. 第三条按域名集合处理已分类站点，不需要等待 IP 分类。
4. 第四条在域名规则未覆盖时，以解析后的地址集合补充判断。
5. 未命中的请求继续使用配置默认路径，实际出口由完整出站结构决定。

如果配置使用负载均衡器，规则可能通过 balancerTag 指向均衡器，而不是直接指定单一出站。普通自定义分流优先使用 outboundTag，只有确实配置了选择器与均衡器时再引入 balancerTag，避免增加不必要的排查层级。

v2rayN 中的配置路径与验证步骤

在 v2rayN 7.x 中，可先进入「设置」→「路由设置」查看当前路由配置和预设规则。不同小版本的按钮位置可能有调整，但验证目标相同：确认当前启用的路由配置、规则排列顺序和最终生成的内核配置一致。

修改后不要只看浏览器是否能打开网页。浏览器缓存、DNS 缓存以及已有连接复用都可能掩盖结果。应重新启动内核，使用新的目标连接，并把日志级别临时调整为 info 或 debug 后观察路由记录。

1. 在「设置」→「路由设置」确认当前选中的规则集，记录预期命中的规则位置。
2. 检查规则中的 outboundTag，并与生成配置中 outbounds[].tag 逐字对照。
3. 在「设置」→「参数设置」确认本地监听和日志相关选项，常见 SOCKS 端口为 10808，HTTP 端口为 10809。
4. 保存配置并重启内核，关闭原有浏览器连接或换用新的测试域名。
5. 查看日志里的目标域名、目标地址和出站标签，判断请求在哪一条规则停止扫描。
6. 一次只移动或修改一条规则，复测后再处理下一处，避免多个变化互相干扰。

检查清单
1. 目标是域名还是 IP
2. domainStrategy 是否触发解析
3. 精确规则是否位于分类规则之前
4. outboundTag 是否存在且大小写一致
5. geosite 与 geoip 数据是否成功加载
6. 测试连接是否为修改后的新连接

规则不生效的常见定位问答

路由问题通常不是单一语法错误，而是目标形式、解析策略、排序和出站标签共同作用的结果。先确认日志里实际出现的目标，再对照规则条件，比直接扩大匹配范围更可靠。

最终配置应保持规则目的可读：一条规则处理一个明确意图，标签名称反映出口用途，例外规则紧邻其覆盖对象。规则数量增加后，清晰的排序和最小条件比堆叠关键词更容易长期维护。