Back to godoc.org
v2ray.com/core / app / dns

package dns

v4.19.1+incompatible
Latest Go to latest
Published: Jun 3, 2019 | License: MIT | Module: v2ray.com/core

Overview

Package dns is an implementation of core.DNS feature.

Index

Variables

var DomainMatchingType_name = map[int32]string{
	0: "Full",
	1: "Subdomain",
	2: "Keyword",
	3: "Regex",
}
var DomainMatchingType_value = map[string]int32{
	"Full":      0,
	"Subdomain": 1,
	"Keyword":   2,
	"Regex":     3,
}

func Fqdn

func Fqdn(domain string) string

func NewLocalNameServer

func NewLocalNameServer() *localNameServer

type ClassicNameServer

type ClassicNameServer struct {
	sync.RWMutex
	// contains filtered or unexported fields
}

func NewClassicNameServer

func NewClassicNameServer(address net.Destination, dispatcher routing.Dispatcher, clientIP net.IP) *ClassicNameServer

func (*ClassicNameServer) Cleanup

func (s *ClassicNameServer) Cleanup() error

func (*ClassicNameServer) HandleResponse

func (s *ClassicNameServer) HandleResponse(ctx context.Context, packet *udp_proto.Packet)

func (*ClassicNameServer) Name

func (s *ClassicNameServer) Name() string

func (*ClassicNameServer) QueryIP

func (s *ClassicNameServer) QueryIP(ctx context.Context, domain string, option IPOption) ([]net.IP, error)

type Client

type Client interface {
	// Name of the Client.
	Name() string

	// QueryIP sends IP queries to its configured server.
	QueryIP(ctx context.Context, domain string, option IPOption) ([]net.IP, error)
}

Client is the interface for DNS client.

type Config

type Config struct {
	NameServers []*net.Endpoint `protobuf:"bytes,1,rep,name=NameServers,proto3" json:"NameServers,omitempty"`

	NameServer []*NameServer `protobuf:"bytes,5,rep,name=name_server,json=nameServer,proto3" json:"name_server,omitempty"`

	Hosts map[string]*net.IPOrDomain "" /* 151 byte string literal not displayed */

	ClientIp    []byte                `protobuf:"bytes,3,opt,name=client_ip,json=clientIp,proto3" json:"client_ip,omitempty"`
	StaticHosts []*Config_HostMapping `protobuf:"bytes,4,rep,name=static_hosts,json=staticHosts,proto3" json:"static_hosts,omitempty"`

	Tag                  string   `protobuf:"bytes,6,opt,name=tag,proto3" json:"tag,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*Config) Descriptor

func (*Config) Descriptor() ([]byte, []int)

func (*Config) GetClientIp

func (m *Config) GetClientIp() []byte

func (*Config) GetHosts

func (m *Config) GetHosts() map[string]*net.IPOrDomain

Deprecated: Do not use.

func (*Config) GetNameServer

func (m *Config) GetNameServer() []*NameServer

func (*Config) GetNameServers

func (m *Config) GetNameServers() []*net.Endpoint

Deprecated: Do not use.

func (*Config) GetStaticHosts

func (m *Config) GetStaticHosts() []*Config_HostMapping

func (*Config) GetTag

func (m *Config) GetTag() string

func (*Config) ProtoMessage

func (*Config) ProtoMessage()

func (*Config) Reset

func (m *Config) Reset()

func (*Config) String

func (m *Config) String() string

func (*Config) XXX_DiscardUnknown

func (m *Config) XXX_DiscardUnknown()

func (*Config) XXX_Marshal

func (m *Config) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Config) XXX_Merge

func (m *Config) XXX_Merge(src proto.Message)

func (*Config) XXX_Size

func (m *Config) XXX_Size() int

func (*Config) XXX_Unmarshal

func (m *Config) XXX_Unmarshal(b []byte) error

type Config_HostMapping

type Config_HostMapping struct {
	Type   DomainMatchingType `protobuf:"varint,1,opt,name=type,proto3,enum=v2ray.core.app.dns.DomainMatchingType" json:"type,omitempty"`
	Domain string             `protobuf:"bytes,2,opt,name=domain,proto3" json:"domain,omitempty"`
	Ip     [][]byte           `protobuf:"bytes,3,rep,name=ip,proto3" json:"ip,omitempty"`
	// ProxiedDomain indicates the mapped domain has the same IP address on this domain. V2Ray will use this domain for IP queries.
	// This field is only effective if ip is empty.
	ProxiedDomain        string   `protobuf:"bytes,4,opt,name=proxied_domain,json=proxiedDomain,proto3" json:"proxied_domain,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*Config_HostMapping) Descriptor

func (*Config_HostMapping) Descriptor() ([]byte, []int)

func (*Config_HostMapping) GetDomain

func (m *Config_HostMapping) GetDomain() string

func (*Config_HostMapping) GetIp

func (m *Config_HostMapping) GetIp() [][]byte

func (*Config_HostMapping) GetProxiedDomain

func (m *Config_HostMapping) GetProxiedDomain() string

func (*Config_HostMapping) GetType

func (m *Config_HostMapping) GetType() DomainMatchingType

func (*Config_HostMapping) ProtoMessage

func (*Config_HostMapping) ProtoMessage()

func (*Config_HostMapping) Reset

func (m *Config_HostMapping) Reset()

func (*Config_HostMapping) String

func (m *Config_HostMapping) String() string

func (*Config_HostMapping) XXX_DiscardUnknown

func (m *Config_HostMapping) XXX_DiscardUnknown()

func (*Config_HostMapping) XXX_Marshal

func (m *Config_HostMapping) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Config_HostMapping) XXX_Merge

