Skip to content

redirect2me/which-dns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ecd0924 · Mar 9, 2024

History

38 Commits
Aug 27, 2023
Dec 14, 2019
Aug 27, 2023
Aug 27, 2023
Feb 21, 2024
Dec 14, 2019
Aug 22, 2023
Dec 14, 2019
Mar 9, 2024
Jun 19, 2021
Dec 21, 2019
Mar 9, 2024
Jun 19, 2021
Jan 8, 2020
Jan 8, 2020
Aug 27, 2023
Aug 23, 2023
Oct 25, 2020

Repository files navigation

Which DNS: DNS Resolver Detection Which DNS Logo

This is a combined DNS+HTTP server that shows which DNS server a computer is using.

How does it work?

  1. You make a request to a hostname with a unique prefix.
  2. All hostnames resolve to the same IP, but the DNS server records which IP address the query came from.
  3. The webserver looks for this record and returns it.

Using

My server is running at which.nameserve.rs.

Be forewarned: it is running on the cheapest box I could find with a static IP. You can hit it for light, non-commercial use. I specifically made the API be JSONP only (i.e. you need to provide a callback parameter), so if you abuse it, bad things will happen to your clients!

Make an HTTPS request to GUID.which.nameserve.rs/api.json?callback=myfunction. The GUID should be a unique string (not necessarily an actual GUID), different for every call. It will call myfunction with an object that has the following fields:

  • success - boolean if it succeeded or not
  • output - the result (if it succeeded)
  • message - the error message (if it failed)
  • source - the source IP address (useful for detecting self-hosted DNS)

You can see it in action on the home page of resolve.rs.

Running your own copy

You need a static IP address to run this server.

Then you need to decide on two host names:

  • hostname is the name of the subdomain that this server will own (for example: which.example.com)
  • nshostname is the name of the authoritative name server for the subdomain (for example: which-dns.example.com)

They will both be served by the same server and at the same IP address.

The following DNS records need to be added to the main domain (for the above examples this would be example.com):

  • A for the nshostname pointing to the static IP
  • NS for the hostname pointing to the nshostname

The program needs access to the following ports:

  • 53: for DNS
  • 80: for HTTP
  • 443: for HTTPS

The following parameters are required:

  • email: the email address for your account with Let's Encrypt (and the SOA record)
  • hostname: the hostname that you picked
  • ipaddress: the public IP address of the server
  • nshostname: the nshostname that you picked

Optional parameters:

  • disclaimer: text to include in every response (for example: "no commercial use")
  • proxy: true if behind a trusted proxy (uses X-Forwarded-For header)

License

GNU Affero General Public License v3.0

Credits

certmagic Digital Ocean Git Github golang GoatCounter Let's Encrypt svgrepo Ubuntu water.css

Alternatives

I wasn't the first person to come up with this idea. Here are some other public sites that do the same thing: