https://github.com/ventz/docker-dns-over-https
Docker Hub ventz/dns-over-https - DNS (tcp+udp 53) to CloudFlare and Google's HTTPS APIs
https://github.com/ventz/docker-dns-over-https
api dns dns-over-https https proxy security
Last synced: 4 months ago
JSON representation
Docker Hub ventz/dns-over-https - DNS (tcp+udp 53) to CloudFlare and Google's HTTPS APIs
- Host: GitHub
- URL: https://github.com/ventz/docker-dns-over-https
- Owner: ventz
- Created: 2016-11-29T03:09:53.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2020-02-22T06:07:21.000Z (almost 6 years ago)
- Last Synced: 2025-01-09T13:12:56.879Z (12 months ago)
- Topics: api, dns, dns-over-https, https, proxy, security
- Language: Perl
- Homepage: https://hub.docker.com/r/ventz/dns-over-https/
- Size: 6.84 KB
- Stars: 9
- Watchers: 2
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# What is "DNS over HTTPS"
## Last Updated: 2-22-2020
A very small (268 MB) and lightweight DNS server which responds to standard DNS (see supported resource records) queries on the front-end via tcp+udp 53, and it looks them up via HTTPS on the back-end, using one of two choices:
1.) Cloud Flare's HTTPS DNS API:
https://developers.cloudflare.com/1.1.1.1/dns-over-https/json-format/
or
2.) Google's HTTPS DNS API:
https://developers.google.com/speed/public-dns/docs/dns-over-https
It then responds to the query via standard DNS responses, which makes it viable
for using things like dig/host, and even pointing your system's
/etc/resolv.conf
# How to run the "DNS over HTTPS":
You have two choices for the backend:
1.) (default) CloudFlare
```
docker run -it -d \
--restart=always \
-p 53:53/udp \
-p 53:53 \
ventz/dns-over-https
```
or
2.) Google
```
docker run -it -d \
--restart=always \
-p 53:53/udp \
-p 53:53 \
ventz/dns-over-https google
```
# How to run the "DNS over HTTPS" with IPv6 support?
You can add '6' as a second parameter after the now required backend provider input:
1.) CloudFlare IPv6 Support:
```
docker run -it -d \
--restart=always \
-p 53:53/udp \
-p 53:53 \
ventz/dns-over-https cloudflare 6
```
or
2.) Google IPv6 Support:
```
docker run -it -d \
--restart=always \
-p 53:53/udp \
-p 53:53 \
ventz/dns-over-https google 6
```
# How to use it?
After you run the service (see above: "DNS over HTTPS"), you can manually test:
```
dig cnn.com @DOCKER-CONTAINER-IP-ADDRESS
```
or
```
dig -x 207.241.224.2 @DOCKER-CONTAINER-IP-ADDRESS
```
Or, you can even point your /etc/resolv.conf to:
```
nameserver DOCKER-CONTAINER-IP-ADDRESS
```
# Supported Resource Record Types:
* A
* AAAA
* CNAME
* PTR
* NS
* SRV
* TXT
* SPF
It is *extremely* easy to add additional resource records.
If you need to add a new one, first find the value for it:
https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4
Once you have the type and value, find the line in `entrypoint.pl` that looks like this:
```
elsif($qtype == 99) { $qtype = 'SPF'; }
```
and simply add another one for your new resource record.
For example, to add `LOC` (which is # 29), you would add:
```
elsif($qtype == 29) { $qtype = 'LOC'; }
```
Look up type you want and the value number (ex:
# Help/Questions/Comments:
For help or more info, please open a GitHub [issue](https://github.com/ventz/docker-dns-over-https/issues)