Routing 路由

V2Ray 内建了一个路由模块，可以将入站数据按需求由不同的出站连接发出，以达到按需代理的目的。这一功能的常见用法是分流国内外流量。V2Ray 可以通过内部机制判断不同国家或地区的流量，然后将它们发送到不同的出站代理。

RoutingObject

RoutingObject 对应配置文件的 routing 项。

{
    "domainStrategy": "AsIs",
    "domainMatcher": "mph",
    "rules": [],
    "balancers": []
}

domainStrategy: "AsIs" | "IPIfNonMatch" | "IPOnDemand"

域名解析策略。

  • AsIs：只使用域名进行路由选择，默认值；
  • IPIfNonMatch：当域名没有匹配任何基于域名的规则时，将域名解析成 IP（A 记录或 AAAA 记录），进行基于 IP 规则的匹配；
    • 当一个域名有多个 IP 地址时，会尝试匹配所有的 IP 地址，直到其中一个与某个 IP 规则匹配为止；
    • 解析后的 IP 仅在路由选择时起作用，转发的数据包中依然使用原始域名。
  • IPOnDemand：当匹配时碰到任何基于 IP 的规则，立即将域名解析为 IP 进行匹配。

domainMatcher: "linear" | "mph"

选择要使用的域名匹配算法。

  • linear：使用线性匹配算法，默认值；
  • mph：使用最小完美散列（minimal perfect hash）算法（v4.36.1+）。
    • 测试数据约 17 万条，匹配速度提升约 30%，内存占用减少约 15%

rules: [RuleObject]

对应一个数组，数组中每一项是一个规则。对于每一个连接，路由将根据这些规则依次进行判断，当一个规则生效时，即将这个连接转发至它所指定的 outboundTag（或 balancerTag，V2Ray 4.4+）。当没有匹配到任何规则时，流量默认被转发至第一个 outbound。

balancers: [ BalancerObject ]

（V2Ray 4.4+）一个数组，数组中每一项是一个负载均衡器的配置。当一个规则指向一个负载均衡器时，V2Ray 会通过此负载均衡器选出一个 outbound，然后由它转发流量。

RuleObject

{
    "domainMatcher": "mph",
    "type": "field",
    "domains": [
        "baidu.com",
        "qq.com",
        "geosite:cn",
        "ext:customizedGeoSiteFile.dat:cn"
    ],
    "ip": [
        "0.0.0.0/8",
        "10.0.0.0/8",
        "fc00::/7",
        "fe80::/10",
        "geoip:cn",
        "geoip:!cn",
        "ext:customizedGeoIPFile.dat:cn",
        "ext:customizedGeoIPFile.dat:!cn",
        "ext-ip:customizedGeoIPFile.dat:cn",
        "ext-ip:customizedGeoIPFile.dat:!cn"
    ],
    "port": "53,443,1000-2000",
    "sourcePort": "53,443,1000-2000",
    "network": "tcp",
    "source": [
        "10.0.0.1"
    ],
    "user": [
        "[email protected]"
    ],
    "inboundTag": [
        "tag-vmess"
    ],
    "protocol": [
        "http",
        "tls",
        "bittorrent"
    ],
    "attrs": "attrs[':method'] == 'GET'",
    "outboundTag": "direct",
    "balancerTag": "balancer"
}

提示

当多个属性同时指定时，这些属性需要同时满足，才可以使当前规则生效。即 domains 和 ip 规则需要分开使用。

domainMatcher: "linear" | "mph"

选择要使用的域名匹配算法。此处 domainMatcher 的优先级高于 RoutingObject 配置的 domainMatcher。

  • linear：使用线性匹配算法，默认值；
  • mph：使用最小完美散列（minimal perfect hash）算法（v4.36.1+）。
    • 测试数据约 17 万条，匹配速度提升约 30%，内存占用减少约 15%

type: "field"

目前只支持 field 这一个选项。

domains: [string]

