跳到主要内容

传输协议

客户端与服务端之间的物理传输协议,可选 tcp / websocket / quic,不同协议适用于不同场景。

协议对比

协议特点适用场景
TCP简单稳定,开销低,默认协议内网或网络环境可控
WebSocket基于 HTTP 升级,易穿越防火墙 / 反向代理公网受限,仅放行 80/443
QUIC基于 UDP,建连快,弱网表现更好高延迟、丢包较多的公网链路

服务端配置

# orbien-server.toml
server_port = 9527 # TCP

[transport.websocket]
enabled = true
server_port = 9528
path = "/tunnel"

[transport.quic]
enabled = true
server_port = 9529

客户端配置

全局配置

# orbien.toml
[transport]
protocol = "tcp"

TCP 传输协议

默认传输协议,强制开启

server_addr = "127.0.0.1"
server_port = 9527

WebSocket 传输协议

# orbien.toml
[transport.websocket]
server_port = 9528
path = "/tunnel"

[transport.quic]
server_port = 9529

Quic 传输协议

# orbien.toml
[transport.quic]
server_port = 9529

代理级配置

可以在代理配置中覆盖全局配置

[proxies.transport]
protocol = "websocket"

参数说明

全局 protocol

参数名类型默认值描述必填
protocolStringtcp传输协议:tcp / websocket / quic

WebSocket

参数名类型默认值描述必填
enabledBooleanfalse服务端是否开启(仅服务端)
server_portInteger9528监听 / 连接端口
pathString/tunnelWebSocket 路径
max_frame_sizeInteger10485760最大帧大小,字节(仅服务端)

QUIC

参数名类型默认值描述必填
enabledBooleanfalse服务端是否开启(仅服务端)
server_portInteger9529监听 / 连接端口
max_idle_timeout_msInteger120000空闲超时(毫秒)
initial_max_streams_bidiInteger100初始双向流数量上限
说明
  • TCP 默认开启,端口为 server_port(默认 9527)
  • QUIC 仅支持多路复用,不支持独立直连模式