Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/redirect2me/which-dns
Detects which DNS server is being used - https://which.nameserve.rs/
https://github.com/redirect2me/which-dns
dns dns-resolver nameserver resolver
Last synced: about 1 month ago
JSON representation
Detects which DNS server is being used - https://which.nameserve.rs/
- Host: GitHub
- URL: https://github.com/redirect2me/which-dns
- Owner: redirect2me
- License: agpl-3.0
- Created: 2019-12-12T21:44:21.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-03-09T23:03:26.000Z (9 months ago)
- Last Synced: 2024-08-02T15:05:46.132Z (4 months ago)
- Topics: dns, dns-resolver, nameserver, resolver
- Language: Go
- Homepage: https://which.nameserve.rs/
- Size: 128 KB
- Stars: 408
- Watchers: 11
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome - redirect2me/which-dns - Detects which DNS server is being used - https://which.nameserve.rs/ (Go)
- awesome-repositories - redirect2me/which-dns - Detects which DNS server is being used - https://which.nameserve.rs/ (Go)
README
# Which DNS: DNS Resolver Detection [
](https://which.nameserve.rs/)
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](https://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](LICENSE.txt)
## Credits
[](https://github.com/mholt/certmagic "Certificate management")
[](https://m.do.co/c/976f479b2317 "Hosting")
[](https://git-scm.com/ "Version control")
[](https://github.com/ "Code hosting")
[](https://golang.org/ "Programming language")
[](https://www.goatcounter.com/ "Traffic Measurement")
[](https://letsencrypt.org/ "HTTPS certificates")
[](https://www.svgrepo.com/svg/277712/witch "favicon (modified)")
[](https://www.ubuntu.com/ "Server operating system")
[](https://watercss.netlify.app/ "Classless 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:
* [DNS-OARC's Check My DNS](https://cmdns.dev.dns-oarc.net/) - comprehensive: see the popup under "Network".
* [dnsleaktest](https://dnsleaktest.com/)
* [whatsmydnsserver](http://www.whatsmydnsserver.com/)
* [ipleak.net](https://ipleak.net/) - a bit of information overload though.
* [benchmark from GRC](https://www.grc.com/dns/benchmark.htm) - fat-client tool to benchmark which DNS servers are fastest from your workstation.
* [dnsadblock](https://dnsadblock.com/dns-leak-test/)
* [akahelp.net](https://developer.akamai.com/blog/2018/05/10/introducing-new-whoami-tool-dns-resolver-information) - name server that you can use with `dig`