一个数组，数组每一项是一个域名的匹配。有以下几种形式：

  • 纯字符串：当此字符串匹配目标域名中任意部分，该规则生效。比如 sina.com 可以匹配 sina.com、sina.com.cn、sina.company 和 www.sina.com，但不匹配 sina.cn。
  • 正则表达式：由 regexp: 开始，余下部分是一个正则表达式。当此正则表达式匹配目标域名时，该规则生效。例如 regexp:\.goo.*\.com$ 匹配 www.google.com、fonts.googleapis.com，但不匹配 google.com。
  • 子域名（推荐）：由 domain: 开始，余下部分是一个域名。当此域名是目标域名或其子域名时，该规则生效。例如 domain:v2ray.com 匹配 www.v2ray.com、v2ray.com，但不匹配 xv2ray.com。
  • 完整匹配：由 full: 开始，余下部分是一个域名。当此域名完整匹配目标域名时，该规则生效。例如 full:v2ray.com 匹配 v2ray.com 但不匹配 www.v2ray.com。
  • 预定义域名列表：由 geosite: 开头，余下部分是一个类别名称（域名列表），如 geosite:google 或者 geosite:cn。名称及域名列表参考预定义域名列表。
  • 从文件中加载域名：形如 ext:file:tag，必须以 ext: 开头，后面跟文件名和标签，文件存放在资源目录中，文件格式与 geosite.dat 相同，标签必须在文件中存在。

ip: [string]

一个数组，数组内每一项代表一个 IP 范围。当某一项匹配目标 IP 时，此规则生效。有以下几种形式：

  • IP：形如 127.0.0.1。
  • CIDR：形如 10.0.0.0/8。
  • GeoIP：
    • 形如 geoip:cn 为正向匹配，即为匹配「中国大陆 IP 地址」。后面跟双字符国家或地区代码，支持所有可以上网的国家和地区。
    • 形如 geoip:!cn 为反向匹配，即为匹配「非中国大陆 IP 地址」。后面跟双字符国家或地区代码，支持所有可以上网的国家和地区。
    • 特殊值：geoip:private（V2Ray 3.5+），包含所有私有地址，如 127.0.0.1。
  • 从文件中加载 IP：
    • 形如 ext:file:tag 和 ext-ip:file:tag 为正向匹配，即为匹配 「tag 内的 IP 地址」。
    • 形如 ext:file:!tag 和 ext-ip:file:!tag 为反向匹配，即为匹配「非 tag 内的 IP 地址」。
    • 必须以 ext: 或 ext-ip: 开头，后面跟文件名、标签或 !标签，文件存放在资源目录中，文件格式与 geoip.dat 相同，标签必须在文件中存在。

提示

ext:geoip.dat:cn 和 ext-ip:geoip.dat:cn 等价于 geoip:cn；

ext:geoip.dat:!cn 和 ext-ip:geoip.dat:!cn 等价于 geoip:!cn。

port：number | string

目标端口范围，有三种形式：

  • a-b：a 和 b 均为正整数，且小于 65536。这个范围是一个前后闭合区间，当端口落在此范围内时，此规则生效。
  • a：a 为正整数，且小于 65536。当目标端口为 a 时，此规则生效。
  • （V2Ray 4.18+）以上两种形式的混合，以逗号 "," 分隔。形如：53,443,1000-2000。

sourcePort：number | string

来源端口范围，格式同上

network: "tcp" | "udp" | "tcp,udp"

可选的值有 "tcp"、"udp" 或 "tcp,udp"，当连接方式是指定的方式时，此规则生效。

source: [string]

一个数组，数组内每一项代表一个 IP 范围，形式有 IP、CIDR、GeoIP 和从文件中加载 IP。当某一项匹配来源 IP 时，此规则生效。

user: [string]

一个数组，数组内每一项是一个邮箱地址。当某一项匹配来源用户时，此规则生效。当前 Shadowsocks 和 VMess 支持此规则。

inboundTag: [string]

一个数组，数组内每一项是一个标识。当某一项匹配入站协议的标识时，此规则生效。

protocol: [ "http" | "tls" | "bittorrent" ]

一个数组，数组内每一项表示一种协议。当某一个协议匹配当前连接的流量时，此规则生效。必须开启入站代理中的 sniffing 选项。

