iamdockin/dns-service repository overview

⁠WiredAlter DNS Service

GitHub Repo: https://github.com/buildplan/dns-service⁠
Live service: https://dns.wiredalter.com⁠

A high-performance DNS intelligence API and web service. It provides real-time DNS record lookups (A, MX, NS, TXT, SOA) and propagation checks.

⁠Features

• Dual Interface: Web UI for humans, JSON/Text API for scripts (curl/wget).
• Deep Analysis: instantly resolves A, AAAA, MX, NS, TXT, and SOA records in parallel.
• Zero caching: Queries the global DNS network directly to ensure data is always fresh.
• Privacy First: Runs entirely in-memory. Zero logging of user queries.
• Dockerized: Simple deployment with docker compose.

⁠Usage

⁠Web Interface

Visit the homepage, dns.wiredalter.com⁠ to search for any domain name manually.

⁠CLI / API Access

Developers can use standard tools to fetch data over HTTPS.

⁠1. Text Report (CLI Friendly)

By default, curl requests receive a human-readable text summary.

curl https://dns.wiredalter.com/google.com

Sample Output:

🔎 DNS Report: google.com
------------------------------------------------
A Records   : 142.250.187.206
MX Records  : smtp.google.com (10)
Nameservers : ns1.google.com, ns2.google.com
TXT Records : 12 found (use API for full list)
------------------------------------------------

⁠2. Full JSON Data (API)

If the text report truncates data (e.g., "use /json to view") or if you need raw data for scripts, use the API endpoint:

curl https://dns.wiredalter.com/api/lookup/google.com

Example JSON Response:

{
  "domain": "google.com",
  "timestamp": "2023-10-27T10:00:00.000Z",
  "latency_ms": 45,
  "records": {
    "A": ["142.250.187.206"],
    "AAAA": ["2a00:1450:4009:81e::200e"],
    "MX": [
      { "exchange": "smtp.google.com", "priority": 10 }
    ],
    "NS": ["ns1.google.com", "ns2.google.com"],
    "TXT": ["v=spf1 include:_spf.google.com ~all"]
  }
}

⁠Example Use

⁠Security Audit: Extract SPF Records

Verify if a domain's email security policies (SPF) are correctly configured. This one-liner instantly grabs the SPF string from the noise of other TXT records.

# Filter TXT records to find only the SPF policy
curl -s https://dns.wiredalter.com/api/lookup/google.com | jq -r '.records.TXT[] | select(contains("v=spf1"))'

⁠Monitor DNS Propagation (SOA Serial)

Monitor DNS zone update with change to serial number, confirming an update has gone live.

# check the current Zone Serial Number
curl -s https://dns.wiredalter.com/api/lookup/google.com | jq '.records.SOA.serial'

⁠Fetch Mail Servers (MX)

Verify mail servers are pointing to the right provider (e.g., verifying Google Workspace setup).

# List all mail servers and their priority
curl -s https://dns.wiredalter.com/api/lookup/google.com | jq -r '.records.MX[] | "\(.priority) \(.exchange)"'

⁠IPv6 Readiness Check

Verify if a domain has valid IPv6 addresses (AAAA records) configured.

# Returns "true" if IPv6 records exist, "false" otherwise
curl -s https://dns.wiredalter.com/api/lookup/google.com | jq '.records.AAAA | length > 0'

⁠Installation (Self-Hosted)

1. Clone the repository:

git clone https://github.com/buildplan/dns-service.git
cd dns-service

Run with Docker:

Option 1: Quick Start: Default Docker compose file in the repo uses pre-built image from GitHub registry iamdockin/dns-service:latest.

docker compose up -d