dns

package

v0.0.0-...-0299622 Latest Latest Go to latest Published: Feb 12, 2026 License: MIT Imports: 13 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/cocowh/netproxy

Links

Open Source Insights

Documentation ¶

Index ¶

type DNSDispatcher
- func NewDNSDispatcher(defaultResolver UpstreamResolver) *DNSDispatcher
- func (d *DNSDispatcher) AddRule(domain string, resolver UpstreamResolver)
- func (d *DNSDispatcher) Dispatch(domain string) UpstreamResolver
type DoHResolver
- func (r *DoHResolver) Resolve(q *dns.Msg) (*dns.Msg, error)
type HostsAwareResolver
- func NewHostsAwareResolver(hosts *HostsResolver, upstream UpstreamResolver) *HostsAwareResolver
- func (r *HostsAwareResolver) Resolve(q *dns.Msg) (*dns.Msg, error)
type HostsResolver
- func NewHostsResolver() *HostsResolver
type RouteMatcher
type Server
- func NewServer(addr, upstream string) *Server
type UDPResolver
- func (r *UDPResolver) Resolve(q *dns.Msg) (*dns.Msg, error)
type UpstreamResolver

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type DNSDispatcher ¶

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

DNSDispatcher handles Split-DNS routing

func NewDNSDispatcher ¶

func NewDNSDispatcher(defaultResolver UpstreamResolver) *DNSDispatcher

func (*DNSDispatcher) AddRule ¶

func (d *DNSDispatcher) AddRule(domain string, resolver UpstreamResolver)

func (*DNSDispatcher) Dispatch ¶

func (d *DNSDispatcher) Dispatch(domain string) UpstreamResolver

type DoHResolver ¶

type DoHResolver struct {
	URL    string
	Client *http.Client
}

DoHResolver implements DNS over HTTPS

func (*DoHResolver) Resolve ¶

func (r *DoHResolver) Resolve(q *dns.Msg) (*dns.Msg, error)

type HostsAwareResolver ¶

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

HostsAwareResolver wraps an upstream resolver with hosts file support

func NewHostsAwareResolver ¶

func NewHostsAwareResolver(hosts *HostsResolver, upstream UpstreamResolver) *HostsAwareResolver

NewHostsAwareResolver creates a new hosts-aware resolver

func (*HostsAwareResolver) Resolve ¶

func (r *HostsAwareResolver) Resolve(q *dns.Msg) (*dns.Msg, error)

Resolve resolves a DNS query, checking hosts file first

type HostsResolver ¶

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

HostsResolver resolves domains using a hosts file

func NewHostsResolver ¶

func NewHostsResolver() *HostsResolver

NewHostsResolver creates a new hosts resolver

func (*HostsResolver) AddHost ¶

func (r *HostsResolver) AddHost(domain string, ip net.IP)

AddHost adds a host entry

func (*HostsResolver) Count ¶

func (r *HostsResolver) Count() int

Count returns the number of host entries

func (*HostsResolver) GetAllHosts ¶

func (r *HostsResolver) GetAllHosts() map[string][]net.IP

GetAllHosts returns all host entries

func (*HostsResolver) LoadFile ¶

func (r *HostsResolver) LoadFile(path string) error

LoadFile loads hosts from a file (e.g., /etc/hosts)

func (*HostsResolver) LoadString ¶

func (r *HostsResolver) LoadString(content string) error

LoadString loads hosts from a string

func (*HostsResolver) Reload ¶

func (r *HostsResolver) Reload() error

Reload reloads the hosts file

func (*HostsResolver) RemoveHost ¶

func (r *HostsResolver) RemoveHost(domain string)

RemoveHost removes a host entry

func (*HostsResolver) Resolve ¶

func (r *HostsResolver) Resolve(domain string) ([]net.IP, bool)

Resolve looks up a domain in the hosts file

func (*HostsResolver) ResolveIPv4 ¶

func (r *HostsResolver) ResolveIPv4(domain string) ([]net.IP, bool)

ResolveIPv4 returns only IPv4 addresses

func (*HostsResolver) ResolveIPv6 ¶

func (r *HostsResolver) ResolveIPv6(domain string) ([]net.IP, bool)

ResolveIPv6 returns only IPv6 addresses

func (*HostsResolver) SetHost ¶

func (r *HostsResolver) SetHost(domain string, ips ...net.IP)

SetHost sets a host entry (replaces existing)

type RouteMatcher ¶

type RouteMatcher interface {
	MatchDomain(domain string) (string, bool) // returns upstream, found
}

RouteMatcher matches domains to upstreams

type Server ¶

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

Server represents a DNS proxy server

func NewServer ¶

func NewServer(addr, upstream string) *Server

NewServer creates a new DNS server

func (*Server) AddRule ¶

func (s *Server) AddRule(domain string, upstream string)

AddRule adds a DNS routing rule

func (*Server) SetHostsFile ¶

func (s *Server) SetHostsFile(path string) error

SetHostsFile sets the hosts file for the DNS server

func (*Server) SetHostsResolver ¶

func (s *Server) SetHostsResolver(hosts *HostsResolver)

SetHostsResolver sets a custom hosts resolver for the DNS server

func (*Server) SetRouter ¶

func (s *Server) SetRouter(router RouteMatcher)

SetRouter injects the router for policy-based resolution

func (*Server) Start ¶

func (s *Server) Start(ctx context.Context) error

func (*Server) Stop ¶

func (s *Server) Stop(ctx context.Context) error

type UDPResolver ¶

type UDPResolver struct {
	Address string
}

UDPResolver implements DNS over UDP

func (*UDPResolver) Resolve ¶

func (r *UDPResolver) Resolve(q *dns.Msg) (*dns.Msg, error)

type UpstreamResolver ¶

type UpstreamResolver interface {
	Resolve(q *dns.Msg) (*dns.Msg, error)
}

UpstreamResolver defines the interface for DNS resolution

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL