Skip to content

Latest commit

 

History

History
98 lines (85 loc) · 3.3 KB

README.md

File metadata and controls

98 lines (85 loc) · 3.3 KB
Raw

DNS to DNS over TLS proxy

Simple proxy that captures DNS requests from the host, redirects the query over an encrypted channel to a DNS server that supports TLS (Cloudflare). It is a deamon that listen to conventional DNS requests on port 53 to capture DNS UDP and DNS TCP requests. Runs using multithreading and accept multiples requests.

Requirements

  • Python3
  • Docker
  • a ssl certificate on /etc/ssl/cert.pem

Usage

  • Running the python script locally:

    After download this repository, install dependencies:

    $ cd src
$ pip install -r requirements.txt

    After this, everything will be all set and you can run:

    $./proxy --help
Usage: proxy.py [OPTIONS]

DNS to DNS-over-TLS simple deamon.

Options:
  -p, --port INTEGER  Port of the listening proxy [default: 53]
  -a, --address TEXT  Address of the proxy network interface to use
                    [default: 0.0.0.0]
  -d, --dns TEXT      Domain Name Server with TLS support
                    [default: 1.1.1.1]
  -c, --ca TEXT       Path to the root and intermediate certificates file
                    [default: /etc/ssl/cert.pem]
  --help              Show this message and exit.

  • Running in a Docker container:

    On this step, you may build the image using the Dockerfile or just download and run the docker image from my Docker Hub account. To build and run the docker image:

    $ docker build -t="dnstls" .
$ docker run --rm -p 53:53/tcp -p 53:53/udp dnstls

    To run the image from Docker hub:

    $ docker run --rm -p 53:53/tcp -p 53:53/udp maraloide/dnstls

    You may set new values for configuration (dns server, port, etc) using the flags options when executing proxy.py. The docker container execute with the default configuration.

Testing

After start the proxy, you can test a DNS request using Dig. Query using UDP:

$ dig @127.0.0.1 google.com
; <<>> DiG 9.10.6 <<>> @127.0.0.1 google.com
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 25070
;; flags: qr rd ra; QUERY: 1, ANSWER: 6, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 1452
; PAD: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 (".....................................................................................................................")
;; QUESTION SECTION:
;google.com.			IN	A

;; ANSWER SECTION:
google.com.		145	IN	A	64.233.177.101
google.com.		145	IN	A	64.233.177.102
google.com.		145	IN	A	64.233.177.113
google.com.		145	IN	A	64.233.177.138
google.com.		145	IN	A	64.233.177.139
google.com.		145	IN	A	64.233.177.100

;; Query time: 135 msec
;; SERVER: 127.0.0.1#53(127.0.0.1)
;; WHEN: Sat Sep 28 21:31:43 EDT 2019
;; MSG SIZE  rcvd: 256

Query using TCP:

$ dig @127.0.0.1 google.com +tcp

Also, there is a bash script to make multiples DNS requests. The request is 50% tcp and 50% udp. Just run:

$ cd tests
$ ./queryflood.sh