mirror of
https://github.com/SagerNet/sing-box.git
synced 2024-11-25 10:01:30 +00:00
187 lines
4 KiB
Markdown
187 lines
4 KiB
Markdown
V2Ray Transport is a set of private protocols invented by v2ray, and has contaminated the names of other protocols, such
|
|
as `trojan-grpc` in clash.
|
|
|
|
### Structure
|
|
|
|
```json
|
|
{
|
|
"type": ""
|
|
}
|
|
```
|
|
|
|
Available transports:
|
|
|
|
* HTTP
|
|
* WebSocket
|
|
* QUIC
|
|
* gRPC
|
|
|
|
!!! warning "Difference from v2ray-core"
|
|
|
|
* No TCP transport, plain HTTP is merged into the HTTP transport.
|
|
* No mKCP transport.
|
|
* No DomainSocket transport.
|
|
|
|
!!! note ""
|
|
|
|
You can ignore the JSON Array [] tag when the content is only one item
|
|
|
|
### HTTP
|
|
|
|
```json
|
|
{
|
|
"type": "http",
|
|
"host": [],
|
|
"path": "",
|
|
"method": "",
|
|
"headers": {},
|
|
"idle_timeout": "15s",
|
|
"ping_timeout": "15s"
|
|
}
|
|
```
|
|
|
|
!!! warning "Difference from v2ray-core"
|
|
|
|
TLS is not enforced. If TLS is not configured, plain HTTP 1.1 is used.
|
|
|
|
#### host
|
|
|
|
List of host domain.
|
|
|
|
The client will choose randomly and the server will verify if not empty.
|
|
|
|
#### path
|
|
|
|
Path of HTTP request.
|
|
|
|
The server will verify if not empty.
|
|
|
|
#### method
|
|
|
|
Method of HTTP request.
|
|
|
|
The server will verify if not empty.
|
|
|
|
#### headers
|
|
|
|
Extra headers of HTTP request.
|
|
|
|
The server will write in response if not empty.
|
|
|
|
#### idle_timeout
|
|
|
|
In HTTP2 server:
|
|
|
|
Specifies the time until idle clients should be closed with a GOAWAY frame. PING frames are not considered as activity.
|
|
|
|
In HTTP2 client:
|
|
|
|
Specifies the period of time after which a health check will be performed using a ping frame if no frames have been received on the connection. Please note that a ping response is considered a received frame, so if there is no other traffic on the connection, the health check will be executed every interval. If the value is zero, no health check will be performed.
|
|
|
|
Zero is used by default.
|
|
|
|
#### ping_timeout
|
|
|
|
In HTTP2 client:
|
|
|
|
Specifies the timeout duration after sending a PING frame, within which a response must be received. If a response to the PING frame is not received within the specified timeout duration, the connection will be closed. The default timeout duration is 15 seconds.
|
|
|
|
### WebSocket
|
|
|
|
```json
|
|
{
|
|
"type": "ws",
|
|
"path": "",
|
|
"headers": {},
|
|
"max_early_data": 0,
|
|
"early_data_header_name": ""
|
|
}
|
|
```
|
|
|
|
#### path
|
|
|
|
Path of HTTP request.
|
|
|
|
The server will verify if not empty.
|
|
|
|
#### headers
|
|
|
|
Extra headers of HTTP request.
|
|
|
|
#### max_early_data
|
|
|
|
Allowed payload size is in the request. Enabled if not zero.
|
|
|
|
#### early_data_header_name
|
|
|
|
Early data is sent in path instead of header by default.
|
|
|
|
To be compatible with Xray-core, set this to `Sec-WebSocket-Protocol`.
|
|
|
|
It needs to be consistent with the server.
|
|
|
|
### QUIC
|
|
|
|
```json
|
|
{
|
|
"type": "quic"
|
|
}
|
|
```
|
|
|
|
!!! warning ""
|
|
|
|
QUIC is not included by default, see [Installation](/#installation).
|
|
|
|
!!! warning "Difference from v2ray-core"
|
|
|
|
No additional encryption support:
|
|
It's basically duplicate encryption. And Xray-core is not compatible with v2ray-core in here.
|
|
|
|
### gRPC
|
|
|
|
!!! note ""
|
|
|
|
standard gRPC has good compatibility but poor performance and is not included by default, see [Installation](/#installation).
|
|
|
|
```json
|
|
{
|
|
"type": "grpc",
|
|
"service_name": "TunService",
|
|
"idle_timeout": "15s",
|
|
"ping_timeout": "15s",
|
|
"permit_without_stream": false
|
|
}
|
|
```
|
|
|
|
#### service_name
|
|
|
|
Service name of gRPC.
|
|
|
|
#### idle_timeout
|
|
|
|
In standard gRPC server/client:
|
|
|
|
If the transport doesn't see any activity after a duration of this time, it pings the client to check if the connection is still active.
|
|
|
|
In default gRPC server/client:
|
|
|
|
It has the same behavior as the corresponding setting in HTTP transport.
|
|
|
|
#### ping_timeout
|
|
|
|
In standard gRPC server/client:
|
|
|
|
The timeout that after performing a keepalive check, the client will wait for activity. If no activity is detected, the connection will be closed.
|
|
|
|
In default gRPC server/client:
|
|
|
|
It has the same behavior as the corresponding setting in HTTP transport.
|
|
|
|
#### permit_without_stream
|
|
|
|
In standard gRPC client:
|
|
|
|
If enabled, the client transport sends keepalive pings even with no active connections. If disabled, when there are no active connections, `idle_timeout` and `ping_timeout` will be ignored and no keepalive pings will be sent.
|
|
|
|
Disabled by default.
|