Skip to content

Simple DNS bench util that supports encrypted protocols.

License

Notifications You must be signed in to change notification settings

ameshkov/godnsbench

Repository files navigation

Go Report Card Latest release

godnsbench

A very simple DNS benchmarking tool based on dnsproxy.

How to install

  • Using homebrew:
    brew install ameshkov/tap/godnsbench
  • From source:
    go install github.com/ameshkov/godnsbench@latest
  • You can use a Docker image:
    docker run --rm ghcr.io/ameshkov/godnsbench --help
  • You can get a binary from the releases page.

Usage

Usage:
  godnsbench [OPTIONS]

Application Options:
  -a, --address=    Address of the DNS server you're trying to test. Note, that
                    for encrypted DNS it should include the protocol (tls://,
                    https://, quic://, h3://)
  -p, --parallel=   The number of connections you would like to open
                    simultaneously (default: 1)
  -q, --query=      The host name you would like to resolve. {random} will be
                    replaced with a random string (default: example.org)
  -t, --timeout=    Query timeout in seconds (default: 10)
  -r, --rate-limit= Rate limit (per second) (default: 0)
  -c, --count=      The overall number of queries we should send (default:
                    10000)
      --insecure    Do not validate the server certificate
  -v, --verbose     Verbose output (optional)
  -o, --output=     Path to the log file. If not set, write to stdout.

Help Options:
  -h, --help        Show this help message

Examples

10 connections, 1000 queries to Google DNS using DNS-over-TLS:

godnsbench -a tls://dns.google -p 10 -c 1000

10 connections, 1000 queries to Google DNS using DNS-over-HTTPS with rate limit not higher than 10 queries per second:

godnsbench -a https://dns.google/dns-query -p 10 -c 1000 -r 10

10 connections, 1000 queries for example.net to Google DNS using DNS-over-TLS:

godnsbench -a https://dns.google/dns-query -p 10 -c 1000 -q example.net

10 connections, 1000 queries for example.net with timeout 1 second to AdGuard DNS using DNS-over-QUIC:

godnsbench -a quic://dns.adguard.com -p 10 -c 1000 -t 1 -q example.net

10 connections, 1000 queries for random subdomains of example.net with timeout 1 second to Google DNS using DNS-over-TLS:

godnsbench -a tls://dns.google -p 10 -c 1000 -t 1 -q {random}.example.net