dns

README

DNS - Simple DNS Client and Server

Installation

To install the package, run:

go get github.com/go-zoox/dns

Getting Started

func main() {
	server := dns.NewServer(&dns.ServerOptions{
		Port: 53,
	})
	client := dns.NewClient()

	server.Handle(func(host string, typ int) ([]string, error) {
		key := fmt.Sprintf("%s_%d", host, typ)

		if host == "gozoox.com" {
			return []string{"6.6.6.6"}, nil
		}

		if ips, err := client.LookUp(host, &dns.LookUpOptions{Typ: typ}); err != nil {
			return nil, err
		} else {
			logger.Info("found host(%s %d) %v", host, typ, ips)
			return ips, nil
		}
	})

	server.Serve()
}

Features

Client

• Plain DNS
  • Plain DNS in UDP
  • Plain DNS in TCP
• DNS-over-TLS (DoT)
• DNS-over-HTTPS (DoH)
• DNS-over-QUIC (DoQ)
• DNSCrypt

Server

• Plain DNS
  • Plain DNS in UDP
  • Plain DNS in TCP
• DNS-over-TLS (DoT)
• DNS-over-HTTPS (DoH)
• DNS-over-QUIC (DoQ)

Inspired By

• AdGuardHome - Network-wide ads & trackers blocking DNS server.
• kenshinx/godns - A fast dns cache server written by go.
• miekg/dns - DNS library in Go.

License

GoZoox is released under the MIT License.

Documentation

Index

• Variables
• func NewClient(options ...*ClientOptions) *client.Client
• func NewServer(options ...*ServerOptions) *server.Server
• type ClientOptions
• type ServerOptions

Variables

var Version = "1.1.3"

Version is the version of dns

Functions

func NewClient

func NewClient(options ...*ClientOptions) *client.Client

NewClient creates a new DNS client

func NewServer

func NewServer(options ...*ServerOptions) *server.Server

NewServer creates a new DNS server

Types

type ClientOptions

type ClientOptions = client.Options

ClientOptions is an alias for client.Options

type ServerOptions

type ServerOptions = server.Options

ServerOptions is an alias for server.Options