Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

README.md

DNS Over HTTPS Utilities

This repository contains utilities for working with DNS-over-HTTPS servers, which is right now just a simple version of the classic host(1) utility. It implements draft-ietf-doh-dns-over-https-05 (DoH), but has been successfully tested against Google's experimental DoH server, which seems to implement draft version 04.

Prerequisites

The script requires a Python interpreter. It has been tested on Python 3.6, but earlier versions of Python 3 may also work. All dependencies are specified in the requirements.txt file. If you like, you can install everything in a virtual environment:

$ cd doh-utils
$ python3 -m venv venv
$ . venv/bin/activate
$ pip install -r requirements.txt

Usage

Use the -h switch to see usage instructions:

$ ./doh-host -h
usage: doh-host [-h] [-p] [-t TYPE] [-v] hostname

DNS-over-HTTPS lookup utility

positional arguments:
  hostname              the DNS name to look up

optional arguments:
  -h, --help            show this help message and exit
  -p, --post            use HTTP POST instead of GET
  -t TYPE, --type TYPE  query type (default: ANY)
  -v, --verbose         enable verbose output
$

Examples:

$ ./doh-host mafr.de
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 35960
;; flags: qr rd ra; QUERY: 1, ANSWER: 9, AUTHORITY: 0, ADDITIONAL: 0
;; QUESTION SECTION:
;mafr.de.                       IN      ANY
;; ANSWER SECTION:
mafr.de.                3599    IN      A       104.236.124.34
mafr.de.                21599   IN      NS      ns-de.1and1-dns.de.
mafr.de.                21599   IN      NS      ns-de.1and1-dns.biz.
mafr.de.                21599   IN      NS      ns-de.1and1-dns.com.
mafr.de.                21599   IN      NS      ns-de.1and1-dns.org.
mafr.de.                21599   IN      SOA     ns-de.1and1-dns.de. hostmaster.kundenserver.de. 2016110702 28800 7200 604800 600
mafr.de.                3599    IN      MX      10 mx01.kundenserver.de.
mafr.de.                3599    IN      MX      10 mx00.kundenserver.de.
mafr.de.                3599    IN      AAAA    2604:a880:800:10::560:c001
$ ./doh-host --post --server "https://cloudflare-dns.com/dns-query" --type AAAA mafr.de
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 0
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0
;; QUESTION SECTION:
;mafr.de.                       IN      AAAA
;; ANSWER SECTION:
mafr.de.                3600    IN      AAAA    2604:a880:800:10::560:c001
$

Links

About

Utilities for working with DNS-over-HTTPS

Topics

Resources

License

Releases

No releases published

Packages

No packages published

Languages