Skip to content

Commit 6c4fafc

Browse files
authored
Make proxySettings clearer (#780)
1 parent e538803 commit 6c4fafc

File tree

1 file changed

+20
-19
lines changed

1 file changed

+20
-19
lines changed

docs/config/outbound.md

Lines changed: 20 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,8 @@
2020
"tag": "标识",
2121
"streamSettings": {},
2222
"proxySettings": {
23-
"tag": "another-outbound-tag"
23+
"tag": "another-outbound-tag",
24+
"transportLayer": false
2425
},
2526
"mux": {}
2627
}
@@ -32,16 +33,16 @@
3233
3334
用于发送数据的 IP 地址,当主机有多个 IP 地址时有效,默认值为 `"0.0.0.0"`
3435

35-
允许在其中填入 IPv6 CIDR 块(如114:514:1919:810::/64),Xray将会使用地址块中随机的IP地址对外发起连接
36-
需要正确配置网络接入方式,路由表以及内核参数以允许 Xray bind 至地址块内的任意IP
36+
允许在其中填入 IPv6 CIDR 块 (如 114:514:1919:810::/64),Xray 将会使用地址块中随机的 IP 地址对外发起连接
37+
需要正确配置网络接入方式,路由表以及内核参数以允许 Xray bind 至地址块内的任意 IP
3738

38-
对于使用ndp接入的网络,不建议设置小于 /120 的子网,否则可能会造成 NDP flood 导致路由器邻居缓存被占满等一系列问题。
39+
对于使用 ndp 接入的网络,不建议设置小于 /120 的子网,否则可能会造成 NDP flood 导致路由器邻居缓存被占满等一系列问题。
3940

40-
特殊值 `origin` 若使用该值,将使用本机被连接的IP发出请求
41+
特殊值 `origin` 若使用该值,将使用本机被连接的 IP 发出请求
4142

42-
例如机器上存在一整段 IPv4 `11.4.5.0/24` 且监听 0.0.0.0(网卡上的全部IPv4与IPv6),若客户端通过 `11.4.5.14` 连接到本机,那么出站也会通过 `11.4.5.14` 发送对外请求;如果使用 `11.4.5.10` 连接到本机,那么出站就会通过 `11.4.5.10` 发送请求。 同样适用于机器上有整段/复数个 IPv6 的情况。
43+
例如机器上存在一整段 IPv4 `11.4.5.0/24` 且监听 0.0.0.0 (网卡上的全部 IPv4 与 IPv6),若客户端通过 `11.4.5.14` 连接到本机,那么出站也会通过 `11.4.5.14` 发送对外请求;如果使用 `11.4.5.10` 连接到本机,那么出站就会通过 `11.4.5.10` 发送请求。 同样适用于机器上有整段/复数个 IPv6 的情况。
4344

44-
和入站介绍的一样,因为 UDP 的无连接特性 Xray 无从得知这个请求进入核心的原目标IP(举个例子,在同一个 QUIC 连接里它甚至可能变动),所以这个功能无法生效。
45+
和入站介绍的一样,因为 UDP 的无连接特性 Xray 无从得知这个请求进入核心的原目标 IP (举个例子,在同一个 QUIC 连接里它甚至可能变动),所以这个功能无法生效。
4546

4647
> `protocol`: "blackhole" | "dns" | "freedom" | "http" | "loopback" | "shadowsocks" | "socks" | "trojan" | "vless" | "vmess" | "wireguard"
4748
@@ -61,11 +62,11 @@
6162

6263
> `streamSettings`: [StreamSettingsObject](./transport.md#streamsettingsobject)
6364
64-
底层传输方式(transport)是当前 Xray 节点和其它节点对接的方式
65+
底层传输方式(transport)是当前 Xray 节点和其它节点对接的方式
6566

6667
> `proxySettings`: [ProxySettingsObject](#proxysettingsobject)
6768
68-
出站代理配置。当出站代理生效时,此 outbound 的 `streamSettings` 将不起作用。
69+
出站代理配置。
6970

7071
> `mux`: [MuxObject](#muxobject)
7172
@@ -75,7 +76,8 @@ Mux 相关的具体配置。
7576

7677
```json
7778
{
78-
"tag": "another-outbound-tag"
79+
"tag": "another-outbound-tag",
80+
"transportLayer": false
7981
}
8082
```
8183

@@ -84,16 +86,15 @@ Mux 相关的具体配置。
8486
当指定另一个 outbound 的标识时,此 outbound 发出的数据,将被转发至所指定的 outbound 发出。
8587

8688
::: danger
87-
这种转发方式**不经过**底层传输方式。如果需要使用支持底层传输方式的转发,请使用 [SockOpt.dialerProxy](./transport.md#sockoptobject)
88-
:::
89+
此选项与 [SockOpt.dialerProxy](./transport.md#sockoptobject) 冲突,根据需要任选其一即可。
8990

90-
::: danger
91-
此选项与 SockOpt.dialerProxy 不兼容
91+
默认情况下,这种转发方式**不经过**底层传输方式 (REALITY/XHTTP/gRPC...),也就是此 outbound 的 `streamSettings` 将不起作用。<br>
92+
如果需要使用支持底层传输方式的转发,请改用 `SockOpt.dialerProxy` 或者将 `transportLayer` 设为 `true`
9293
:::
9394

94-
::: tip
95-
兼容 v2fly/v2ray-core 的配置 [transportLayer](https://www.v2fly.org/config/outbounds.html#proxysettingsobject)
96-
:::
95+
> `transportLayer`: true | false
96+
97+
`true` 将此设置转化为 `SockOpt.dialerProxy` 来支持底层传输方式的转发,默认为 `false` 即不转化。
9798

9899
### MuxObject
99100

@@ -116,11 +117,11 @@ Mux 功能是在一条 TCP 连接上分发多个 TCP 连接的数据。实现细
116117

117118
> `concurrency`: number
118119
119-
最大并发连接数。最小值 `1`,最大值 `128`。省略或者填 `0` 时都等于 `8`, 大于`128` 的值都将视为128.
120+
最大并发连接数。最小值 `1`,最大值 `128`。省略或者填 `0` 时都等于 `8`, 大于 `128` 的值都将视为 128。
120121

121122
这个数值表示了一个 TCP 连接上最多承载的子连接数量。比如设置 `concurrency=8` 时,当客户端发出了 8 个 TCP 请求,Xray 只会发出一条实际的 TCP 连接,客户端的 8 个请求全部由这个 TCP 连接传输。
122123

123-
核心并不会回收关闭子连接id, 这意味着这其实是一个连接最大可以被复用的次数,比方说如果设置为 16, 如果该连接已经被复用了 16 次,其中 10 条已经关闭了,这并不会为该连接“腾出”十个位置,核心仍会认为该连接复用次数已满并打开新的连接
124+
核心并不会回收关闭子连接 id, 这意味着这其实是一个连接最大可以被复用的次数,比方说如果设置为 16, 如果该连接已经被复用了 16 次,其中 10 条已经关闭了,这并不会为该连接“腾出”十个位置,核心仍会认为该连接复用次数已满并打开新的连接
124125

125126
::: tip
126127
填负数时,如 `-1`,不使用 Mux 模块承载 TCP 流量。

0 commit comments

Comments
 (0)