attrs: string

（V2Ray 4.18+）一段脚本，用于检测流量的属性值。当此脚本返回真值时，此规则生效。

脚本语言为 Starlark，它的语法是 Python 的子集。脚本接受一个全局变量 attrs，其中包含了流量相关的属性。

目前只有 HTTP 入站代理会设置这一属性。

示例：

  • 检测 HTTP GET：attrs[':method'] == 'GET'
  • 检测 HTTP Path：attrs[':path'].startswith('/test')
  • 检测 Content Type：attrs['accept'].index('text/html') >= 0

outboundTag: string

对应一个额外 出站连接配置 的标识。

balancerTag: string

对应一个负载均衡器的标识。balancerTag 和 outboundTag 须二选一。当同时指定时，outboundTag 生效。

BalancerObject

负载均衡器配置。当一个负载均衡器生效时，它会从指定的出站协议中，按配置选出一个最合适的出站协议，进行流量转发。

{
    "tag": "balancer",
    "selector": [],
    "strategy": {
      "type": "random"
    }
}

tag: string

此负载均衡器的标识，用于匹配 RuleObject 中的 balancerTag。

selector: [ string ]

一个字符串数组，其中每一个字符串将用于和出站协议标识的前缀匹配。在以下几个出站协议标识中：[ "a", "ab", "c", "ba" ]，"selector": ["a"] 将匹配到 [ "a", "ab" ]。

strategy: StrategyObject

进行负载均衡的策略对象。

StrategyObject

{
    "type": "random"
}

type: string

进行负载均衡的策略类型。

可以填入的类型包括 random 以及 leastPing (v4.38.0+).

random 会从出站中随机选出一个作为最终的出站连接。

leastPing 会根据观测记录选择 HTTPS GET 请求完成时间最快的一个出站连接。

负载均衡策略依赖于出站 连接观测 组件的观测记录。

预定义域名列表

此列表由 domain-list-community 项目维护，预置于每一个 V2Ray 的安装包中，文件名为 geosite.dat。这个文件包含了一些常见的域名，使用方式：geosite:listname，如 geosite:google 表示对 domain-list-community 项目 data 目录里的 google 文件内包含的域名，进行路由筛选或 DNS 筛选。

提示

如在使用 geosite.dat 过程中，遇到问题或发现缺少某些域名，欢迎到 v2fly/domain-list-community 提 issue 或 pull request。

常见的域名有：

  • category-ads：包含了常见的广告域名。
  • category-ads-all：包含了常见的广告域名，以及广告提供商的域名。
  • tld-cn：包含了 CNNIC 管理的用于中国大陆的顶级域名，如以 .cn、.中国 结尾的域名。
  • tld-!cn：包含了非中国大陆使用的顶级域名，如以 .tw（台湾）、.jp（日本）、.sg（新加坡）、.us（美国）.ca（加拿大）等结尾的域名。
  • geolocation-cn：包含了常见的大陆站点域名。
  • geolocation-!cn：包含了常见的非大陆站点域名。
  • cn：相当于 geolocation-cn 和 tld-cn 的合集。
  • apple：包含了 Apple 旗下绝大部分域名。
  • google：包含了 Google 旗下绝大部分域名。
  • microsoft：包含了 Microsoft 旗下绝大部分域名。
  • facebook：包含了 Facebook 旗下绝大部分域名。
  • twitter：包含了 Twitter 旗下绝大部分域名。
  • telegram：包含了 Telegram 旗下绝大部分域名。
  • 更多类别，请查看 data 目录。

Geodata 文件加载器

V2Ray 内置了多种读取和解码 geoip.dat 和 geosite.dat 文件的加载器 (v4.39.0+)。

本项设置由 v2ray.conf.geoloader 环境变量控制，详情请查看环境变量。

在 GitHub 上编辑此页
上次更新:
贡献者: kslr, EpLiar, loyalsoldier, RPRX, Kslr, 秋のかえで, Shelikhoo, Kslr, Loyalsoldier, sixg0000d, Moody, Nicholas Wang, mayampi01