From f2ffbf7741e4a2f152f61e2dc7804d3b28bb0dfc Mon Sep 17 00:00:00 2001 From: Knut Ahlers Date: Wed, 9 May 2018 23:18:58 +0200 Subject: [PATCH] Add README Signed-off-by: Knut Ahlers --- README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..dd0efd3 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# Luzifer / personal-dns + +`personal-dns` is a combination of two DNS servers in one container: [CoreDNS](https://coredns.io/) and Bind9. + +The purpose is to be fully independent from provider and third-party DNS servers and have a neat list of additional features: + +- No DNS query is sent to your providers DNS servers +- You decide which domains are available to you, no third party company +- Container does not log requesting IPs: You're not traced +- On every build a current list of [IANA](https://www.iana.org/domains/root/db) and [OpenNIC](https://wiki.opennic.org/opennic/dot) registered TLDs is loaded together with their authorative nameservers +- The container includes a [blacklist](https://github.com/StevenBlack/hosts) blocking quite a lot of crap + +As soon as you build and roll this DNS container and set your system to use it you should notice a lot of ad- and tracking requests to be gone even for example on your Android device where adblockers does not work that well. Also all connected devices can access any domain registered within the OpenNIC TLDs. + +## Usage + +### Build and run the container + +This is quite easy: + +```console +$ docker build -t personal-dns . +$ docker run --rm -ti -p 53:53 -p 53:53/udp personal-dns +$ dig +short @ health.server.test +0.0.0.0 +``` + +### Connect your computer to the container + +- On **Mac OS** go into the System Preferences, Network, edit your LAN / WiFi connection, enter the IP your container is reachable into DNS settings +- On **Android** I'm using the [DNS Changer](https://play.google.com/store/apps/details?id=com.frostnerd.dnschanger) App