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

逐条拆解 domain、full、regexp、ip 与 geosite、geoip 写法,说明规则自上而下匹配的顺序与常见冲突的处理方式。

本文速览

本文面向需要在 v2rayN 调整分流、或直接阅读 Xray、V2Fly 配置的读者。先区分域名、目标 IP 和数据集,再用一份可逐条推演的配置检查例外规则、出站标签及 DNS 解析时机。即使测试网站打不开,也能先从日志判断请求究竟走了哪个出站。

domain、full、regexp:域名规则的匹配范围

在内核 JSON 中,domain 是规则字段,domain: 则是该字段中一种匹配前缀。域名字段比较的是主机名,不是完整网址。配置时去掉 https://、端口、路径和查询参数;同一主机下的两个页面不能靠这类规则分流。

domain: 域及子域

推荐

domain:example.com 匹配 example.com 和 api.example.com,不匹配 notexample.com。匹配边界是域名标签,不是任意字符串后缀。

适合:对整个站点及其子域使用同一出站

full: 指定主机

full:api.example.com 只匹配这个主机名。它既不覆盖 example.com,也不覆盖 v2.api.example.com。要单独处理一个主机,不必为此写正则。

适合:给登录、接口或静态资源主机设置例外

regexp: 主机名模式

正则 ^img[0-9]+\.example\.com$ 匹配 img1.example.com,不匹配 img.example.com;写进 JSON 时,每个反斜杠要写成两个,即 "regexp:^img[0-9]+\\.example\\.com$"。

适合:一组主机遵循固定编号模式,但不能放行整个域

内核 JSON 中的裸字符串 example.com 按子串匹配,可能把 notexample.com 也纳入。排查规则过宽时,先看有没有漏掉前缀,再检查正则是否缺少首尾锚点或把点号当成了通配符。使用客户端编辑器时,还要确认导出的内核配置与输入预期一致。

ip、geosite、geoip:地址与数据集的区别

ip 匹配请求的目标 IP,而不是节点服务器地址。要按来源区分流量,不能复用这个字段。geosite: 仍放在 domain 数组中;geoip: 才放在 ip 数组中。两个前缀都引用本机数据文件里的类别,不是发送在线查询。

项目内核写法匹配依据
单地址"ip": ["192.0.2.10"]只检查一个目标地址,适合核对单条地址规则。
CIDR 网段"ip": ["192.0.2.0/24", "2001:db8::/32"]前缀分别覆盖 IPv4 和 IPv6 文档地址段;真实策略要按实际网段替换。
域名集合"domain": ["geosite:cn"]依赖 geosite.dat 中的条目,不等同于匹配所有以 .cn 结尾的域名。
地址集合"ip": ["geoip:cn"]检查目标 IP 是否落在 geoip.dat 对应分类的地址段内。

数据文件版本或来源不同,类别名称和集合内容可能不同。导入规则后若内核提示无法加载类别,先查实际加载的文件和类别名,而不是调整规则顺序。域名属于某个站点集合,也不意味着它当前解析到的地址属于同名 IP 集合;CDN、双栈和解析结果变化都可能造成差异。

匹配优先级:例外在前,宽规则在后

routing.rules 自上而下检查,命中第一条即选定出站。full: 不会因为比 domain: 更具体而自动抢先;同一条规则里,domain 和 ip 等不同条件字段必须同时满足。同一个 domain 数组的多个条目则是任选其一。想表达「指定域名或指定 IP」,应拆成两条指向同一出站的规则。

下面的 Xray 配置使用本机 SOCKS 入站。direct、reject 是自定义出站标签,分别绑定 freedom 和 blackhole。这些标签不是协议名,也不能直接用节点显示名称代替。示例使用保留域名与文档地址,不依赖订阅或地区数据文件。

