constant

Documentation

Index

• Constants
• Variables
• func SetConfig(file string)
• func SetHomeDir(root string)
• type AdapterType
  • func (at AdapterType) String() string
• type Chain
  • func (c Chain) Last() string
  • func (c Chain) String() string
• type Conn
• type ConnContext
• type Connection
• type DelayHistory
• type Listener
• type Metadata
  • func (m *Metadata) AddrType() int
  • func (m *Metadata) Pure() *Metadata
  • func (m *Metadata) RemoteAddress() string
  • func (m *Metadata) Resolved() bool
  • func (m *Metadata) SourceAddress() string
  • func (m *Metadata) String() string
  • func (m *Metadata) UDPAddr() *net.UDPAddr
  • func (m *Metadata) Valid() bool
• type NetWork
  • func (n NetWork) MarshalJSON() ([]byte, error)
  • func (n NetWork) String() string
• type PacketAdapter
• type PacketConn
• type PacketConnContext
• type PlainContext
• type Proxy
• type ProxyAdapter
• type Type
  • func (t Type) MarshalJSON() ([]byte, error)
  • func (t Type) String() string
• type UDPPacket
• type UDPPacketInAddr

Constants

const (
	DefaultTCPTimeout = 5 * time.Second
	DefaultUDPTimeout = DefaultTCPTimeout
	DefaultTLSTimeout = DefaultTCPTimeout
)

const (
	TCP NetWork = iota
	UDP

	HTTP Type = iota
	HTTPCONNECT
	SOCKS4
	SOCKS5
	TUN
)

Socks addr type

const Name = "mixed-socks"

Variables

var Path = func() *path {
	homeDir, err := os.UserHomeDir()
	if err != nil {
		homeDir, _ = os.Getwd()
	}

	homeDir = P.Join(homeDir, ".config", Name)
	return &path{homeDir: homeDir, configFile: "config.yaml"}
}()

Path is used to get the configuration path

Functions

func SetConfig

func SetConfig(file string)

SetConfig is used to set the configuration file

func SetHomeDir

func SetHomeDir(root string)

SetHomeDir is used to set the configuration path

Types

type AdapterType

type AdapterType int

AdapterType is enum of adapter type

const (
	Direct AdapterType = iota
)

Adapter Type

func (AdapterType) String

func (at AdapterType) String() string

type Chain

type Chain []string

func (Chain) Last

func (c Chain) Last() string

func (Chain) String

func (c Chain) String() string

type Conn

type Conn interface {
	net.Conn
	Connection
}

type ConnContext

type ConnContext interface {
	PlainContext
	Metadata() *Metadata
	Conn() net.Conn
}

type Connection

type Connection interface {
	Chains() Chain
	AppendToChains(adapter ProxyAdapter)
}

type DelayHistory

type DelayHistory struct {
	Time  time.Time `json:"time"`
	Delay uint16    `json:"delay"`
}

type Listener

type Listener interface {
	RawAddress() string
	Address() string
	Close() error
}

type Metadata

type Metadata struct {
	NetWork     NetWork `json:"network"`
	Type        Type    `json:"type"`
	SrcIP       net.IP  `json:"sourceIP,omitempty"`
	DstIP       net.IP  `json:"destinationIP,omitempty"`
	SrcPort     string  `json:"sourcePort,omitempty"`
	DstPort     string  `json:"destinationPort,omitempty"`
	Host        string  `json:"host,omitempty"`
	ProcessPath string  `json:"processPath,omitempty"`
}

Metadata is used to store connection address

func (*Metadata) AddrType

func (m *Metadata) AddrType() int

func (*Metadata) Pure

func (m *Metadata) Pure() *Metadata

Pure is used to solve unexpected behavior when dialing proxy connection in DNSMapping mode.

func (*Metadata) RemoteAddress

func (m *Metadata) RemoteAddress() string

func (*Metadata) Resolved

func (m *Metadata) Resolved() bool

func (*Metadata) SourceAddress

func (m *Metadata) SourceAddress() string

func (*Metadata) String

func (m *Metadata) String() string

func (*Metadata) UDPAddr

func (m *Metadata) UDPAddr() *net.UDPAddr

func (*Metadata) Valid

func (m *Metadata) Valid() bool

type NetWork

type NetWork int

func (NetWork) MarshalJSON

func (n NetWork) MarshalJSON() ([]byte, error)

func (NetWork) String

func (n NetWork) String() string

type PacketAdapter

type PacketAdapter interface {
	UDPPacket
	Metadata() *Metadata
}

PacketAdapter is a UDP Packet adapter for socks/redir/tun

type PacketConn

type PacketConn interface {
	net.PacketConn
	Connection
}

type PacketConnContext

type PacketConnContext interface {
	PlainContext
	Metadata() *Metadata
	PacketConn() net.PacketConn
}

type PlainContext

type PlainContext interface {
	ID() uuid.UUID
}

type Proxy

type Proxy interface {
	ProxyAdapter
	Alive() bool
	DelayHistory() []DelayHistory
	LastDelay() uint16
	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)
}

type ProxyAdapter

type ProxyAdapter interface {
	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 constant.Conn with protocol which start with
	// a new session (if any)
	StreamConn(c net.Conn, metadata *Metadata) (net.Conn, error)

	// DialContext return a constant.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)

	// Unwrap extracts the proxy from a proxy-group. It returns nil when nothing to extract.
	Unwrap(metadata *Metadata) Proxy
}

type Type

type Type int

func (Type) MarshalJSON

func (t Type) MarshalJSON() ([]byte, error)

func (Type) String

func (t Type) String() string

type UDPPacket

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
	// - 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
}

UDPPacket contains the data of UDP packet, and offers control/info of UDP packet's source

type UDPPacketInAddr

type UDPPacketInAddr interface {
	InAddr() net.Addr
}