DNS Reverse Proxy

Go to file

StalkR 39183f7887 github actions: enable golint		2 years ago
.github/workflows	github actions: enable golint	2 years ago
debian	debian: upgrade compat to 9, below is deprecated	4 years ago
.gitignore	Initial commit	9 years ago
LICENSE	license: add full text	7 years ago
Makefile	debian package	9 years ago
README.md	switch from travis to github actions	2 years ago
dns_reverse_proxy.go	domain name routing should not be case sensitive (#9 )	5 years ago
go.mod	go mod: update	3 years ago
go.sum	go mod: update	3 years ago

README.md

DNS reverse proxy

A DNS reverse proxy to route queries to different DNS servers. To illustrate, imagine an HTTP reverse proxy but for DNS.

It listens on both TCP/UDP IPv4/IPv6 on specified port. Since the upstream servers will not see the real client IPs but the proxy, you can specify a list of IPs allowed to transfer (AXFR/IXFR).

Example:

$ go run dns_reverse_proxy.go -address :53 \
    -default 8.8.8.8:53 \
    -route .example.com.=8.8.4.4:53 \
    -allow-transfer 1.2.3.4,::1

A query for example.net or example.com will go to 8.8.8.8:53, the default. However, a query for subdomain.example.com will go to 8.8.4.4:53. -default is optional - if it is not given then the server will return a failure for queries for domains where a route has not been given.

Setup

Install go package, create Debian package, install:

$ go get -u github.com/miekg/dns
$ go get -u github.com/StalkR/dns-reverse-proxy
$ cd $GOPATH/src/github.com/StalkR/dns-reverse-proxy
$ fakeroot debian/rules clean binary
$ sudo dpkg -i ../dns-reverse-proxy_1-1_amd64.deb

Configure in /etc/default/dns-reverse-proxy and start with /etc/init.d/dns-reverse-proxy start.

License

Apache License, version 2.0.

Thanks

the powerful github.com/miekg/dns Go library by @miekg

github.com/notsobad/dns-reverse-proxy fork with DNS-over-HTTPS routing support and passive DNS standard logging

Bugs, feature requests, questions

Create a new issue.