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

逐项讲解 domain、full、regexp、ip 与 geosite 规则的写法,说明规则自上而下的匹配顺序及代理、直连、阻断的取舍。

本文速览

适合已在 v2rayN 中建立连接、需要按目标地址分流的用户。先区分单个主机、整组域名和 IP 网段,再把例外放到通用规则之前。最后用核心日志核对流量是否进入客户端、实际选中了哪个出站。

域名规则:精确匹配、后缀与规则集

domain 既是路由规则的字段名,也是字段内的一种匹配前缀。字段名决定规则以域名为条件;条目中的 domain: 才表示按域名后缀匹配。填写主机名时不带协议、端口或路径。要区分同一主机下的两个网页目录,不能靠这里的域名条件。

域名条目的匹配范围
条目匹配范围
full:portal.example.org只匹配该主机,不匹配其子域。
domain:example.org匹配根域及其子域,不匹配 notexample.org。
regexp:^api[0-9]+\.example\.org$匹配 api12.example.org,不匹配 api.example.org。写入 JSON 字符串时,每个反斜杠要再转义一次。
geosite:cn引用当前 geosite.dat 中名为 cn 的集合,不等于所有以 .cn 结尾的域名。

只需要覆盖一个登录主机时,用 full:。需要覆盖同一域名下的登录、接口和静态资源子域时,用 domain:。不要用裸字符串模拟精确匹配:标准域名规则中的裸字符串按子串匹配,容易把含有同一片段的其他主机纳入。规则集适合维护大量条目,但组名是否存在、组内包含哪些域名,都取决于客户端实际加载的数据文件。

IP 规则:地址、网段与解析策略

ip 匹配的是连接目标,不是本机网卡的源地址,也不是代理服务器的地址。访问只接受 IP 地址的内部服务,可以直接按单地址或网段分流;用域名访问时,还要看内核何时为路由匹配解析地址。

规则顺序与出站选择

规则按列表从上到下判断,首条满足全部条件的规则决定出站。系统不会因为 full: 比 domain: 更具体,就自动把精确项提到前面。以下是 routing.rules 数组示例;direct、block 和 proxy 必须对应实际配置中已有的出站标签,不是粘贴后就会自动创建的出站。

[
  {"type":"field","domain":["full:portal.example.org"],"outboundTag":"direct"},
  {"type":"field","domain":["full:retired.example.org"],"outboundTag":"block"},
  {"type":"field","domain":["domain:example.org"],"outboundTag":"proxy"},
  {"type":"field","ip":["192.168.50.0/24"],"outboundTag":"direct"},
  {"type":"field","network":"tcp,udp","outboundTag":"proxy"}
]

把第三行域名规则移到最前面,portal.example.org 和 retired.example.org 就会被它提前匹配。末尾的网络条件为 TCP 和 UDP 提供显式兜底,不应挪到例外前面。未设置显式兜底且任何规则都未命中时,内核通常使用配置中的第一个出站;不要把未命中理解成自动直连。

直连已知内网

推荐

从一条已知的内网服务地址开始测试。直连仍依赖本机的网络路由,不能让本来不可达的私有网段变得可达。

适合:本机可以直接访问的打印机或内部管理页

代理指定目标

将目标交给配置好的代理出站。规则选中代理只说明分流正确,后续仍可能出现解析失败或连接超时。

适合:明确要求使用代理出站的服务

阻断明确目标

把已确认不需要访问的主机交给阻断出站。优先用精确主机名验证,避免误拦共享后缀下的登录或资源主机。

适合:已退役的服务端点或临时验证规则是否命中

验证顺序时先只移动一条规则

保持入站和出站不变,把测试主机的精确规则移到通用规则上方,再关闭旧连接并重试;若出站随之改变,就不用先更换节点或修改 DNS。

在 v2rayN 中添加并验证规则

以下以 v2rayN 7.x 中常见的路由界面和 Xray 字段为例。其他版本的入口名称可能不同;整份内核配置与图形界面中的单条规则也不是同一种导入格式。只编辑一条规则时,不要把带 routing 外层的配置当成域名列表粘贴。

  1. 打开路由设置

    在主窗口选择「设置」→「路由设置」。记下当前启用的方案,保留原方案用于回退,再在路由列表中选择要编辑的方案。

  2. 新增精确规则

    打开方案的规则编辑界面,先添加一条 full: 域名规则,并选择目标出站。验证时用实际可访问的主机替换示例域名;如果测试目标是 IP,只填写 IP 条件。

  3. 排序并启用

    将新增规则排在会覆盖它的后缀、规则集或通用规则之前。保存后回到主界面,确认「路由」选择的是刚编辑的方案。保存配置和切换当前方案是两件事。

  4. 发起新连接

    先访问目标主机,再访问一个应走其他出站的对照主机。若应用支持手动代理,可指向客户端显示的本地监听地址;例如实际配置为 127.0.0.1:10808 时,还要核对应用所选代理协议是否与该入站一致。不要把此端口当成所有安装的固定值。

  5. 核对出站日志

    在核心访问日志中查两次请求的目标与出站标签,再看连接是否成功。浏览器可能复用旧连接,验证规则变动前可退出浏览器再重开;仅刷新标签页不一定建立新连接。

规则不生效:按日志定位

保存了规则,为什么还是走代理?

先确认日志记录的确实是新发起的目标连接,再核对启用方案和规则顺序。若较早的 geosite 条目已经覆盖该主机,把 full: 例外移到该条目之前。页面跳转后还可能访问另一个主机,以日志中的实际目标为准。

加了 geosite,内核为什么启动失败?

先读启动日志,区分找不到数据文件和找不到集合名称。临时禁用新增条目确认能否恢复启动,再核对当前核心加载的数据文件与其中实际提供的组名。只涉及几个主机时,可先用明确的域名条目替代集合。

日志里只有 IP,为什么域名规则没命中?

应用可能先解析地址,再把 IP 交给客户端。路由解析策略不会把这个 IP 反查成原域名。用能向代理提交主机名的应用复测;若连接天然只按 IP 发起,就写对应 IP 条件,并确认地址是否稳定。

浏览器有日志,另一个应用却没有?

先确认访问日志已开启。系统代理只影响遵循该设置的应用,其他应用可能直接联网。检查该应用是否有单独的代理设置;若正在使用 TUN,则检查目标方向的流量是否进入虚拟网卡。流量没有进入核心时,调整规则顺序不会改变结果。

下载v2rayN