This repository provides a DNS benchmarking command-line tool written in Rust. It iterates through a built-in list of public DNS servers as well as automatically detected system DNS servers, measures their response times, and prints a table of sorted results in the console. You can use it to find the fastest DNS server for your location, improving your internet browsing experience. A preview, list of features, and the list of built-in DNS servers are provided below.

• Built-in list of public DNS servers
  Includes popular providers like Google, Cloudflare, Quad9, and more.
• Automatic detection of system DNS servers
  Detects and highlights your system's configured DNS servers (Linux, Windows, macOS).
• Multi-threaded benchmarking
  Runs benchmarks in parallel for faster results.

• Customizable request count, thread count, timeout, and domain
  Fine-tune how many requests, threads, and which domain to test.
• Protocol and IP version selection
  Choose between UDP/TCP and IPv4/IPv6 for both lookup and connection.
• Custom DNS server lists
  Use your own list of DNS servers instead of the built-in set.

• Multiple output formats
  Human-readable table, JSON, XML, or CSV for easy integration and analysis.
• Configurable table styles
  Choose from various table styles for better readability.
• Save favorite configurations
  Store your preferred settings in a config file for quick reuse.

• Docker support
  Run easily in a containerized environment (system DNS detection is skipped in Docker).
• Cross-platform
  Works on Linux, Windows, and macOS.

• If you don't have Rust programming language environment installed on your machine, then installation from Docker Hub will be the best option for you.
• If you have Rust programming language environment installed on your machine, then you can choose between installation from crates.io or installation from git repository.
• Installation from git repository is suitable only when you want to use the development version instead of the stable one or the crates.io service is unavailable.

Run the following command and wait until the crate is compiled:

$ cargo install dns-bench

Now you can run compiled binary:

$ dns-bench [OPTIONS]

Run the following command and wait until the crate is compiled:

$ cargo install --git https://github.com/qwerty541/dns-bench.git --tag v0.9.1 dns-bench

Also you can remove tag option to install the latest development version.

Now you can run compiled binary:

$ dns-bench [OPTIONS]

Run the following command to pull the image:

$ docker pull qwerty541/dns-bench:latest

Now you can run this tool inside the container:

$ docker run --rm -it --name dns-bench qwerty541/dns-bench:latest

If you want to pass some options, you can do it like this:

$ docker run --rm -it --name dns-bench qwerty541/dns-bench:latest /bin/bash -c "dns-bench --requests 20 --domain microsoft.com --style re-structured-text"

In case you want to use custom servers list, you have to mount the file with custom servers list to the container and pass the path to the file as an argument:

$ docker run --rm -it --name dns-bench --volume /home/alexandr/projects/dns-bench/examples/ipv4-custom-servers-example.txt:/ipv4-custom-servers-example.txt qwerty541/dns-bench:latest /bin/bash -c "dns-bench --custom-servers-file /ipv4-custom-servers-example.txt"

Below is a list of currently supported options.

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.