11 KiB
路由
路由功能模块可以将入站数据按不同规则由不同的出站连接发出,以达到按需代理的目的。
如常见用法是分流国内外流量,Xray 可以通过内部机制判断不同地区的流量,然后将它们发送到不同的出站代理。
有关路由功能更详细的解析:路由 (routing) 功能简析
RoutingObject
RoutingObject
对应配置文件的 routing
项。
{
"routing": {
"domainStrategy": "AsIs",
"domainMatcher": "hybrid",
"rules": [],
"balancers": []
}
}
domainStrategy
: "AsIs" | "IPIfNonMatch" | "IPOnDemand"
域名解析策略,根据不同的设置使用不同的策略。
"AsIs"
:只使用域名进行路由选择。默认值。"IPIfNonMatch"
:当域名没有匹配任何规则时,将域名解析成 IP(A 记录或 AAAA 记录)再次进行匹配;- 当一个域名有多个 A 记录时,会尝试匹配所有的 A 记录,直到其中一个与某个规则匹配为止;
- 解析后的 IP 仅在路由选择时起作用,转发的数据包中依然使用原始域名;
"IPOnDemand"
:当匹配时碰到任何基于 IP 的规则,将域名立即解析为 IP 进行匹配;
domainMatcher
: "hybrid" | "linear"
域名匹配算法,根据不同的设置使用不同的算法。此处选项会影响所有未单独指定匹配算法的 RuleObject
。
"hybrid"
:使用新的域名匹配算法,速度更快且占用更少。默认值。"linear"
:使用原来的域名匹配算法。
rules
: [RuleObject]
对应一个数组,数组中每一项是一个规则。
对于每一个连接,路由将根据这些规则从上到下依次进行判断,当遇到第一个生效规则时,即将这个连接转发至它所指定的 outboundTag
或 balancerTag
。
::: tip 当没有匹配到任何规则时,流量默认由第一个 outbound 发出。 :::
balancers
: [ BalancerObject ]
一个数组,数组中每一项是一个负载均衡器的配置。
当一个规则指向一个负载均衡器时,Xray 会通过此负载均衡器选出一个 outbound, 然后由它转发流量。
RuleObject
{
"domainMatcher": "hybrid",
"type": "field",
"domain": ["baidu.com", "qq.com", "geosite:cn"],
"ip": ["0.0.0.0/8", "10.0.0.0/8", "fc00::/7", "fe80::/10", "geoip:cn"],
"port": "53,443,1000-2000",
"sourcePort": "53,443,1000-2000",
"network": "tcp",
"source": ["10.0.0.1"],
"user": ["love@xray.com"],
"inboundTag": ["tag-vmess"],
"protocol": ["http", "tls", "bittorrent"],
"attrs": { ":method": "GET" },
"outboundTag": "direct",
"balancerTag": "balancer"
}
::: danger 当多个属性同时指定时,这些属性需要同时满足,才可以使当前规则生效。 :::
domainMatcher
: "hybrid" | "linear"
域名匹配算法,根据不同的设置使用不同的算法。此处选项优先级高于 RoutingObject
中配置的 domainMatcher
。
"hybrid"
:使用新的域名匹配算法,速度更快且占用更少。默认值。"linear"
:使用原来的域名匹配算法。
type
: "field"
目前只支持"field"
这一个选项。
::: tip Xray-core v1.8.7 或更高版本可省略该行。 :::
domain
: [string]
一个数组,数组每一项是一个域名的匹配。有以下几种形式:
- 纯字符串:当此字符串匹配目标域名中任意部分,该规则生效。比如 "sina.com" 可以匹配 "sina.com"、"sina.com.cn" 和 "www.sina.com",但不匹配 "sina.cn"。
- 正则表达式:由
"regexp:"
开始,余下部分是一个正则表达式。当此正则表达式匹配目标域名时,该规则生效。例如 "regexp:\\.goo.*\\.com$" 匹配 "www.google.com" 或 "fonts.googleapis.com",但不匹配 "google.com"。 - 子域名(推荐):由
"domain:"
开始,余下部分是一个域名。当此域名是目标域名或其子域名时,该规则生效。例如 "domain:xray.com" 匹配 "www.xray.com"、"xray.com",但不匹配 "wxray.com"。 - 完整匹配:由
"full:"
开始,余下部分是一个域名。当此域名完整匹配目标域名时,该规则生效。例如 "full:xray.com" 匹配 "xray.com" 但不匹配 "www.xray.com"。 - 预定义域名列表:由
"geosite:"
开头,余下部分是一个名称,如geosite:google
或者geosite:cn
。名称及域名列表参考 预定义域名列表。 - 从文件中加载域名:形如
"ext:file:tag"
,必须以ext:
(小写)开头,后面跟文件名和标签,文件存放在 资源目录 中,文件格式与geosite.dat
相同,标签必须在文件中存在。
::: tip
"ext:geoip.dat:cn"
等价于 "geoip:cn"
:::
ip
: [string]
一个数组,数组内每一项代表一个 IP 范围。当某一项匹配目标 IP 时,此规则生效。有以下几种形式:
- IP:形如
"127.0.0.1"
。 - CIDR:形如
"10.0.0.0/8"
。 - 预定义 IP 列表:此列表预置于每一个 Xray 的安装包中,文件名为
geoip.dat
。使用方式形如"geoip:cn"
,必须以geoip:
(小写)开头,后面跟双字符国家代码,支持几乎所有可以上网的国家。- 特殊值:
"geoip:private"
,包含所有私有地址,如127.0.0.1
。 - 反选(!)功能,
"geoip:!cn"
表示非 geoip:cn 中的结果。
- 特殊值:
- 从文件中加载 IP:形如
"ext:file:tag"
,必须以ext:
(小写)开头,后面跟文件名和标签,文件存放在 资源目录 中,文件格式与geoip.dat
相同标签必须在文件中存在。
port
:number | string
目标端口范围,有三种形式:
"a-b"
:a 和 b 均为正整数,且小于 65536。这个范围是一个前后闭合区间,当目标端口落在此范围内时,此规则生效。a
:a 为正整数,且小于 65536。当目标端口为 a 时,此规则生效。- 以上两种形式的混合,以逗号 "," 分隔。形如:
"53,443,1000-2000"
。
sourcePort
:number | string
来源端口,有三种形式:
"a-b"
:a 和 b 均为正整数,且小于 65536。这个范围是一个前后闭合区间,当目标端口落在此范围内时,此规则生效。a
:a 为正整数,且小于 65536。当目标端口为 a 时,此规则生效。- 以上两种形式的混合,以逗号 "," 分隔。形如:
"53,443,1000-2000"
。
network
: "tcp" | "udp" | "tcp,udp"
可选的值有 "tcp"、"udp" 或 "tcp,udp",当连接方式是指定的方式时,此规则生效。
source
: [string]
一个数组,数组内每一项代表一个 IP 范围,形式有 IP、CIDR、GeoIP 和从文件中加载 IP。当某一项匹配来源 IP 时,此规则生效。
user
: [string]
一个数组,数组内每一项是一个邮箱地址。当某一项匹配来源用户时,此规则生效。
inboundTag
: [string]
一个数组,数组内每一项是一个标识。当某一项匹配入站协议的标识时,此规则生效。
protocol
: [ "http" | "tls" | "bittorrent" ]
一个数组,数组内每一项表示一种协议。当某一个协议匹配当前连接的协议类型时,此规则生效。
::: tip
必须开启入站代理中的 sniffing
选项, 才能嗅探出连接所使用的协议类型.
:::
attrs
: object
一个 json object,键名字和值皆为字符串,用于检测流量的属性值。当 HTTP headers 包含所有指定的键,并且值包含指定的子字符串,则命中此规则。键大小写不敏感。值支持使用正则表达式。
目前只有 http 入站代理会设置这一属性。
示例:
- 检测 HTTP GET:
{":method": "GET"}
- 检测 HTTP Path:
{":path": "/test"}"
- 检测 Content Type:
{"accept": "text/html"}"
outboundTag
: string
对应一个 outbound 的标识。
balancerTag
: string
对应一个 Balancer 的标识。
::: tip
balancerTag
和 outboundTag
须二选一。当同时指定时,outboundTag
生效。
:::
BalancerObject
负载均衡器配置。当一个负载均衡器生效时,它会从指定的 outbound 中,按配置选出一个最合适的 outbound,进行流量转发。
{
"tag": "balancer",
"selector": [],
"strategy": {
"type":"roundRobin"
}
}
tag
: string
此负载均衡器的标识,用于匹配 RuleObject
中的 balancerTag
。
selector
: [ string ]
一个字符串数组,其中每一个字符串将用于和 outbound 标识的前缀匹配。在以下几个 outbound 标识中:[ "a", "ab", "c", "ba" ]
,"selector": ["a"]
将匹配到 [ "a", "ab" ]
。
如果匹配到多个 outbound,负载均衡器目前会从中随机选出一个作为最终的 outbound。
strategy
: [ string ]
"type":"roundRobin"
表示按顺序选择匹配到的 outbounds tag,若不写 "strategy"
字段表示随机选择匹配到的 outbounds tag。
配置示例:
"routing": {
"rules": [
{
"inboundTag": [
"in"
],
"balancerTag": "round"
}
],
"balancers" : [
{
"selector": [
"out"
],
"strategy": {
"type":"roundRobin"
},
"tag": "round"
}
]
}
"inbounds": [
{
// 入站配置
"tag": "in"
}
]
"outbounds": [
{
// 出站配置
"tag": "out1"
},
{
// 出站配置
"tag": "out2"
}
]
预定义域名列表
此列表预置于每一个 Xray 的安装包中,文件名为 geosite.dat
。这个文件包含了一些常见的域名,使用方式:geosite:filename
,如 geosite:google
表示对文件内符合 google
内包含的域名,进行路由筛选或 DNS 筛选。
常见的域名有:
category-ads
:包含了常见的广告域名。category-ads-all
:包含了常见的广告域名,以及广告提供商的域名。cn
:相当于geolocation-cn
和tld-cn
的合集。apple
:包含了 Apple 旗下绝大部分域名。google
:包含了 Google 旗下绝大部分域名。microsoft
:包含了 Microsoft 旗下绝大部分域名。facebook
:包含了 Facebook 旗下绝大部分域名。twitter
:包含了 Twitter 旗下绝大部分域名。telegram
:包含了 Telegram 旗下绝大部分域名。geolocation-cn
:包含了常见的大陆站点域名。geolocation-!cn
:包含了常见的非大陆站点域名,同时包含了tld-!cn
。tld-cn
:包含了 CNNIC 管理的用于中国大陆的顶级域名,如以.cn
、.中国
结尾的域名。tld-!cn
:包含了非中国大陆使用的顶级域名,如以.hk
(香港)、.tw
(台湾)、.jp
(日本)、.sg
(新加坡)、.us
(美国).ca
(加拿大)等结尾的域名。
你也可以在这里查看完整的域名列表 Domain list community。