WebSocket

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

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

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

WebSocketObject

WebSocketObject 对应传输配置的 wsSettings 项。

{
  "acceptProxyProtocol": false,
  "path": "/",
  "headers": {
    "Host": "xray.com"
  }
}

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 参数，将会启用 Early Data 以降低延迟，其值为首包长度阈值。如果首包长度超过此值，就不会启用 Early Data。建议的值为 2048。

::: warning Early Data 使用 Sec-WebSocket-Protocol 头承载数据。如果你遇到兼容性问题，可以尝试调低阈值。 :::

headers: map {string: string}

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

默认值为空。

v2ray/discussion#754 基于一年前的想法，原生 JS 实现了简洁的 WSS Browser Dialer，真实浏览器的 TLS 指纹、行为特征。

不过 WSS 仍存在 ALPN 明显的问题，所以下一步是浏览器转发 HTTP/2、QUIC。

创造了一个非常简单、巧妙的通信机制：

根据浏览器的需求，对 early data 机制进行了如下调整：

服务端响应头会带有请求的 Sec-WebSocket-Protocol，这也初步混淆了 WSS 握手响应的长度特征。
用于浏览器的 early data 编码是 base64.RawURLEncoding 而不是 StdEncoding，服务端做了兼容。
此外，由于 #375 推荐 ?ed=2048，这个 PR 顺便将服务端一处 MaxHeaderBytes 扩至了 4096。 ~~（虽然好像不改也没问题）~~

这是一个探索的过程，目前两边都是 Xray-core v1.4.1 时的配置方式：