{
  "log": {"loglevel": "info"},
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {"auth": "noauth", "udp": true}
    }
  ],
  "outbounds": [
    {"tag": "direct", "protocol": "freedom"},
    {"tag": "reject", "protocol": "blackhole"}
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {"type": "field", "domain": ["full:api.example.com"], "outboundTag": "direct"},
      {"type": "field", "domain": ["domain:example.com"], "outboundTag": "reject"},
      {"type": "field", "ip": ["192.0.2.0/24"], "outboundTag": "reject"},
      {"type": "field", "network": "tcp,udp", "outboundTag": "direct"}
    ]
  }
}
10808
示例 SOCKS 入站端口
4 条
示例规则总数,含末尾兜底
192.0.2.10
命中第三条的文档地址

结论:用一对目标检查规则遮挡

新增例外后,同时验证例外主机和一个同域普通主机。只有两者按预期走不同出站,再加入更宽的地区规则;如果两者走同一出站,先检查上方是否已有范围更大的匹配项。

domainStrategy:域名何时进入 IP 匹配

对字面 IP 的请求,内核可直接比较地址;对携带域名的请求,路由阶段是否需要解析,要看 routing.domainStrategy。这和选定出站后为建立连接而进行的 DNS 查询是两件事。修改路由策略并不等于更换 DNS 服务器,也不保证客户端会把域名交给内核。

要让域名规则优先、未匹配的域名再试地址规则,可用 IPIfNonMatch,移除会提前命中的末尾通配规则,并把预期的默认出站放在 outbounds 首位。修改前后分别检查域名输入与字面 IP 输入;如果域名始终在进入内核前就被应用解析,调整此项不能从 IP 反推出原始主机名。

v2rayN 路由设置:保存、切换与验证

以下以桌面版 v2rayN 的 Xray 路由配置为例。不同版本的编辑窗口与启用控件可能不同;上文的完整 JSON 用于独立演示,不应整段粘到单条规则的域名栏,也不应直接覆盖已有订阅生成的配置。

  1. 保留旧方案

    从主窗口进入「设置」→「路由设置」,先记下当前启用的方案和原有规则顺序。修改已有方案前保留原规则副本;测试失败时先切回原方案,不必重新导入订阅。

  2. 分别填写条件

    在待测方案的规则编辑界面,将 full:api.example.com 和 domain:example.com 分成两条,放到域名栏而不是 IP 栏。给两条选不同出站,将单主机例外排在整域规则之前。

  3. 启用待测方案

    保存后确认当前启用的是待测方案,而不只是打开过编辑窗口。若规则由 v2rayN 生成,使用界面提供的出站选项,不照抄示例的 reject 标签;手写配置则要核对 outboundTag 是否存在。

  4. 对照内核日志

    用本机实际 SOCKS 端口发出两次独立请求。示例端口是 10808;若使用 curl,可运行 curl --proxy socks5h://127.0.0.1:10808 --max-time 5 https://api.example.com/,再将目标换成 img.example.com。观察内核访问日志中的目标与出站,而不是把文档域名的网页能否打开当成命中证据。

常见冲突:规则正确但出站不符

为什么加了 full,还是走了整域规则?

把单主机规则移动到整域规则上方,同时检查前面是否还有包含该主机的 geosite: 规则。保存并启用正确的方案,再发一个新连接,分别核对例外主机和同域普通主机的出站。

IP 直输能命中,换成域名就不行?

先看日志里内核收到的是域名还是 IP。收到域名时检查 domainStrategy;若已用 IPIfNonMatch,再查首轮是否被兜底或其他域名规则截住。收到 IP 时,核对该地址是否真落在网段内,尤其别把 IPv6 地址与 IPv4 网段比较。

复制 geosite 规则后,内核怎么启动不了?

先读启动日志,区分找不到数据文件与找不到集合名。核对当前内核实际使用的 geosite.dat,而不是其他配置目录中的同名文件。可临时把集合换成一条等用途的显式域名规则,验证出站和规则顺序是否正常。

浏览器结果和命令行为什么不一样?

先确认两者确实经过同一个本机入站。用 socks5h 做对照时,curl 会把域名交给 SOCKS 代理;浏览器可能使用不同的代理设置、走直连,或复用已有连接。新建请求并按日志里的目标与时间对照,避免把旧连接当作新规则的结果。

下载v2rayN