Skip to content
GUI utility for querying DNS via DoH, DoT or UDP
Branch: master
Clone or download
Latest commit 98c20b9 Jul 19, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake
package
res windows packaging, mostly Jul 19, 2019
thirdparty Tidy up layout, particularly on macOS style. Add some default Jul 9, 2019
.gitattributes
.gitignore Windows packaging. Jul 10, 2019
CMakeLists.txt
LICENSE Initial commit Jul 1, 2019
README.md
add_resolver.cc
add_resolver.h Initial check in. Jul 1, 2019
build.sh Merge branch 'master' of github.com:wttw/dox Jul 19, 2019
defaultResolvers.json
defaultSurvey.json Initial check in. Jul 1, 2019
dns.cc Initial check in. Jul 1, 2019
dns.h Switch to using tdns. Several typo fixes. Jul 2, 2019
dns_dot.cc Initial check in. Jul 1, 2019
dns_dot.h Initial check in. Jul 1, 2019
dns_https_get.cc
dns_https_get.h
dns_https_post.cc Initial check in. Jul 1, 2019
dns_https_post.h Switch to using tdns. Several typo fixes. Jul 2, 2019
dns_system.cc Initial check in. Jul 1, 2019
dns_system.h Initial check in. Jul 1, 2019
dns_udp.cc
dns_udp.h Initial check in. Jul 1, 2019
dnswire.cc Replace ComboAddress with QHostAddress. Lots of minor changes for Win… Jul 4, 2019
dnswire.h
dox-icon.png windows packaging, mostly Jul 19, 2019
main.cc windows packaging, mostly Jul 19, 2019
mainwindow.cc Replace ComboAddress with QHostAddress. Lots of minor changes for Win… Jul 4, 2019
mainwindow.h Initial check in. Jul 1, 2019
network_manager.cc Initial check in. Jul 1, 2019
network_manager.h Switch to using tdns. Several typo fixes. Jul 2, 2019
ping.cc Tidy up layout, particularly on macOS style. Add some default Jul 9, 2019
ping.h Tidy up layout, particularly on macOS style. Add some default Jul 9, 2019
query.cc Tidy up layout, particularly on macOS style. Add some default Jul 9, 2019
query.h Tidy up layout, particularly on macOS style. Add some default Jul 9, 2019
resolvers.cc Initial check in. Jul 1, 2019
resolvers.h
resources.qrc windows packaging, mostly Jul 19, 2019
survey.cc Replace ComboAddress with QHostAddress. Lots of minor changes for Win… Jul 4, 2019
survey.h Initial check in. Jul 1, 2019
survey_data.cc
survey_data.h

README.md

dox

Query DNS resolvers over different protocols

dox is a simple GUI tool for querying DNS servers.

It can be used as an ad-hoc query tool in much the same way you might use dig or to survey the addresses different DNS servers will return for the same query (and measure performance differences between them).

Screenshot

Platforms

Dox builds on macOS, Windows and Linux and likely any other platform supported by Qt.

Protocols

Dox supports five different protocols

It doesn't support JSON API DNS over HTTPS, only "wireformat" queries.

Survey

Given a list of DNS resolvers and a list of URLs Dox can retrieve the content of each URL using each resolver to locate it.

Installation

There may be packaged binaries for Windows and macOS on the Github releases page, under "Assets".

To build from source you'll need these prerequisites:

... then ...

$ git clone https://github.com/wttw/dox.git
$ cd dox
$ mkdir build
$ cd build
$ cmake -G Ninja ..
$ ninja

Bugs

Many, probably. It's prone to just log and ignore errors rather than displaying them to the end user. This is not the tool you're looking for as a sysadmin to diagnose a server, nor to show that a DNS resolver is behaving correctly.

TODO

  • EDNS client subnet options

    • Persuading tdns to add them

    • UI, including a sensible default IP

  • End user docs

You can’t perform that action at this time.