Skip to content

brancogao/dns-propagation-checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DNS Propagation Checker

Global DNS Propagation Checker - Check DNS propagation across worldwide DNS servers in real-time.

🌐 Live Demo: https://dns-propagation.autocompany.workers.dev

Features

  • Global Coverage: Query DNS servers across North America, Europe, Asia, and Australia
  • Real-time Results: Get instant DNS propagation status with response times
  • Multiple Record Types: Check A, AAAA, CNAME, MX, NS, and TXT records
  • Free API Access: Integrate DNS checks into your workflow with our REST API
  • Edge Computing: Powered by Cloudflare Workers for fast, global response

Quick Start

Web UI

Visit https://dns-propagation.autocompany.workers.dev and enter a domain to check.

API

# Check A records
curl "https://dns-propagation.autocompany.workers.dev/api/check?domain=example.com&type=A"

# Check MX records
curl "https://dns-propagation.autocompany.workers.dev/api/check?domain=gmail.com&type=MX"

Response Format

{
  "domain": "example.com",
  "record_type": "A",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "results": [
    {
      "server": {
        "name": "Cloudflare",
        "ip": "1.1.1.1",
        "location": "San Francisco",
        "country": "United States",
        "country_code": "US"
      },
      "records": ["93.184.215.14"],
      "query_time": 45,
      "status": "success"
    }
  ],
  "propagated_count": 10,
  "total_count": 10,
  "propagation_percentage": 100
}

Supported DNS Record Types

Type Description
A IPv4 address
AAAA IPv6 address
CNAME Canonical name
MX Mail exchange
NS Name server
TXT Text record

DNS Servers

We query multiple public DNS resolvers worldwide:

Server Location Country
Cloudflare San Francisco US
Google Mountain View US
Quad9 Zurich CH
Cloudflare EU London GB
Google EU Amsterdam NL
DNS.WATCH Frankfurt DE
Cloudflare APAC Tokyo JP
Google APAC Singapore SG
Cloudflare AU Sydney AU
Google BR São Paulo BR

Use Cases

  1. DNS Migration: Verify your DNS changes have propagated globally
  2. Troubleshooting: Identify DNS resolution issues across regions
  3. Monitoring: Check DNS health for your domains
  4. Development: Test DNS configurations before going live

Technology Stack

  • Runtime: Cloudflare Workers (Edge Computing)
  • Language: TypeScript
  • DNS-over-HTTPS: Cloudflare DoH API
  • Caching: Cloudflare KV

Local Development

# Clone the repository
git clone https://github.com/brancogao/dns-propagation-checker.git
cd dns-propagation-checker

# Install dependencies
npm install

# Run development server
npm run dev

# Deploy to Cloudflare
npm run deploy

API Rate Limits

Tier Requests/day Price
Free 100 $0
Developer 10,000 $9/mo
Agency Unlimited $49/mo

License

MIT License - See LICENSE for details.

Author

Built by Auto Company

Related Projects

About

Global DNS Propagation Checker - Check DNS propagation across worldwide servers in real-time

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors