WebSocket

使用标准的 WebSocket 来传输数据。

WebSocket 连接可以被其它 HTTP 服务器（如 Nginx）分流，也可以被 VLESS fallbacks path 分流。

警告

推荐换用 XHTTP，以避免 WebSocket “ALPN 是 http/1.1” 等显著流量特征。

提示

Websocket 会识别 HTTP 请求的 X-Forwarded-For 头来覆写流量的源地址，优先级高于 PROXY protocol。

WebSocketObject

WebSocketObject 对应传输配置的 wsSettings 项。

{
  "acceptProxyProtocol": false,
  "path": "/",
  "host": "xray.com",
  "headers": {
    "key": "value"
  },
  "heartbeatPeriod": 10
}

acceptProxyProtocol: true | false

仅用于 inbound，指示是否接收 PROXY protocol。

PROXY protocol 专用于传递请求的真实来源 IP 和端口，若你不了解它，请先忽略该项。

常见的反代软件（如 HAProxy、Nginx）都可以配置发送它，VLESS fallbacks xver 也可以发送它。

填写 true 时，最底层 TCP 连接建立后，请求方必须先发送 PROXY protocol v1 或 v2，否则连接会被关闭。

path: string

WebSocket 所使用的 HTTP 协议路径，默认值为 "/"。

如果客户端路径中包含 ed 参数(如 /mypath?ed=2560)，将会启用 Early Data 以降低延迟，在升级的同时使用 Sec-WebSocket-Protocol 头承载首包数据，其值为首包长度阈值。如果首包长度超过此值，就不会启用 Early Data。推荐值为 2560，最大值为8192，过大的值可能导致部分兼容问题，如果遇到兼容性问题，可以尝试调低阈值。

host: string

WebSocket 的HTTP请求中所发送的host，默认值为空。若服务端值为空时，不验证客户端发送来的host值。

当在服务端指定该值，或在 headers 中指定host，将会校验与客户端请求host是否一致。

客户端选择发送的host优先级 host > headers > address

headers: map {string: string}

仅客户端，自定义 HTTP 头，一个键值对，每个键表示一个 HTTP 头的名称，对应的值是字符串。

默认值为空。

heartbeatPeriod: int

指定间隔固定时间发送一个 Ping message 保活连接。不指定或指定为0时不发送 Ping message，为当前默认行为。

Browser Dialer

使用浏览器处理 TLS，详见 Browser Dialer