clash/constant/adapters.go

192 lines
3.8 KiB
Go
Raw Normal View History

2018-06-10 14:50:03 +00:00
package constant
import (
2019-07-02 11:18:03 +00:00
"context"
"fmt"
2018-06-13 17:00:58 +00:00
"net"
"time"
"github.com/Dreamacro/clash/component/dialer"
2018-06-10 14:50:03 +00:00
)
// Adapter Type
const (
Direct AdapterType = iota
Reject
Compatible
Pass
Relay
Selector
Fallback
URLTest
LoadBalance
Shadowsocks
ShadowsocksR
2019-10-09 10:46:23 +00:00
Snell
2018-08-12 05:50:54 +00:00
Socks5
Http
2018-09-06 02:53:29 +00:00
Vmess
2021-11-17 08:03:47 +00:00
Vless
2020-03-19 12:26:53 +00:00
Trojan
)
2021-06-10 06:05:56 +00:00
const (
DefaultTCPTimeout = 5 * time.Second
DefaultUDPTimeout = DefaultTCPTimeout
DefaultTLSTimeout = DefaultTCPTimeout
2021-06-10 06:05:56 +00:00
)
type Connection interface {
Chains() Chain
AppendToChains(adapter ProxyAdapter)
}
type Chain []string
func (c Chain) String() string {
switch len(c) {
case 0:
return ""
case 1:
return c[0]
default:
return fmt.Sprintf("%s[%s]", c[len(c)-1], c[0])
}
}
func (c Chain) Last() string {
switch len(c) {
case 0:
return ""
default:
return c[0]
}
}
type Conn interface {
net.Conn
Connection
}
type PacketConn interface {
net.PacketConn
Connection
// Deprecate WriteWithMetadata because of remote resolve DNS cause TURN failed
// WriteWithMetadata(p []byte, metadata *Metadata) (n int, err error)
}
type ProxyAdapter interface {
2018-06-16 13:34:13 +00:00
Name() string
Type() AdapterType
Addr() string
SupportUDP() bool
MarshalJSON() ([]byte, error)
// StreamConn wraps a protocol around net.Conn with Metadata.
//
// Examples:
// conn, _ := net.DialContext(context.Background(), "tcp", "host:port")
// conn, _ = adapter.StreamConn(conn, metadata)
//
// It returns a C.Conn with protocol which start with
// a new session (if any)
StreamConn(c net.Conn, metadata *Metadata) (net.Conn, error)
// DialContext return a C.Conn with protocol which
// contains multiplexing-related reuse logic (if any)
DialContext(ctx context.Context, metadata *Metadata, opts ...dialer.Option) (Conn, error)
ListenPacketContext(ctx context.Context, metadata *Metadata, opts ...dialer.Option) (PacketConn, error)
// SupportUOT return UDP over TCP support
SupportUOT() bool
ListenPacketOnStreamConn(c net.Conn, metadata *Metadata) (PacketConn, error)
// Unwrap extracts the proxy from a proxy-group. It returns nil when nothing to extract.
Unwrap(metadata *Metadata) Proxy
2018-06-10 14:50:03 +00:00
}
type DelayHistory struct {
Time time.Time `json:"time"`
Delay uint16 `json:"delay"`
}
type Proxy interface {
ProxyAdapter
Alive() bool
DelayHistory() []DelayHistory
LastDelay() uint16
2019-07-02 11:18:03 +00:00
URLTest(ctx context.Context, url string) (uint16, error)
// Deprecated: use DialContext instead.
Dial(metadata *Metadata) (Conn, error)
// Deprecated: use DialPacketConn instead.
DialUDP(metadata *Metadata) (PacketConn, error)
}
// AdapterType is enum of adapter type
type AdapterType int
func (at AdapterType) String() string {
switch at {
case Direct:
return "Direct"
case Reject:
return "Reject"
case Compatible:
return "Compatible"
case Pass:
return "Pass"
case Shadowsocks:
return "Shadowsocks"
case ShadowsocksR:
return "ShadowsocksR"
2019-10-09 10:46:23 +00:00
case Snell:
return "Snell"
2018-08-12 05:50:54 +00:00
case Socks5:
return "Socks5"
case Http:
return "Http"
2018-09-06 02:53:29 +00:00
case Vmess:
return "Vmess"
2021-11-17 08:03:47 +00:00
case Vless:
return "Vless"
2020-03-19 12:26:53 +00:00
case Trojan:
return "Trojan"
case Relay:
return "Relay"
2020-03-19 12:26:53 +00:00
case Selector:
return "Selector"
case Fallback:
return "Fallback"
case URLTest:
return "URLTest"
2019-02-15 06:25:20 +00:00
case LoadBalance:
return "LoadBalance"
2020-03-19 12:26:53 +00:00
default:
2019-08-26 04:26:14 +00:00
return "Unknown"
}
}
// UDPPacket contains the data of UDP packet, and offers control/info of UDP packet's source
type UDPPacket interface {
// Data get the payload of UDP Packet
Data() []byte
// WriteBack writes the payload with source IP/Port equals addr
// - variable source IP/Port is important to STUN
2020-10-14 11:56:02 +00:00
// - if addr is not provided, WriteBack will write out UDP packet with SourceIP/Port equals to original Target,
// this is important when using Fake-IP.
WriteBack(b []byte, addr net.Addr) (n int, err error)
// Drop call after packet is used, could recycle buffer in this function.
Drop()
// LocalAddr returns the source IP/Port of packet
LocalAddr() net.Addr
}