Fast DNS implementation for Go
Features
- 0 Dependency
- Similar Interface with net/http
- Fast DoH Server Co-create with fasthttp
- Fast DNS Client with rich features
- Compatible metrics with coredns
- High Performance
- 0-allocs dns request parser
- 0-allocs dns records marshaller
- worker pool + message pool
- prefork + reuse_port + set_affinity
Getting Started
DNS Server
package main
import (
"log"
"net"
"net/netip"
"os"
"github.com/phuslu/fastdns"
)
type DNSHandler struct {
Debug bool
}
func (h *DNSHandler) ServeDNS(rw fastdns.ResponseWriter, req *fastdns.Message) {
if h.Debug {
log.Printf("%s: CLASS %s TYPE %s\n", req.Domain, req.Question.Class, req.Question.Type)
}
switch req.Question.Type {
case fastdns.TypeA:
fastdns.HOST1(rw, req, 60, netip.AddrFrom4([4]byte{8, 8, 8, 8}))
case fastdns.TypeAAAA:
fastdns.HOST(rw, req, 60, []netip.Addr{netip.MustParseAddr("2001:4860:4860::8888")})
case fastdns.TypeCNAME:
fastdns.CNAME(rw, req, 60, []string{"dns.google"}, []netip.Addr{netip.MustParseAddr("8.8.8.8")})
case fastdns.TypeSRV:
fastdns.SRV(rw, req, 60, []net.SRV{{"www.google.com", 443, 1000, 1000}})
case fastdns.TypeNS:
fastdns.NS(rw, req, 60, []net.NS{{"ns1.google.com"}, {"ns2.google.com"}})
case fastdns.TypeMX:
fastdns.MX(rw, req, 60, []net.MX{{"mail.gmail.com", 10}, {"smtp.gmail.com", 10}})
case fastdns.TypeSOA:
fastdns.SOA(rw, req, 60, net.NS{"ns1.google"}, net.NS{"ns2.google"}, 60, 90, 90, 180, 60)
case fastdns.TypePTR:
fastdns.PTR(rw, req, 0, "ptr.google.com")
case fastdns.TypeTXT:
fastdns.TXT(rw, req, 60, "greetingfromgoogle")
default:
fastdns.Error(rw, req, fastdns.RcodeNXDomain)
}
}
func main() {
addr := ":53"
server := &fastdns.ForkServer{
Handler: &DNSHandler{
Debug: os.Getenv("DEBUG") != "",
},
Stats: &fastdns.CoreStats{
Prefix: "coredns_",
Family: "1",
Proto: "udp",
Server: "dns://" + addr,
Zone: ".",
},
ErrorLog: log.Default(),
}
err := server.ListenAndServe(addr)
if err != nil {
log.Fatalf("dnsserver error: %+v", err)
}
}DNS Client
$ go install github.com/phuslu/fastdns/cmd/fastdig@master
$ fastdig ip.phus.lu @8.8.8.8
; <<>> DiG 0.0.1-Fastdns <<>> ip.phus.lu
;; global options: +cmd +noedns
;; Got answer:
;; ->>HEADER<<- opcode: Query, status: Success, id: 2775
;; flags: qr rd ra; QUERY: 1, ANSWER: 2, AUTHORITY: 0, ADDITIONAL: 0
;; QUESTION SECTION:
;ip.phus.lu. IN A
;; ANSWER SECTION:
ip.phus.lu. 299 IN CNAME phus.lu.
phus.lu. 299 IN A 101.32.116.118
;; Query time: 15 msec
;; SERVER: 8.8.8.8#53(8.8.8.8)
;; WHEN: Mon Apr 12 22:07:16 +08 2021
;; MSG SIZE rcvd: 58DoH Server
$ go install github.com/phuslu/fastdns/cmd/fastdoh@master
$ fastdoh :8080High Performance
A Performance result as below, for daily benchmark results see github actions
# go test -v -cpu=1 -run=none -benchmem -bench=.
goos: linux
goarch: amd64
pkg: github.com/phuslu/fastdns
cpu: Intel(R) Xeon(R) Silver 4216 CPU @ 2.10GHz
BenchmarkHOST 46537387 25.77 ns/op 0 B/op 0 allocs/op
BenchmarkCNAME 26925482 44.65 ns/op 0 B/op 0 allocs/op
BenchmarkSRV 24188922 49.45 ns/op 0 B/op 0 allocs/op
BenchmarkNS 19585800 61.42 ns/op 0 B/op 0 allocs/op
BenchmarkSOA 16609441 72.44 ns/op 0 B/op 0 allocs/op
BenchmarkPTR 33774684 35.57 ns/op 0 B/op 0 allocs/op
BenchmarkMX 30105150 39.84 ns/op 0 B/op 0 allocs/op
BenchmarkTXT 51116004 22.45 ns/op 0 B/op 0 allocs/op
BenchmarkParseMessage 56425442 21.32 ns/op 0 B/op 0 allocs/op
BenchmarkSetQuestion 32210199 36.20 ns/op 0 B/op 0 allocs/op
BenchmarkSetResponseHeader 238730137 5.037 ns/op 0 B/op 0 allocs/op
BenchmarkDecodeName 36813590 32.48 ns/op 0 B/op 0 allocs/op
BenchmarkAppendHOSTRecord 73487632 16.07 ns/op 0 B/op 0 allocs/op
BenchmarkAppendCNAMERecord 34382904 35.39 ns/op 0 B/op 0 allocs/op
BenchmarkAppendSRVRecord 28153548 41.41 ns/op 0 B/op 0 allocs/op
BenchmarkAppendNSRecord 22970529 52.26 ns/op 0 B/op 0 allocs/op
BenchmarkAppendSOARecord 19043780 62.86 ns/op 0 B/op 0 allocs/op
BenchmarkAppendPTRRecord 44801985 26.81 ns/op 0 B/op 0 allocs/op
BenchmarkAppendMXRecord 38313138 30.91 ns/op 0 B/op 0 allocs/op
BenchmarkAppendTXTRecord 89567190 13.43 ns/op 0 B/op 0 allocs/op
BenchmarkUpdateStats 16593826 72.32 ns/op 0 B/op 0 allocs/op
BenchmarkEncodeDomain 74937819 15.95 ns/op 0 B/op 0 allocs/op
PASS
ok github.com/phuslu/fastdns 19.026s
Here is the real-world flamegraph 
Acknowledgment
This dns server is inspired by fasthttp, rawdns and miekg/dns.