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"
}
TIP
当多个属性同时指定时,这些属性需要同时满足,才可以使当前规则生效。即 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:
- 从文件中加载 IP:
- 形如
ext:file:tag
和ext-ip:file:tag
为正向匹配
,即为匹配 「tag 内的 IP 地址」。 - 形如
ext:file:!tag
和ext-ip:file:!tag
为反向匹配
,即为匹配「非 tag 内的 IP 地址」。 - 必须以
ext:
或ext-ip:
开头,后面跟文件名、标签
或!标签
,文件存放在资源目录中,文件格式与geoip.dat
相同,标签必须在文件中存在。
- 形如
TIP
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 筛选。
TIP
如在使用 geosite.dat
过程中,遇到问题或发现缺少某些域名,欢迎到 v2fly/domain-list-community 提 issue 或 pull request。
常见的域名有:
category-ads
:包含了常见的广告域名。category-ads-all
:包含了常见的广告域名,以及广告提供商的域名。tld-cn
:包含了 CNNIC 管理的用于中国大陆的顶级域名,如以.cn
、.中国
结尾的域名。tld-!cn
:包含了非中国大陆使用的顶级域名,如以.hk
(香港)、.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
环境变量控制,详情请查看环境变量。