mirror of
https://github.com/XTLS/Xray-docs-next.git
synced 2026-09-25 07:48:07 +03:00
80 lines
2.8 KiB
Markdown
80 lines
2.8 KiB
Markdown
# WebSocket
|
|
|
|
使用标准的 WebSocket 来传输数据。
|
|
|
|
WebSocket 连接可以被其它 HTTP 服务器（如 Nginx）分流，也可以被 VLESS fallbacks path 分流。
|
|
|
|
::: danger
|
|
**推荐换用 [XHTTP](https://github.com/XTLS/Xray-core/discussions/4113)，以避免 WebSocket “ALPN 是 http/1.1” 等显著流量特征。**
|
|
:::
|
|
|
|
::: tip
|
|
Websocket 会识别 HTTP 请求的 X-Forwarded-For 头来覆写流量的源地址，优先级高于 PROXY protocol。
|
|
:::
|
|
|
|
## WebSocketObject
|
|
|
|
`WebSocketObject` 对应 [`StreamSettingsObject`](../transport.md#streamsettingsobject) 中的 `wsSettings` 项。
|
|
|
|
```json
|
|
{
|
|
// outbound 示例，同样可用于 inbound
|
|
"outbounds": [
|
|
{
|
|
// ...
|
|
"streamSettings": {
|
|
"network": "websocket",
|
|
// [!code focus:9]
|
|
"wsSettings": {
|
|
"acceptProxyProtocol": false,
|
|
"path": "/",
|
|
"host": "xray.com",
|
|
"headers": {
|
|
"key": "value"
|
|
},
|
|
"heartbeatPeriod": 10
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
> `acceptProxyProtocol`: true | false
|
|
|
|
仅用于 inbound，指示是否接收 PROXY protocol。
|
|
|
|
[PROXY protocol](https://www.haproxy.org/download/2.2/doc/proxy-protocol.txt) 专用于传递请求的真实来源 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](../features/browser_dialer.md)
|