2.9 KiB
SplitHTTP
使用HTTP分块传输编码下载,使用多个HTTP POST请求进行上传。
可以通过不支持WebSocket的CDN上,但仍有一些要求:
-
CDN必须支持HTTP分块传输,而且不会缓冲响应,核心将会发送
X-Accel-Buffering: no
以告知CDN,但是需要CDN遵守此标头。如果连接被挂起,该传输很可能无法工作
-
CDN必须禁用缓存, 或者缓存查询字符串包含查询字符串。
上行效率可能非常有限
SplitHTTP
也接受 X-Forwarded-For
header。
SplitHttpObject
The SplitHttpObject
对应传输配置的 splithttpSettings
项。
{
"path": "/",
"host": "xray.com",
"headers": {
"key": "value"
}
}
path
: string
WebSocket 所使用的 HTTP 协议路径,默认值为 "/"
。
host
: string
WebSocket 的HTTP请求中所发送的host,默认值为空。若服务端值为空时,不验证客户端发送来的host值。
当在服务端指定该值,或在 headers
中指定host,将会校验与客户端请求host是否一致。
客户端选择发送的host优先级 host
> headers
> address
headers
: map {string: string}
自定义 HTTP 头,一个键值对,每个键表示一个 HTTP 头的名称,对应的值是字符串。
maxUploadSize
: int
上传分块的最大大小,默认为 1 MB.
这个值应该小于CDN或其他HTTP反向代理所允许的最大请求体,否则将抛出 HTTP 413 错误。
适当提升这个值可以增加上传速率。
maxConcurrentUploads
: int
上传连接的最大并发数,默认为10, 连接将尽可能被重用。
如果连接不稳定或者服务端内存占用过高可以尝试调低。
客户端所设定的值必须低于服务端,否则可能导致连接问题。
已知问题
- ALPN 协商仍未正确实现,HTTPS连接将总是使用H2.
协议细节
讨论与建议详见 PR,这里是实现简述。
-
使用
GET /?session=UUID
打开一个新的“虚拟”流连接。服务器立即回复200 OK
和Transfer Encoding:chunked
, 并立即发送一个两字节的有效负载,以强制HTTP中间盒刷新标头。 -
一旦客户端完成协商,它可以使用
POST /?session=UUID?seq=0
开始发送上行数据.seq
作用类似于 TCP 序列号, 数据包可以被同时发送,服务端必须按序列号将数据重组。序列号不会重置 -
GET
请求将一直保持在打开状态直到连接被终止,服务端和客户端都可以关闭连接。具体行为取决于HTTP版本
建议:
-
不要假设CDN会正确传输所有标头,这个协议是为了穿透不支持WS的CDN设计的,这些CDN的架构通常不怎么友好。
-
应该假设所有HTTP连接都没有流式传输,所以每个包的大小应该基于延迟、吞吐量以及中间盒本身的限制考虑(类似TCP的MTU与纳格算法)。