func (m *Config_HostMapping) XXX_Merge(src proto.Message)

func (*Config_HostMapping) XXX_Size

func (m *Config_HostMapping) XXX_Size() int

func (*Config_HostMapping) XXX_Unmarshal

func (m *Config_HostMapping) XXX_Unmarshal(b []byte) error

type DomainMatchingType

type DomainMatchingType int32
const (
	DomainMatchingType_Full      DomainMatchingType = 0
	DomainMatchingType_Subdomain DomainMatchingType = 1
	DomainMatchingType_Keyword   DomainMatchingType = 2
	DomainMatchingType_Regex     DomainMatchingType = 3
)

func (DomainMatchingType) EnumDescriptor

func (DomainMatchingType) EnumDescriptor() ([]byte, []int)

func (DomainMatchingType) String

func (x DomainMatchingType) String() string

type IPOption

type IPOption struct {
	IPv4Enable bool
	IPv6Enable bool
}

IPOption is an object for IP query options.

type IPRecord

type IPRecord struct {
	IP     []net.Address
	Expire time.Time
	RCode  dnsmessage.RCode
}

type NameServer

type NameServer struct {
	Address              *net.Endpoint                `protobuf:"bytes,1,opt,name=address,proto3" json:"address,omitempty"`
	PrioritizedDomain    []*NameServer_PriorityDomain `protobuf:"bytes,2,rep,name=prioritized_domain,json=prioritizedDomain,proto3" json:"prioritized_domain,omitempty"`
	XXX_NoUnkeyedLiteral struct{}                     `json:"-"`
	XXX_unrecognized     []byte                       `json:"-"`
	XXX_sizecache        int32                        `json:"-"`
}

func (*NameServer) Descriptor

func (*NameServer) Descriptor() ([]byte, []int)

func (*NameServer) GetAddress

func (m *NameServer) GetAddress() *net.Endpoint

func (*NameServer) GetPrioritizedDomain

func (m *NameServer) GetPrioritizedDomain() []*NameServer_PriorityDomain

func (*NameServer) ProtoMessage

func (*NameServer) ProtoMessage()

func (*NameServer) Reset

func (m *NameServer) Reset()

func (*NameServer) String

func (m *NameServer) String() string

func (*NameServer) XXX_DiscardUnknown

