vmess

Documentation

Index

• Constants
• func AEADReader(r io.Reader, aead cipher.AEAD, iv []byte, chunkSizeDecoder ChunkSizeDecoder) io.Reader
• func AEADWriter(w io.Writer, aead cipher.AEAD, iv []byte, chunkSizeEncoder ChunkSizeEncoder) io.Writer
• func ChunkedReader(r io.Reader, chunkSizeDecoder ChunkSizeDecoder) io.Reader
• func ChunkedWriter(w io.Writer, chunkSizeEncoder ChunkSizeEncoder) io.Writer
• func GetKey(uuid [16]byte) []byte
• func NewVMessDialer(s string, dialer proxy.Dialer) (proxy.Dialer, error)
• func ParseAddr(s string) (Atyp, Addr, Port, error)
• func StrToUUID(s string) (uuid [16]byte, err error)
• func TimestampHash(t time.Time) []byte
• type Addr
• type Atyp
• type ChunkSizeDecoder
• type ChunkSizeEncoder
• type Client
  • func NewClient(uuidStr, security string, alterID int, aead bool) (*Client, error)
  • func (c *Client) NewConn(rc net.Conn, target string, cmd CmdType) (*Conn, error)
• type CmdType
• type Conn
  • func (c *Conn) Auth() error
  • func (c *Conn) DecodeRespHeader() error
  • func (c *Conn) Read(b []byte) (n int, err error)
  • func (c *Conn) Request(cmd CmdType) error
  • func (c *Conn) Write(b []byte) (n int, err error)
• type PktConn
  • func NewPktConn(c net.Conn) *PktConn
  • func (pc *PktConn) ReadFrom(b []byte) (int, net.Addr, error)
  • func (pc *PktConn) WriteTo(b []byte, addr net.Addr) (int, error)
• type Port
• type ShakeSizeParser
  • func NewShakeSizeParser(nonce []byte) *ShakeSizeParser
  • func (s *ShakeSizeParser) Decode(b []byte) (uint16, error)
  • func (s *ShakeSizeParser) Encode(size uint16, b []byte) []byte
  • func (s *ShakeSizeParser) MaxPaddingLen() uint16
  • func (s *ShakeSizeParser) NextPaddingLen() uint16
  • func (*ShakeSizeParser) SizeBytes() int32
• type User
  • func NewUser(uuid [16]byte) *User
  • func (u *User) GenAlterIDUsers(alterID int) []*User
• type VMess
  • func NewVMess(s string, d proxy.Dialer) (*VMess, error)
  • func (s *VMess) Addr() string
  • func (s *VMess) Dial(network, addr string) (net.Conn, error)
  • func (s *VMess) DialUDP(network, addr string) (net.PacketConn, net.Addr, error)

Constants

const (
	OptBasicFormat byte = 0
	OptChunkStream byte = 1
	// OptReuseTCPConnection byte = 2
	OptMetadataObfuscate byte = 4
)

Request Options

const (
	SecurityAES128GCM        byte = 3
	SecurityChacha20Poly1305 byte = 4
	SecurityNone             byte = 5
)

Security types

Functions

func AEADReader

func AEADReader(r io.Reader, aead cipher.AEAD, iv []byte, chunkSizeDecoder ChunkSizeDecoder) io.Reader

AEADReader returns a aead reader.

func AEADWriter

func AEADWriter(w io.Writer, aead cipher.AEAD, iv []byte, chunkSizeEncoder ChunkSizeEncoder) io.Writer

AEADWriter returns a aead writer.

func ChunkedReader

func ChunkedReader(r io.Reader, chunkSizeDecoder ChunkSizeDecoder) io.Reader

ChunkedReader returns a chunked reader.

func ChunkedWriter

func ChunkedWriter(w io.Writer, chunkSizeEncoder ChunkSizeEncoder) io.Writer

ChunkedWriter returns a chunked writer.

func GetKey

func GetKey(uuid [16]byte) []byte

GetKey returns the key of AES-128-CFB encrypter. Key：MD5(UUID + []byte('c48619fe-8f02-49e0-b9e9-edf763e17e21'))

func NewVMessDialer

func NewVMessDialer(s string, dialer proxy.Dialer) (proxy.Dialer, error)

NewVMessDialer returns a vmess proxy dialer.

func ParseAddr

func ParseAddr(s string) (Atyp, Addr, Port, error)

ParseAddr parses the address in string s.

func StrToUUID

func StrToUUID(s string) (uuid [16]byte, err error)

StrToUUID converts string to uuid.

func TimestampHash

