Documentation ¶
Overview ¶
Package socks provides implements of Socks protocol 4, 4a and 5.
Index ¶
- Variables
- func ClientHandshake(request *protocol.RequestHeader, reader io.Reader, writer io.Writer) (*protocol.RequestHeader, error)
- func ClientHandshake4(request *protocol.RequestHeader, reader io.Reader, writer io.Writer) error
- func DecodeUDPPacket(packet *buf.Buffer) (*protocol.RequestHeader, error)
- func EncodeUDPPacket(request *protocol.RequestHeader, data []byte) (*buf.Buffer, error)
- func EncodeUDPPacketFromAddress(address net.Destination, data []byte) (*buf.Buffer, error)
- func ReadUntilNull(reader io.Reader) (string, error)
- func ReadUsernamePassword(reader io.Reader) (string, string, error)
- type Account
- func (a *Account) AsAccount() (protocol.Account, error)
- func (*Account) Descriptor() ([]byte, []int)deprecated
- func (a *Account) Equals(another protocol.Account) bool
- func (x *Account) GetPassword() string
- func (x *Account) GetUsername() string
- func (*Account) ProtoMessage()
- func (x *Account) ProtoReflect() protoreflect.Message
- func (x *Account) Reset()
- func (x *Account) String() string
- type AuthType
- type Client
- type ClientConfig
- func (*ClientConfig) Descriptor() ([]byte, []int)deprecated
- func (x *ClientConfig) GetServer() []*protocol.ServerEndpoint
- func (x *ClientConfig) GetVersion() Version
- func (*ClientConfig) ProtoMessage()
- func (x *ClientConfig) ProtoReflect() protoreflect.Message
- func (x *ClientConfig) Reset()
- func (x *ClientConfig) String() string
- type Server
- type ServerConfig
- func (*ServerConfig) Descriptor() ([]byte, []int)deprecated
- func (x *ServerConfig) GetAccounts() map[string]string
- func (x *ServerConfig) GetAddress() *net.IPOrDomain
- func (x *ServerConfig) GetAuthType() AuthType
- func (x *ServerConfig) GetPacketEncoding() packetaddr.PacketAddrType
- func (x *ServerConfig) GetTimeout() uint32deprecated
- func (x *ServerConfig) GetUdpEnabled() bool
- func (x *ServerConfig) GetUserLevel() uint32
- func (c *ServerConfig) HasAccount(username, password string) bool
- func (*ServerConfig) ProtoMessage()
- func (x *ServerConfig) ProtoReflect() protoreflect.Message
- func (x *ServerConfig) Reset()
- func (x *ServerConfig) String() string
- type ServerSession
- type UDPReader
- type UDPWriter
- type Version
Constants ¶
This section is empty.
Variables ¶
var ( AuthType_name = map[int32]string{ 0: "NO_AUTH", 1: "PASSWORD", } AuthType_value = map[string]int32{ "NO_AUTH": 0, "PASSWORD": 1, } )
Enum value maps for AuthType.
var ( Version_name = map[int32]string{ 0: "SOCKS5", 1: "SOCKS4", 2: "SOCKS4A", } Version_value = map[string]int32{ "SOCKS5": 0, "SOCKS4": 1, "SOCKS4A": 2, } )
Enum value maps for Version.
var File_proxy_socks_config_proto protoreflect.FileDescriptor
Functions ¶
func ClientHandshake ¶ added in v1.1.0
func ClientHandshake(request *protocol.RequestHeader, reader io.Reader, writer io.Writer) (*protocol.RequestHeader, error)
func ClientHandshake4 ¶ added in v1.1.0
func DecodeUDPPacket ¶ added in v1.1.0
func DecodeUDPPacket(packet *buf.Buffer) (*protocol.RequestHeader, error)
func EncodeUDPPacket ¶ added in v1.1.0
func EncodeUDPPacketFromAddress ¶ added in v1.1.0
func ReadUntilNull ¶ added in v1.1.0
ReadUntilNull reads content from given reader, until a null (0x00) byte.
func ReadUsernamePassword ¶ added in v1.1.0
ReadUsernamePassword reads Socks 5 username/password message from the given reader. +----+------+----------+------+----------+ |VER | ULEN | UNAME | PLEN | PASSWD | +----+------+----------+------+----------+ | 1 | 1 | 1 to 255 | 1 | 1 to 255 | +----+------+----------+------+----------+
Types ¶
type Account ¶ added in v1.1.0
type Account struct { Username string `protobuf:"bytes,1,opt,name=username,proto3" json:"username,omitempty"` Password string `protobuf:"bytes,2,opt,name=password,proto3" json:"password,omitempty"` // contains filtered or unexported fields }
Account represents a Socks account.
func (*Account) Descriptor
deprecated
added in
v1.1.0
func (*Account) GetPassword ¶ added in v1.1.0
func (*Account) GetUsername ¶ added in v1.1.0
func (*Account) ProtoMessage ¶ added in v1.1.0
func (*Account) ProtoMessage()
func (*Account) ProtoReflect ¶ added in v1.1.0
func (x *Account) ProtoReflect() protoreflect.Message
type AuthType ¶ added in v1.1.0
type AuthType int32
AuthType is the authentication type of Socks proxy.
func (AuthType) Descriptor ¶ added in v1.1.0
func (AuthType) Descriptor() protoreflect.EnumDescriptor
func (AuthType) EnumDescriptor
deprecated
added in
v1.1.0
func (AuthType) Number ¶ added in v1.1.0
func (x AuthType) Number() protoreflect.EnumNumber
func (AuthType) Type ¶ added in v1.1.0
func (AuthType) Type() protoreflect.EnumType
type Client ¶ added in v1.1.0
type Client struct {
// contains filtered or unexported fields
}
Client is a Socks5 client.
type ClientConfig ¶ added in v1.1.0
type ClientConfig struct { // Sever is a list of Socks server addresses. Server []*protocol.ServerEndpoint `protobuf:"bytes,1,rep,name=server,proto3" json:"server,omitempty"` Version Version `protobuf:"varint,2,opt,name=version,proto3,enum=v2ray.core.proxy.socks.Version" json:"version,omitempty"` // contains filtered or unexported fields }
ClientConfig is the protobuf config for Socks client.
func (*ClientConfig) Descriptor
deprecated
added in
v1.1.0
func (*ClientConfig) Descriptor() ([]byte, []int)
Deprecated: Use ClientConfig.ProtoReflect.Descriptor instead.
func (*ClientConfig) GetServer ¶ added in v1.1.0
func (x *ClientConfig) GetServer() []*protocol.ServerEndpoint
func (*ClientConfig) GetVersion ¶ added in v1.1.0
func (x *ClientConfig) GetVersion() Version
func (*ClientConfig) ProtoMessage ¶ added in v1.1.0
func (*ClientConfig) ProtoMessage()
func (*ClientConfig) ProtoReflect ¶ added in v1.1.0
func (x *ClientConfig) ProtoReflect() protoreflect.Message
func (*ClientConfig) Reset ¶ added in v1.1.0
func (x *ClientConfig) Reset()
func (*ClientConfig) String ¶ added in v1.1.0
func (x *ClientConfig) String() string
type Server ¶ added in v1.1.0
type Server struct {
// contains filtered or unexported fields
}
Server is a SOCKS 5 proxy server
func NewServer ¶ added in v1.1.0
func NewServer(ctx context.Context, config *ServerConfig) (*Server, error)
NewServer creates a new Server object.
type ServerConfig ¶ added in v1.1.0
type ServerConfig struct { AuthType AuthType `protobuf:"varint,1,opt,name=auth_type,json=authType,proto3,enum=v2ray.core.proxy.socks.AuthType" json:"auth_type,omitempty"` Accounts map[string]string `` /* 157-byte string literal not displayed */ Address *net.IPOrDomain `protobuf:"bytes,3,opt,name=address,proto3" json:"address,omitempty"` UdpEnabled bool `protobuf:"varint,4,opt,name=udp_enabled,json=udpEnabled,proto3" json:"udp_enabled,omitempty"` // Deprecated: Do not use. Timeout uint32 `protobuf:"varint,5,opt,name=timeout,proto3" json:"timeout,omitempty"` UserLevel uint32 `protobuf:"varint,6,opt,name=user_level,json=userLevel,proto3" json:"user_level,omitempty"` PacketEncoding packetaddr.PacketAddrType `` /* 150-byte string literal not displayed */ // contains filtered or unexported fields }
ServerConfig is the protobuf config for Socks server.
func (*ServerConfig) Descriptor
deprecated
added in
v1.1.0
func (*ServerConfig) Descriptor() ([]byte, []int)
Deprecated: Use ServerConfig.ProtoReflect.Descriptor instead.
func (*ServerConfig) GetAccounts ¶ added in v1.1.0
func (x *ServerConfig) GetAccounts() map[string]string
func (*ServerConfig) GetAddress ¶ added in v1.1.0
func (x *ServerConfig) GetAddress() *net.IPOrDomain
func (*ServerConfig) GetAuthType ¶ added in v1.1.0
func (x *ServerConfig) GetAuthType() AuthType
func (*ServerConfig) GetPacketEncoding ¶ added in v1.1.0
func (x *ServerConfig) GetPacketEncoding() packetaddr.PacketAddrType
func (*ServerConfig) GetTimeout
deprecated
added in
v1.1.0
func (x *ServerConfig) GetTimeout() uint32
Deprecated: Do not use.
func (*ServerConfig) GetUdpEnabled ¶ added in v1.1.0
func (x *ServerConfig) GetUdpEnabled() bool
func (*ServerConfig) GetUserLevel ¶ added in v1.1.0
func (x *ServerConfig) GetUserLevel() uint32
func (*ServerConfig) HasAccount ¶ added in v1.1.0
func (c *ServerConfig) HasAccount(username, password string) bool
func (*ServerConfig) ProtoMessage ¶ added in v1.1.0
func (*ServerConfig) ProtoMessage()
func (*ServerConfig) ProtoReflect ¶ added in v1.1.0
func (x *ServerConfig) ProtoReflect() protoreflect.Message
func (*ServerConfig) Reset ¶ added in v1.1.0
func (x *ServerConfig) Reset()
func (*ServerConfig) String ¶ added in v1.1.0
func (x *ServerConfig) String() string
type ServerSession ¶ added in v1.1.0
type ServerSession struct {
// contains filtered or unexported fields
}
func (*ServerSession) Handshake ¶ added in v1.1.0
func (s *ServerSession) Handshake(reader io.Reader, writer io.Writer) (*protocol.RequestHeader, error)
Handshake performs a Socks4/4a/5 handshake.
type UDPReader ¶ added in v1.1.0
type UDPReader struct {
// contains filtered or unexported fields
}
func NewUDPReader ¶ added in v1.1.0
func (*UDPReader) ReadMultiBuffer ¶ added in v1.1.0
func (r *UDPReader) ReadMultiBuffer() (buf.MultiBuffer, error)
type UDPWriter ¶ added in v1.1.0
type UDPWriter struct {
// contains filtered or unexported fields
}
func NewUDPWriter ¶ added in v1.1.0
func NewUDPWriter(request *protocol.RequestHeader, writer io.Writer) *UDPWriter
type Version ¶ added in v1.1.0
type Version int32
func (Version) Descriptor ¶ added in v1.1.0
func (Version) Descriptor() protoreflect.EnumDescriptor
func (Version) EnumDescriptor
deprecated
added in
v1.1.0
func (Version) Number ¶ added in v1.1.0
func (x Version) Number() protoreflect.EnumNumber
func (Version) Type ¶ added in v1.1.0
func (Version) Type() protoreflect.EnumType