func (m *NameServer) XXX_DiscardUnknown()

func (*NameServer) XXX_Marshal

func (m *NameServer) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*NameServer) XXX_Merge

func (m *NameServer) XXX_Merge(src proto.Message)

func (*NameServer) XXX_Size

func (m *NameServer) XXX_Size() int

func (*NameServer) XXX_Unmarshal

func (m *NameServer) XXX_Unmarshal(b []byte) error

type NameServer_PriorityDomain

type NameServer_PriorityDomain struct {
	Type                 DomainMatchingType `protobuf:"varint,1,opt,name=type,proto3,enum=v2ray.core.app.dns.DomainMatchingType" json:"type,omitempty"`
	Domain               string             `protobuf:"bytes,2,opt,name=domain,proto3" json:"domain,omitempty"`
	XXX_NoUnkeyedLiteral struct{}           `json:"-"`
	XXX_unrecognized     []byte             `json:"-"`
	XXX_sizecache        int32              `json:"-"`
}

func (*NameServer_PriorityDomain) Descriptor

func (*NameServer_PriorityDomain) Descriptor() ([]byte, []int)

func (*NameServer_PriorityDomain) GetDomain

func (m *NameServer_PriorityDomain) GetDomain() string

func (*NameServer_PriorityDomain) GetType

func (m *NameServer_PriorityDomain) GetType() DomainMatchingType

func (*NameServer_PriorityDomain) ProtoMessage

func (*NameServer_PriorityDomain) ProtoMessage()

func (*NameServer_PriorityDomain) Reset

func (m *NameServer_PriorityDomain) Reset()

func (*NameServer_PriorityDomain) String

func (m *NameServer_PriorityDomain) String() string

func (*NameServer_PriorityDomain) XXX_DiscardUnknown

func (m *NameServer_PriorityDomain) XXX_DiscardUnknown()

func (*NameServer_PriorityDomain) XXX_Marshal

func (m *NameServer_PriorityDomain) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*NameServer_PriorityDomain) XXX_Merge

func (m *NameServer_PriorityDomain) XXX_Merge(src proto.Message)

func (*NameServer_PriorityDomain) XXX_Size

func (m *NameServer_PriorityDomain) XXX_Size() int

func (*NameServer_PriorityDomain) XXX_Unmarshal

func (m *NameServer_PriorityDomain) XXX_Unmarshal(b []byte) error

type Server

type Server struct {
	sync.Mutex
	// contains filtered or unexported fields
}

Server is a DNS rely server.

func New

func New(ctx context.Context, config *Config) (*Server, error)

New creates a new DNS server with given configuration.

func (*Server) Close

func (s *Server) Close() error

Close implements common.Closable.

func (s *Server) IsOwnLink(ctx context.Context) bool

func (*Server) LookupIP

func (s *Server) LookupIP(domain string) ([]net.IP, error)

LookupIP implements dns.Client.

func (*Server) LookupIPv4

func (s *Server) LookupIPv4(domain string) ([]net.IP, error)

LookupIPv4 implements dns.IPv4Lookup.

func (*Server) LookupIPv6

func (s *Server) LookupIPv6(domain string) ([]net.IP, error)

LookupIPv6 implements dns.IPv6Lookup.

func (*Server) Start

func (s *Server) Start() error

Start implements common.Runnable.

func (*Server) Type

func (*Server) Type() interface{}

Type implements common.HasType.

type StaticHosts

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

StaticHosts represents static domain-ip mapping in DNS server.

func NewStaticHosts

func NewStaticHosts(hosts []*Config_HostMapping, legacy map[string]*net.IPOrDomain) (*StaticHosts, error)

NewStaticHosts creates a new StaticHosts instance.

func (*StaticHosts) LookupIP

func (h *StaticHosts) LookupIP(domain string, option IPOption) []net.Address

LookupIP returns IP address for the given domain, if exists in this StaticHosts.

Documentation was rendered with GOOS=linux and GOARCH=amd64.

Jump to identifier

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to identifier