proxy

type Config struct {
	UDPListenAddr *net.UDPAddr // if nil, then it does not listen for UDP
	TCPListenAddr *net.TCPAddr // if nil, then it does not listen for TCP

	TLSListenAddr *net.TCPAddr // if nil, then it does not listen for TLS (DoT)
	TLSConfig     *tls.Config  // necessary for listening for TLS

	Ratelimit          int      // max number of requests per second from a given IP (0 to disable)
	RatelimitWhitelist []string // a list of whitelisted client IP addresses

	RefuseAny bool // if true, refuse ANY requests

	CacheEnabled bool // cache status

	Upstreams []upstream.Upstream // list of upstreams
	Handler   Handler             // custom middleware (optional)
}

type DNSContext struct {
	Proto       string            // "udp", "tcp", "tls", "https"
	Req         *dns.Msg          // DNS request
	Res         *dns.Msg          // DNS response from an upstream
	Conn        net.Conn          // underlying client connection
	Addr        net.Addr          // client address
	Upstream    upstream.Upstream // upstream that was chosen
	UpstreamIdx int               // upstream index
}

type Handler interface {
	// ServeDNS can modify the DNSContext instance in any way
	// and should call next.ServeDNS to continue the execution
	ServeDNS(d *DNSContext, next Handler) error
}

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