传输层
传输层把 VMess 或 VLESS 连接包进另一种载体,通常是为了穿过只转发网页流量的 CDN 或反向代理。 它是代理上的 transport 内联表:
[[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 | 也可以写 | 载体 |
|---|---|---|
raw | tcp、RAW、TCP | 无:协议直接跑在 TCP(或 TLS)上,等同于不写 transport |
ws | websocket、WS、WEBSOCKET、v2ray-ws、v2ray_websocket | WebSocket |
http | HTTP、v2ray-http、v2ray_http、v2rayhttp | 请求体不结束的 HTTP/1.1 请求 |
httpupgrade | http-upgrade、http_upgrade | HTTP Upgrade 之后直接传原始字节 |
grpc | GRPC | 基于 HTTP/2 的 gRPC「gun」流 |
没有 h2、quic、xhttp 或 splithttp 传输层。
字段
path 总是以 / 开头:缺少开头的斜杠时 Specola 会补上,空路径变成 /。headers 是值为字符串的 内联表。这里的字段是宽松的:不认识的字段会被直接忽略,没有提示。
ws
| 字段 | 默认 | 取值 |
|---|---|---|
host | 代理的 server(端口不是 80 或 443 时带 :端口) | 字符串或数组;数组时每条连接随机选一个。不要带端口 |
path | / | 请求路径 |
headers | 无 | 额外请求头。这里写了 Host 就替代 host |
max-early-data | 0 | 首批数据中放进握手里发送的字节数。别名 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 | / | 请求路径 |
method | PUT | HTTP 方法,会转成大写 |
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-agent | grpc-go/1.76.0 | 别名 user_agent |
multi-mode | false | 写 true 能加载,但每条连接都会失败:不支持 multi-mode |
请始终设置 service-name;不写时路径是 //Tun,很少有服务端这样配置。
ALPN
开启 TLS 时,传输层需要特定的 ALPN 协议:
| 传输层 | ALPN |
|---|---|
ws、http、httpupgrade | http/1.1 |
grpc | h2 |
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:
[[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,带一个额外请求头:
[[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" } }排错
- 不走 CDN 能用,走 CDN 就不行:检查
host(TLS 时还有server-name)是不是 CDN 所服务的域名,path或service-name是否与服务端一致。 - 配置一加载,所有连接都失败:检查
alpn是否缺了http/1.1或h2,Reality 或 Vision 是否配了非 raw 传输层,以及是否写了multi-mode = true。 - 传输层在 Trojan、Shadowsocks 等类型上好像不起作用:只有 VMess 和 VLESS 使用它。
