DNS Propagation Checker

⚠️ This repository has been discontinued. Feel free to take inspiration from this project to build something awesome. <3

DNS Propagation Checker is a web application that allows you to check multiple DNS records against one or many Name Servers (NS). This can be useful before changing Name Servers for a Internet Domain from one hosting to another, by validating that a DNS zone resolves correctly on all resolvers before proceeding with the migration.

Features

Check multiple DNS records against multiple resolvers
Persistant configuration of records, servers and settings based of url
Color indication of matching DNS records, even if they come back in different order.

You can run it locally using docker, docker-compose, node or try out the online demo.

Build Status

Branch	Status
`master`

Start

Start the application using either docker, docker-compose or node below. Regardless of choice, the application will by default listen on http://localhost:3000.

Docker

Run jeliasson/dns-propagation-checker which is build on Docker Hub.

docker run -it -p 3000:3000 jeliasson/dns-propagation-checker

Docker - Build & Run

Build and run a docker container

# Clone repo
git clone https://github.com/jeliasson/dns-propagation-checker.git

# Enter created directory
cd dns-propagation-checker

# Build
docker built -t dns-propagation-checker .

# Start
docker run -it -p 3000:3000 dns-propagation-checker

Docker Compose

Build and run a docker container using docker-compose.

# Clone repo
git clone https://github.com/jeliasson/dns-propagation-checker.git

# Enter created directory
cd dns-propagation-checker

# Start
docker-compose up

Node

Make sure that you have the Linux utility dig installed. See Under the hood for more details.

# Clone repo
git clone https://github.com/jeliasson/dns-propagation-checker.git

# Enter created directory
cd dns-propagation-checker

# Install yarn deps
yarn install

# Start
yarn start

Contribute

Feel free to create a new project and let me know about it. Might join in :)

Under the hood

First off, it's not pretty and was done in a hurry. It's using the Linux utitlity dig for querying DNS servers, and using Vue and Nuxt to serve the front- and backend requests and shelljs to interact with dig.

The client side application can be found in /pages/index.vue. It's saving the state/settings on client side by changing the url, containing the url parameter settings - which is essentially a base64 encoded object holding records and servers. For now, and just because we can, it's using this base64 object when querying the /api/query endpoint.

On the server side of things in /api/routes/query.js, we take in posted data and making sure it's not containing any nasty user input. We construct a dig command, run it, check if there any difference between earlier resolves on that record, and finally respond with a JSON object.

Requests to /api/query is being rate limited to 10 requests over 60 seconds.

Todos

Add maximum of servers and records that can be queries on a single run
Enable/Disable server and record (server side processing)
Prettier interface

Get started

Fork the project, clone it, and make awesome updates. Send your Pull Request to origin :)

# Clone repo
git clone https://github.com/jeliasson/dns-propagation-checker.git

# Enter created directory
cd dns-propagation-checker

# Enter source directory
cd src

# Install yarn deps
yarn install

# Start
yarn dev            # Listening on localhost:3000 with hot reload

Licence

MIT