mirror of
https://github.com/XTLS/Xray-docs-next.git
synced 2026-09-25 15:58:17 +03:00
157 lines
6.7 KiB
Markdown
157 lines
6.7 KiB
Markdown
# 出站代理（Mux、XUDP）
|
||
|
||
出站连接用于发送数据，可用的协议请见 [出站协议](./outbounds/)。
|
||
|
||
## OutboundObject
|
||
|
||
`OutboundObject` 对应配置文件中 `outbounds` 项的一个子元素。
|
||
|
||
::: tip
|
||
列表中的第一个元素作为主 outbound。当路由匹配不存在或没有匹配成功时，流量由主 outbound 发出。
|
||
:::
|
||
|
||
```json
|
||
{
|
||
"outbounds": [
|
||
{
|
||
"sendThrough": "0.0.0.0",
|
||
"protocol": "协议名称",
|
||
"settings": {},
|
||
"tag": "标识",
|
||
"streamSettings": {},
|
||
"proxySettings": {
|
||
"tag": "another-outbound-tag",
|
||
"transportLayer": false
|
||
},
|
||
"mux": {},
|
||
"targetStrategy": "AsIs"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
> `sendThrough`: address
|
||
|
||
用于发送数据的 IP 地址，当主机有多个 IP 地址时有效，默认值为 `"0.0.0.0"`。
|
||
|
||
允许在其中填入 IPv6 CIDR 块 (如 114:514:1919:810::/64)，Xray 将会使用地址块中随机的 IP 地址对外发起连接。
|
||
需要正确配置网络接入方式，路由表以及内核参数以允许 Xray bind 至地址块内的任意 IP。
|
||
|
||
对于使用 ndp 接入的网络，不建议设置小于 /120 的子网，否则可能会造成 NDP flood 导致路由器邻居缓存被占满等一系列问题。
|
||
|
||
特殊值 `origin` 若使用该值，将使用本机被连接的 IP 发出请求。
|
||
|
||
例如机器上存在一整段 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 的情况。
|
||
|
||
和入站介绍的一样，因为 UDP 的无连接特性 Xray 无从得知这个请求进入核心的原目标 IP (举个例子，在同一个 QUIC 连接里它甚至可能变动)，所以这个功能无法生效。
|
||
|
||
> `protocol`: "blackhole" | "dns" | "freedom" | "http" | "loopback" | "shadowsocks" | "socks" | "trojan" | "vless" | "vmess" | "wireguard"
|
||
|
||
连接协议名称，可选的协议列表见左侧 [出站协议](./outbounds/)。
|
||
|
||
> `settings`: OutboundConfigurationObject
|
||
|
||
具体的配置内容，视协议不同而不同。详见每个协议中的 `OutboundConfigurationObject`。
|
||
|
||
> `tag`: string
|
||
|
||
此出站连接的标识，用于在其它的配置中定位此连接。
|
||
|
||
::: danger
|
||
当其不为空时，其值必须在所有 `tag` 中 **唯一**。
|
||
:::
|
||
|
||
> `streamSettings`: [StreamSettingsObject](./transport.md#streamsettingsobject)
|
||
|
||
底层传输方式（transport）是当前 Xray 节点和其它节点对接的方式。
|
||
|
||
> `proxySettings`: [ProxySettingsObject](#proxysettingsobject)
|
||
|
||
出站代理配置。
|
||
|
||
> `mux`: [MuxObject](#muxobject)
|
||
|
||
Mux 相关的具体配置。
|
||
|
||
> `targetStrategy`: "AsIs" | "UseIP" | "UseIPv6v4" | "UseIPv6" | "UseIPv4v6" | "UseIPv4" | "ForceIP" | "ForceIPv6v4" | "ForceIPv6" | "ForceIPv4v6" | "ForceIPv4"
|
||
|
||
如果此出站尝试发送一个域名请求，控制其是否被解析/如何解析为 IP 并发送。
|
||
|
||
默认值为 `AsIs` 即保持原样发送到远端服务器。所有参数含义均约等于 [sockopt](./transport.md#sockoptobject) 中的 `domainStrategy`。
|
||
|
||
::: tip
|
||
这里控制的是**被代理的请求**，如果出站代理服务器的地址是域名，并需要为这个域名本身选择解析策略，则应配置 [sockopt](./transport.md#sockoptobject) 中的 `domainStrategy`。
|
||
:::
|
||
|
||
### ProxySettingsObject
|
||
|
||
```json
|
||
{
|
||
"tag": "another-outbound-tag",
|
||
"transportLayer": false
|
||
}
|
||
```
|
||
|
||
> `tag`: string
|
||
|
||
当指定另一个 outbound 的标识时，此 outbound 发出的数据，将被转发至所指定的 outbound 发出。
|
||
|
||
::: danger
|
||
此选项与 [SockOpt.dialerProxy](./transport.md#sockoptobject) 冲突，根据需要任选其一即可。
|
||
|
||
默认情况下，这种转发方式**不经过**底层传输方式 (REALITY/XHTTP/gRPC...)，也就是此 outbound 的 `streamSettings` 将不起作用。<br>
|
||
如果需要使用支持底层传输方式的转发，请改用 `SockOpt.dialerProxy` 或者将 `transportLayer` 设为 `true`。
|
||
:::
|
||
|
||
> `transportLayer`: true | false
|
||
|
||
`true` 将此设置转化为 `SockOpt.dialerProxy` 来支持底层传输方式的转发，默认为 `false` 即不转化。
|
||
|
||
### MuxObject
|
||
|
||
Mux 功能是在一条 TCP 连接上分发多个 TCP 连接的数据。实现细节详见 [Mux.Cool](../development/protocols/muxcool.md)。Mux 是为了减少 TCP 的握手延迟而设计，而非提高连接的吞吐量。使用 Mux 看视频、下载或者测速通常都有反效果。Mux 只需要在客户端启用，服务器端自动适配。Mux 的第二个用途是分发多个 UDP 连接，即 XUDP。
|
||
|
||
`MuxObject` 对应 `OutboundObject` 中的 `mux` 项。
|
||
|
||
```json
|
||
{
|
||
"enabled": true,
|
||
"concurrency": 8,
|
||
"xudpConcurrency": 16,
|
||
"xudpProxyUDP443": "reject"
|
||
}
|
||
```
|
||
|
||
> `enabled`: true | false
|
||
|
||
是否启用 Mux 转发请求，默认值 `false`。
|
||
|
||
> `concurrency`: number
|
||
|
||
最大并发连接数。最小值 `1`，最大值 `128`。省略或者填 `0` 时都等于 `8`, 大于 `128` 的值都将视为 128, 因为当一个连接达到最大复用次数 128 后其将不会再被分配任何新的子连接。
|
||
|
||
这个数值表示了一个 TCP 连接上最多承载的子连接数量。比如设置 `concurrency=8` 时，当客户端发出了 8 个 TCP 请求，Xray 只会发出一条实际的 TCP 连接，客户端的 8 个请求全部由这个 TCP 连接传输。
|
||
|
||
当全部 Mux 连接的最大子连接连接都已被占满，核心将发出新的连接承载子连接。如果短时间内并发大量子连接后续逐渐减少，核心内部调度器将倾向于将请求分配至 2 个连接交替使用并闲置其他连接等待它们的所有子连接自然结束后将其关闭以节约资源。如果总子连接数继续长时间低于 `concurrency` 则在其中一条达到最大复用次数后核心将回到单连接状态。
|
||
|
||
::: tip
|
||
填负数时，如 `-1`，不使用 Mux 模块承载 TCP 流量。
|
||
:::
|
||
|
||
> `xudpConcurrency`: number
|
||
|
||
使用新 XUDP 聚合隧道（也就是另一条 Mux 连接）代理 UDP 流量，填写最大并发子 UoT 数量。最小值 `1`，最大值 `1024`。
|
||
省略或者填 `0` 时，将与 TCP 流量走同一条路，也就是传统的行为。
|
||
|
||
::: tip
|
||
填负数时，如 `-1`，不使用 Mux 模块承载 UDP 流量。将使用代理协议原本的 UDP 传输方式。例如 `Shadowsocks` 会使用原生 UDP，`VLESS` 会使用 UoT。
|
||
:::
|
||
|
||
> `xudpProxyUDP443`: string
|
||
|
||
控制 Mux 对于被代理的 UDP/443（QUIC）流量的处理方式：
|
||
|
||
- 默认 `reject` 拒绝流量（一般浏览器会自动回落到 TCP HTTP2）
|
||
- `allow` 允许走 Mux 连接。
|
||
- 填 `skip` 时，不使用 Mux 模块承载 UDP 443 流量。将使用代理协议原本的 UDP 传输方式。例如 `Shadowsocks` 会使用原生 UDP，`VLESS` 会使用 UoT。
|