XHTTP: Beyond REALITY

XTLS/Xray-core#4113

Author: RPRX

docs/.vuepress/config/sidebar/en.ts

@@ -63,13 +63,12 @@ export const sidebarEn: SidebarConfig = {
     {
       text: 'transport',
       children: [
-        '/en/config/transports/grpc.md',
-        '/en/config/transports/h2.md',
+        '/en/config/transports/raw.md',
+        '/en/config/transports/xhttp.md',
         '/en/config/transports/mkcp.md',
-        '/en/config/transports/tcp.md',
+        '/en/config/transports/grpc.md',
         '/en/config/transports/websocket.md',
         '/en/config/transports/httpupgrade.md',
-        '/en/config/transports/splithttp.md'
       ],
     },
   ],

docs/.vuepress/config/sidebar/ru.ts

@@ -63,13 +63,12 @@ export const sidebarRu: SidebarConfig = {
     {
       text: 'Транспортный уровень',
       children: [
-        '/ru/config/transports/grpc.md',
-        '/ru/config/transports/http.md',
-        '/ru/config/transports/mkcp.md',
         '/ru/config/transports/raw.md',
+        '/ru/config/transports/xhttp.md',
+        '/ru/config/transports/mkcp.md',
+        '/ru/config/transports/grpc.md',
         '/ru/config/transports/websocket.md',
         '/ru/config/transports/httpupgrade.md',
-        '/ru/config/transports/splithttp.md'
       ],
     },
   ],

docs/.vuepress/config/sidebar/zh.ts

@@ -63,13 +63,12 @@ export const sidebarZh: SidebarConfig = {
     {
       text: '底层传输',
       children: [
-        '/config/transports/grpc.md',
-        '/config/transports/http.md',
-        '/config/transports/mkcp.md',
         '/config/transports/raw.md',
+        '/config/transports/xhttp.md',
+        '/config/transports/mkcp.md',
+        '/config/transports/grpc.md',
         '/config/transports/websocket.md',
         '/config/transports/httpupgrade.md',
-        '/config/transports/splithttp.md'
       ],
     },
   ],

docs/config/features/browser_dialer.md

@@ -11,7 +11,7 @@
 不过目前的浏览器转发有以下缺点：
 * 用户需要手动开浏览器
 * 浏览器发出的连接必须直连 使用 tun 的用户需要特别注意容易形成死循环
