Update README

Signed-off-by: Knut Ahlers <knut@ahlers.me>
This commit is contained in:
Knut Ahlers 2019-08-25 16:44:34 +02:00
parent ed3c4cc1fa
commit fe93ee74e9
Signed by: luzifer
GPG key ID: DC2729FDD34BE99E

View file

@ -1,12 +1,13 @@
![](https://knut.in/project-status/personal-dns)
# Luzifer / personal-dns # Luzifer / personal-dns
`personal-dns` is a combination of two DNS servers in one container: [CoreDNS](https://coredns.io/) and Bind9. `personal-dns` is a Bind9 DNS server in a container.
The purpose is to be fully independent from provider and third-party DNS servers and have a neat list of additional features: 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 - No DNS query is sent to your providers DNS servers
- You decide which domains are available to you, no third party company - 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 - 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 - The container includes a [blacklist](https://github.com/StevenBlack/hosts) blocking quite a lot of crap
@ -22,10 +23,11 @@ This is quite easy:
$ docker build -t personal-dns . $ docker build -t personal-dns .
$ docker run --rm -ti -p 53:53 -p 53:53/udp personal-dns $ docker run --rm -ti -p 53:53 -p 53:53/udp personal-dns
$ dig +short @<ip of your container> health.server.test $ dig +short @<ip of your container> health.server.test
0.0.0.0 127.0.1.1
``` ```
### Connect your computer to the container ### 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 **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 - On **Android** I'm using the [DNS Changer](https://play.google.com/store/apps/details?id=com.frostnerd.dnschanger) App
- On **Android 8+** there is a neat option called "Private DNS" in your "Wi-Fi & Internet" settings