Files
XTLS_Xray-docs-next/docs/config/outbound.md
T

5.9 KiB
Raw Blame History

出站代理(Mux、XUDP

出站连接用于发送数据,可用的协议请见 出站协议

OutboundObject

OutboundObject 对应配置文件中 outbounds 项的一个子元素。

::: tip 列表中的第一个元素作为主 outbound。当路由匹配不存在或没有匹配成功时,流量由主 outbound 发出。 :::

{
  "outbounds": [
    {
      "sendThrough": "0.0.0.0",
      "protocol": "协议名称",
      "settings": {},
      "tag": "标识",
      "streamSettings": {},
      "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 发出请求。

特殊值 srcip 若使用该值,将使用入站时的源 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" | "hysteria" | "wireguard"

连接协议名称,可选的协议列表见左侧 出站协议

settings: OutboundConfigurationObject

具体的配置内容,视协议不同而不同。详见每个协议中的 OutboundConfigurationObject

tag: string

此出站连接的标识,用于在其它的配置中定位此连接。

::: danger 当其不为空时,其值必须在所有 tag唯一。 :::

streamSettings: StreamSettingsObject

此出站的传输配置。

mux: MuxObject

Mux 相关的具体配置。

targetStrategy: "AsIs" | "UseIP" | "UseIPv6v4" | "UseIPv6" | "UseIPv4v6" | "UseIPv4" | "ForceIP" | "ForceIPv6v4" | "ForceIPv6" | "ForceIPv4v6" | "ForceIPv4"

适用于 Freedom 以外的出站,控制被代理请求中的目标域名是否在本地解析为 IP,以及使用何种解析策略。

默认值为 AsIs,即保持目标域名原样发送到远端服务器。各策略的含义与 sockopt 中的 domainStrategy 基本相同。

::: tip 这里控制的是被代理的请求,如果出站代理服务器的地址是域名,并需要为这个域名本身选择解析策略,则应配置 sockopt 中的 domainStrategy

Freedom 出站的域名解析策略也应配置 sockopt.domainStrategy。 :::

MuxObject

Mux 功能是在一条 TCP 连接上分发多个 TCP 连接的数据。实现细节详见 Mux.Cool。Mux 是为了减少 TCP 的握手延迟而设计,而非提高连接的吞吐量。使用 Mux 看视频、下载或者测速通常都有反效果。Mux 只需要在客户端启用,服务器端自动适配。Mux 的第二个用途是分发多个 UDP 连接,即 XUDP。

MuxObject 对应 OutboundObject 中的 mux 项。

{
  "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 会使用原生 UDPVLESS 会使用 UoT。 :::

xudpProxyUDP443: string

控制 Mux 对于被代理的 UDP/443(QUIC)流量的处理方式:

  • 默认 reject 拒绝流量(一般浏览器会自动回落到 TCP HTTP2)
  • allow 允许走 Mux 连接。
  • skip 时,不使用 Mux 模块承载 UDP 443 流量。将使用代理协议原本的 UDP 传输方式。例如 Shadowsocks 会使用原生 UDPVLESS 会使用 UoT。