-* 浏览器只能发出 HTTP 连接 所以目前仅支持 [WebSocket](../../transports/websocket.md) 与 [XHTTP](../../transports/splithttp.md) 传输方式
+* 浏览器只能发出 HTTP 连接 所以目前仅支持 [WebSocket](../../transports/websocket.md) 与 [XHTTP](https://github.com/XTLS/Xray-core/discussions/4113) 传输方式
 * 当浏览器从 `localhost:8080` 页面连接至代理服务端，需要考虑 [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)
 * 因为中间经过 JS 处理数据，会有一些性能损耗
 * 不能使用自定义 SNI 或者 Host，也就是说 `SNI == host == address`。自定义 HTTP 头以及其它 `tlsSettings` 项会被忽略
@@ -44,6 +44,6 @@
 
 <Badge text="v1.8.19+" type="warning"/>
 
-XHTTP 本身支持 QUIC，如果想使用浏览器自己的 QUIC 网络栈，Chrome 可以在 `chrome://flags` 中设定。其它浏览器也有相关选项。
+[XHTTP](https://github.com/XTLS/Xray-core/discussions/4113) 本身支持 QUIC，如果想使用浏览器自己的 QUIC 网络栈，Chrome 可以在 `chrome://flags` 中设定。其它浏览器也有相关选项。
 
 原理上说 `tlsSettings` 项会被忽略，使用哪个 HTTP 版本将完全由浏览器决定。

docs/config/transport.md

@@ -10,17 +10,16 @@
 
 ```json
 {
-  "network": "tcp",
+  "network": "raw",
   "security": "none",
   "tlsSettings": {},
   "realitySettings": {},
-  "tcpSettings": {},
+  "rawSettings": {},
+  "xhttpSettings": {},
   "kcpSettings": {},
-  "wsSettings": {},
-  "httpSettings": {},
   "grpcSettings": {},
+  "wsSettings": {},
   "httpupgradeSettings": {},
-  "xhttpSettings": {},
   "sockopt": {
     "mark": 0,
     "tcpMaxSeg": 1440,
@@ -42,16 +41,12 @@
 }
 ```
 
-> `network`: "raw" | "ws" | "h2" | "grpc" | "kcp" | "httpupgrade" | "xhttp"
+> `network`: "raw" | "xhttp" | "kcp" | "grpc" | "ws" | "httpupgrade"
 
-连接的数据流所使用的传输方式类型，默认值为 `"raw"`
+连接的数据流所使用的传输方式类型，默认值为 `"raw"`。
 
 ::: tip
-v24.9.30 版本后，为了更贴近实际行为，tcp传输方式已更名为raw, 为了兼容性，`"network": "raw"` 和 "network": "tcp", `rawSettings`和`tcpSettings` 互为别名
-:::
-
-::: tip
-"h2" 可以写成 "http"，"grpc" 可以写成 "gun"，"kcp" 可以写成 "mkcp"。
+After v24.9.30, the TCP transport has been renamed to RAW to more closely match actual behavior. `"network": "raw"` and `"network": "tcp"`, `rawSettings` and `tcpSettings` are aliases for each other for compatibility.
 :::
 
 > `security`: "none" | "tls" | "reality"
@@ -75,34 +70,30 @@ Reality 是目前最安全的传输加密方案, 且外部看来流量类型和
 达到数倍甚至十几倍的性能提升。
 :::
 
-> `rawSettings`: [TcpObject](./transports/raw.md)
+> `rawSettings`: [RawObject](./transports/raw.md)
 
-当前连接的 raw 配置，仅当此连接使用 raw 时有效。
+当前连接的 RAW 配置，仅当此连接使用 RAW 时有效。
 
-> `kcpSettings`: [KcpObject](./transports/mkcp.md)
+> `xhttpSettings`: [XHTTP: Beyond REALITY](https://github.com/XTLS/Xray-core/discussions/4113)
 
-当前连接的 mKCP 配置，仅当此连接使用 mKCP 时有效。
+当前连接的 XHTTP 配置，仅当此连接使用 XHTTP 时有效。
 
-> `wsSettings`: [WebSocketObject](./transports/websocket.md)
+> `kcpSettings`: [KcpObject](./transports/mkcp.md)
 
-当前连接的 WebSocket 配置，仅当此连接使用 WebSocket 时有效。
+当前连接的 mKCP 配置，仅当此连接使用 mKCP 时有效。
 
-> `httpSettings`: [HttpObject](./transports/http.md)
+> `grpcSettings`: [GRPCObject](./transports/grpc.md)
 
-当前连接的 HTTP 配置，仅当此连接使用 HTTP 时有效。
+当前连接的 gRPC 配置，仅当此连接使用 gRPC 时有效。
 
-> `grpcSettings`: [GRPCObject](./transports/grpc.md)
+> `wsSettings`: [WebSocketObject](./transports/websocket.md)
 
-当前连接的 gRPC 配置，仅当此连接使用 gRPC 时有效。。
+当前连接的 WebSocket 配置，仅当此连接使用 WebSocket 时有效。
 
 > `httpupgradeSettings`: [HttpUpgradeObject](./transports/httpupgrade.md)
 
 当前连接的 HTTPUpgrade 配置，仅当此连接使用 HTTPUpgrade 时有效。
 
-> `xhttpSettings`: [XHttpObject](./transports/splithttp.md)
-
-当前连接的 XHTTP 配置，仅当此连接使用 XHTTP 时有效。
-
 > `sockopt`: [SockoptObject](#sockoptobject)
 
 透明代理相关的具体配置。

docs/config/transports/grpc.md

@@ -5,6 +5,10 @@
 它基于 HTTP/2 协议，理论上可以通过其它支持 HTTP/2 的服务器（如 Nginx）进行中转。
 gRPC（HTTP/2）内置多路复用，不建议使用 gRPC 与 HTTP/2 时启用 mux.cool。
 
+::: danger
+**推荐换用 [XHTTP](https://github.com/XTLS/Xray-core/discussions/4113)，其相较于 gRPC 的优势已在 STREAM-UP/ONE 小节中注明。**
+:::
+
 ::: warning ⚠⚠⚠
 
 - gRPC 不支持指定 Host。请在出站代理地址中填写 **正确的域名** ，或在 `(x)tlsSettings` 中填写 `ServerName`，否则无法连接。

docs/config/transports/h2.md

@@ -0,0 +1,3 @@
+# HTTP/2
+
+See [XHTTP: Beyond REALITY](https://github.com/XTLS/Xray-core/discussions/4113)

docs/config/transports/http.md

@@ -1,87 +1,3 @@
 # HTTP
 
-基于 HTTP/2 或 HTTP/3 的传输方式。
-
-它完整按照 HTTP 标准实现，可以通过其它的 HTTP 服务器（如 Nginx）进行中转。
-
-客户端必须开启 TLS 才可以正常使用这个传输方式。
-
-HTTP/2和3 内置多路复用，不建议使用时启用 mux.cool。
-
-::: tip
-当前版本的 HTTP/2 的传输方式并不强制要求**入站**（**服务端**）有 TLS 配置.
-这使得可以在特殊用途的分流部署环境中，由外部网关组件完成 TLS 层对话，Xray 作为后端应用，网关和 Xray 间使用明文HTTP进行通讯。
-:::
-
-::: tip
-当alpn有且仅有 `h3` 时，该传输才会工作在h3模式。
-:::
-
-::: warning
-- HTTP/2 和 HTTP/3 无法通过xray的回落 Path 进行分流，不建议使用回落分流。
-  :::
-
-## HttpObject
-
-`HttpObject` 对应传输配置的 `httpSettings` 项。
-
-```json
-{
-  "host": ["xray.com"],
-  "path": "/random/path",
-  "read_idle_timeout": 10,
-  "health_check_timeout": 15,
-  "method": "PUT",
-  "headers": {
-    "Header": ["value"]
-  }
-}
-```
-
-> `host`: \[string\]
-
-一个字符串数组，每一个元素是一个域名。
-
-客户端会随机从列表中选出一个域名进行通信，服务器会验证域名是否在列表中。
-
-::: tip
-若不写 `"httpSettings"` 或 `"host": []` 值留空时，会使用默认值 `"www.example.com"`，需要两端 `"host"` 值一致才能连接成功。`"host": [""]` 不是值留空。
-:::
-
-> `path`: string
-
-HTTP 路径，由 `/` 开头, 客户端和服务器必须一致。
-
-默认值为 `"/"`。
-
-> `read_idle_timeout`: number
-
-单位秒，当这段时间内没有接收到数据时，将会进行健康检查。
-
-健康检查默认**不启用**。
-
-::: tip
-**只需**在**出站**（**客户端**）配置。
-:::
-
-::: tip
-可能会解决一些“断流”问题。
-:::
-
-> `health_check_timeout`: number
-
-单位秒，健康检查的超时时间。如果在这段时间内没有完成健康检查，即认为健康检查失败。默认值为 `15`。
-
-::: tip
-**只需**在**出站**（**客户端**）配置。
-:::
-
-> `method`: string
-
-HTTP 方法。默认值为 `"PUT"`。
-
-设置时应参照[此处](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods)列出值。
-
-> `headers`: map{ string: \[string\] }
-
-仅客户端，自定义 HTTP 头，一个键值对，每个键表示一个 HTTP 头名称，对应值为一个数组。
+See [XHTTP: Beyond REALITY](https://github.com/XTLS/Xray-core/discussions/4113)

docs/config/transports/httpupgrade.md

@@ -3,6 +3,10 @@
 一个实现了类似于 WebSocket 进行 HTTP 1.1 升级请求和响应的协议，这使得它可以像 WebSocket 一样可以被CDN或者Nginx进行反代，但无需实现 WebSocket 协议的其他部分，所以具有更高的效率。
 其设计不推荐单独使用，而是和TLS等安全协议一起工作。
 
+::: danger
+**推荐换用 [XHTTP](https://github.com/XTLS/Xray-core/discussions/4113)，以避免 HTTPUpgrade “ALPN 是 http/1.1” 等显著流量特征。**
+:::
+
 ## HttpUpgradeObject
 
 `HttpUpgradeObject` 对应传输配置的 `httpupgradeSettings` 项。

docs/config/transports/raw.md

@@ -1,8 +1,8 @@
 # RAW
 
-更名自曾经的tcp传输(原名称稍有歧义) RAW传输出站发送的原始数据，核心不使用其他协议(如 websocket)承载其流量。
+更名自曾经的 TCP 传输（原名称有歧义），RAW 传输出站发送原始数据，核心不使用其它协议（如 XHTTP）承载其流量。
 
-可以和各种协议有多种组合模式.
+可以和各种协议有多种组合模式。
 
 ## RawObject