Skip to content
English下载

传输层 ​

传输层把 VMess 或 VLESS 连接包进另一种载体,通常是为了穿过只转发网页流量的 CDN 或反向代理。 它是代理上的 transport 内联表:

toml
[[proxy]]
name = "vmess-ws"
type = "vmess"
server = "proxy.example.org"
port = 443
uuid = "e6e1acfe-5b1e-4b1c-87c8-92beecb98ba2"
tls = { server-name = "proxy.example.org" }
transport = { type = "ws", host = "proxy.example.org", path = "/ws" }

客户端和服务端的传输层类型、路径和服务名必须一致。

哪些代理使用 ​

只有 vmess 和 vless 使用 transport,其他类型直接忽略,没有提示。不过每种类型都会检查这张表: 缺少 type 或 type 未知的 transport,即使写在 Trojan 或 Shadowsocks 代理上,也会让整个配置被拒绝。

类型 ​

type也可以写载体
rawtcp、RAW、TCP无:协议直接跑在 TCP(或 TLS)上,等同于不写 transport
wswebsocket、WS、WEBSOCKET、v2ray-ws、v2ray_websocketWebSocket
httpHTTP、v2ray-http、v2ray_http、v2rayhttp请求体不结束的 HTTP/1.1 请求
httpupgradehttp-upgrade、http_upgradeHTTP Upgrade 之后直接传原始字节
grpcGRPC基于 HTTP/2 的 gRPC「gun」流

没有 h2、quic、xhttp 或 splithttp 传输层。

字段 ​

path 总是以 / 开头:缺少开头的斜杠时 Specola 会补上,空路径变成 /。headers 是值为字符串的 内联表。这里的字段是宽松的:不认识的字段会被直接忽略,没有提示。

ws ​

字段默认取值
host代理的 server(端口不是 80 或 443 时带 :端口)字符串或数组;数组时每条连接随机选一个。不要带端口
path/请求路径
headers无额外请求头。这里写了 Host 就替代 host
max-early-data0首批数据中放进握手里发送的字节数。别名 max_early_data
early-data-header-name无承载早期数据的请求头,数据经 base64 编码,例如 Sec-WebSocket-Protocol。别名 early_data_header_name

只有 max-early-data 和 early-data-header-name 都设置时才会发送早期数据。不支持通过路径 (/ws?ed=2048)发送早期数据:路径会原样发出。

http ​

字段默认取值
host代理的 server(端口不是 80 或 443 时带 :端口)字符串或数组;每条连接随机选一个
path/请求路径
methodPUTHTTP 方法,会转成大写
headers无额外请求头;这里写了 Host 或 User-Agent 就替代默认值
idle-timeout、ping-timeout—能写,但不起作用

httpupgrade ​

字段默认取值
host代理的 server(端口不是 80 或 443 时带 :端口)字符串或数组;使用第一个
path/请求路径
headers无额外请求头;这里写了 Host、Connection、Upgrade 就替代默认值

请求总是带有 User-Agent: Mozilla/5.0。

grpc ​

字段默认取值
service-name无服务端配置的 gRPC 服务名。别名 service_name、serviceName。请求路径为 /<service-name>/Tun
authority代理的 server(端口不是 80 或 443 时带 :端口)HTTP/2 的 :authority。为空时使用 host
user-agentgrpc-go/1.76.0别名 user_agent
multi-modefalse写 true 能加载,但每条连接都会失败:不支持 multi-mode

请始终设置 service-name;不写时路径是 //Tun,很少有服务端这样配置。

ALPN ​

开启 TLS 时,传输层需要特定的 ALPN 协议:

传输层ALPN
ws、http、httpupgradehttp/1.1
grpch2
raw无要求

tls 表里不写 alpn 时,Specola 会自动提供正确的值。自己写了 alpn 就必须包含这个协议:例如 ws 配 alpn = ["h2"] 能加载,但每条连接都会失败,报错 configured ALPN is incompatible with the selected transport。

Reality 与 Vision ​

  • Reality 只能配 raw 和 grpc 传输层。配 ws、http、httpupgrade 能加载,但连接会失败。
  • VLESS Vision(flow = "xtls-rprx-vision")要求 raw,并且要开启 TLS 或 Reality。 配其他传输层能加载,但连接会失败。

示例 ​

VLESS over gRPC,开启 TLS:

toml
[[proxy]]
name = "vless-grpc"
type = "vless"
server = "proxy.example.org"
port = 443
uuid = "63478227-37be-44ee-a7e3-a2cfa1108664"
tls = { server-name = "proxy.example.org" }
transport = { type = "grpc", service-name = "example-service" }

CDN 后面的 VMess over HTTP Upgrade,带一个额外请求头:

toml
[[proxy]]
name = "vmess-upgrade"
type = "vmess"
server = "cdn.example.org"
port = 443
uuid = "e6e1acfe-5b1e-4b1c-87c8-92beecb98ba2"
tls = { server-name = "proxy.example.org" }
transport = { type = "httpupgrade", host = "proxy.example.org", path = "/upgrade", headers = { X-Client = "specola" } }

排错 ​

  1. 不走 CDN 能用,走 CDN 就不行:检查 host(TLS 时还有 server-name)是不是 CDN 所服务的域名, path 或 service-name 是否与服务端一致。
  2. 配置一加载,所有连接都失败:检查 alpn 是否缺了 http/1.1 或 h2,Reality 或 Vision 是否配了非 raw 传输层,以及是否写了 multi-mode = true。
  3. 传输层在 Trojan、Shadowsocks 等类型上好像不起作用:只有 VMess 和 VLESS 使用它。

另见代理和 TLS。