🍩 DNS over HTTPs command-line client
Using cloudflare, google, and quad9 the doh command-line utility can concurrently lookup all three sources for one or more given domain(s). You can even specify your own custom source to use.
Note
Since doh outputs everything as JSON, it pairs really well with tools like jq to parse relevant parts of the output for your purposes.
To get started, you will need go installed and properly configured.
$ go install -v github.com/picatz/doh@latestThe --help command-line flag can show you the top-level help menu.
$ doh --help
doh is a CLI for querying DNS records from DoH servers
Usage:
doh [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
query Query DNS records from DoH servers
Flags:
-h, --help help for doh
Use "doh [command] --help" for more information about a command.To get more information for the query command:
$ doh query --help
Query DNS records from DoH servers using the given domains and record type.
Users can specify which servers to use for the query, or use the default servers from Google, Cloudflare, and Quad9.
They can also specify a timeout for the query, which defaults to 30 seconds if not specified. Each server is queried
in parallel, and each domain is queried in parallel. Results are streamed to STDOUT as JSON newline delimited objects,
which can be piped to other commands (e.g. jq) or redirected to a file.
Usage:
doh query domains... [flags]
Flags:
-h, --help help for query
-k, --insecure-skip-verify allow insecure server connections (e.g. self-signed TLS certificates)
--resolver-addr string address of a DNS resolver to use for resolving DoH server names (e.g. 8.8.8.8:53)
--resolver-network string protocol to use for resolving DoH server names (e.g. udp, tcp) (default "udp")
--retry-max int maximum number of retries for each query (default 10)
--servers strings servers to query (default [https://dns.google/dns-query,https://cloudflare-dns.com/dns-query,https://dns.quad9.net:5053/dns-query])
--timeout duration timeout for query, 0s for no timeout (default 30s)
--type string dns record type to query for each domain, such as A, AAAA, MX, etc. (default "A")Let's say we're curious about google.com's IPv4 address. We can use doh to query three different sources (Google, Cloudflare, and Quad9) for the DNS A record type:
$ doh query google.com
{"server":"https://dns.google.com/resolve","resp":{"Status":0,"TC":false,"RD":true,"RA":true,"AD":false,"CD":false,"Question":[{"name":"google.com.","type":1}],"Answer":[{"name":"google.com.","type":1,"TTL":283,"data":"172.217.2.46"}]}}
{"server":"https://cloudflare-dns.com/dns-query","resp":{"Status":0,"TC":false,"RD":true,"RA":true,"AD":false,"CD":false,"Question":[{"name":"google.com","type":1}],"Answer":[{"name":"google.com","type":1,"TTL":129,"data":"142.251.178.101"},{"name":"google.com","type":1,"TTL":129,"data":"142.251.178.138"},{"name":"google.com","type":1,"TTL":129,"data":"142.251.178.113"},{"name":"google.com","type":1,"TTL":129,"data":"142.251.178.102"},{"name":"google.com","type":1,"TTL":129,"data":"142.251.178.100"},{"name":"google.com","type":1,"TTL":129,"data":"142.251.178.139"}]}}
{"server":"https://dns.quad9.net:5053/dns-query","resp":{"Status":0,"TC":false,"RD":true,"RA":true,"AD":false,"CD":false,"Question":[{"name":"google.com.","type":1}],"Answer":[{"name":"google.com.","type":1,"TTL":34,"data":"142.250.191.142"}]}}To get just all of the IPs from all of those sources, we could do the following:
$ doh query google.com | jq -r '.resp.Answer[0].data'
172.217.2.46
142.251.178.113
142.250.191.142We can also query multiple domains at once:
$ doh query bing.com google.com | jq -r '(.resp.Answer[0].name|rtrimstr(".")) + "\t" + .resp.Answer[0].data' | sort -n
bing.com 13.107.21.200
bing.com 204.79.197.200
bing.com 204.79.197.200
google.com 142.250.191.142
google.com 142.251.178.102
google.com 172.217.0.174To get IPv6 records, we'll need to specify the --type flag, like so:
$ doh query google.com --type AAAA
...To get MX records:
$ doh query google.com --type MX
...To get ANY records (which is only implemented by Google at the moment):
$ doh query google.com --type ANY --servers=https://dns.google.com/resolve
...Tip
To use a custom DNS over HTTPs source, specify the URL with the --servers flag.