func TimestampHash(t time.Time) []byte

TimestampHash returns the iv of AES-128-CFB encrypter. IV：MD5(X + X + X + X)，X = []byte(timestamp.now) (8 bytes, Big Endian)

Types

type Addr

type Addr []byte

Addr is vmess addr.

type Atyp

type Atyp byte

Atyp is vmess addr type.

const (
	AtypErr    Atyp = 0
	AtypIP4    Atyp = 1
	AtypDomain Atyp = 2
	AtypIP6    Atyp = 3
)

Atyp

type ChunkSizeDecoder

type ChunkSizeDecoder interface {
	SizeBytes() int32
	Decode([]byte) (uint16, error)
}

ChunkSizeDecoder is a utility class to decode size value from bytes.

type ChunkSizeEncoder

type ChunkSizeEncoder interface {
	SizeBytes() int32
	Encode(uint16, []byte) []byte
}

ChunkSizeEncoder is a utility class to encode size value into bytes.

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client is a vmess client.

func NewClient

func NewClient(uuidStr, security string, alterID int, aead bool) (*Client, error)

NewClient returns a new vmess client.

func (*Client) NewConn

func (c *Client) NewConn(rc net.Conn, target string, cmd CmdType) (*Conn, error)

NewConn returns a new vmess conn.

type CmdType

type CmdType byte

CmdType is the type of vmess cmd

const (
	CmdTCP CmdType = 1
	CmdUDP CmdType = 2
)

Cmd Types

type Conn

type Conn struct {
	net.Conn
	// contains filtered or unexported fields
}

Conn is a connection to vmess server.

func (*Conn) Auth

func (c *Conn) Auth() error

Auth send auth info: HMAC("md5", UUID, UTC).

func (*Conn) DecodeRespHeader

func (c *Conn) DecodeRespHeader() error

DecodeRespHeader decodes response header.

func (*Conn) Read

func (c *Conn) Read(b []byte) (n int, err error)

func (*Conn) Request

func (c *Conn) Request(cmd CmdType) error

Request sends request to server.

func (*Conn) Write

func (c *Conn) Write(b []byte) (n int, err error)

type PktConn

type PktConn struct{ net.Conn }

PktConn is a udp Packet.Conn.

func NewPktConn

func NewPktConn(c net.Conn) *PktConn

NewPktConn returns a PktConn.

func (*PktConn) ReadFrom

func (pc *PktConn) ReadFrom(b []byte) (int, net.Addr, error)

ReadFrom implements the necessary function of net.PacketConn.

func (*PktConn) WriteTo

func (pc *PktConn) WriteTo(b []byte, addr net.Addr) (int, error)

WriteTo implements the necessary function of net.PacketConn.

type Port

type Port uint16

Port is vmess addr port.

type ShakeSizeParser

type ShakeSizeParser struct {
	// contains filtered or unexported fields
}

func NewShakeSizeParser

func NewShakeSizeParser(nonce []byte) *ShakeSizeParser

func (*ShakeSizeParser) Decode

func (s *ShakeSizeParser) Decode(b []byte) (uint16, error)

func (*ShakeSizeParser) Encode

func (s *ShakeSizeParser) Encode(size uint16, b []byte) []byte

func (*ShakeSizeParser) MaxPaddingLen

func (s *ShakeSizeParser) MaxPaddingLen() uint16

func (*ShakeSizeParser) NextPaddingLen

func (s *ShakeSizeParser) NextPaddingLen() uint16

func (*ShakeSizeParser) SizeBytes

func (*ShakeSizeParser) SizeBytes() int32

type User

type User struct {
	UUID   [16]byte
	CmdKey [16]byte
}

User of vmess client.

func NewUser

func NewUser(uuid [16]byte) *User

NewUser returns a new user.

func (*User) GenAlterIDUsers

func (u *User) GenAlterIDUsers(alterID int) []*User

GenAlterIDUsers generates users according to primary user's id and alterID.

type VMess

type VMess struct {
	// contains filtered or unexported fields
}

VMess struct.

func NewVMess

func NewVMess(s string, d proxy.Dialer) (*VMess, error)

NewVMess returns a vmess proxy.

func (*VMess) Addr

func (s *VMess) Addr() string

Addr returns forwarder's address.

func (*VMess) Dial

func (s *VMess) Dial(network, addr string) (net.Conn, error)

Dial connects to the address addr on the network net via the proxy.

func (*VMess) DialUDP

func (s *VMess) DialUDP(network, addr string) (net.PacketConn, net.Addr, error)

DialUDP connects to the given address via the proxy.