Skip to content

trybyteful/public-dns-directory

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

331 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Public DNS Servers List by Byteful (Formerly Ping Proxies)

The most comprehensive public DNS server list on GitHub

Servers Countries Updated

License GitHub Actions Stars


About Ping Illustration


Daily-updated DNS resolvers organized by 153 countries with uptime metrics, DNSSEC status, and content filtering capabilities.

Quick Start · Available Lists · Usage Examples · Data Formats


Data Source: dnsdirectory.com

Quick Start

Download resolver lists instantly:

# All servers (IPv4)
curl -O https://raw.githubusercontent.com/pingproxies/public-dns-directory/main/resolvers/global/all.txt

# Trusted providers only (Google, Cloudflare, Quad9, etc.)
curl -O https://raw.githubusercontent.com/pingproxies/public-dns-directory/main/resolvers/global/trusted.txt

# By country (e.g., United States)
curl -O https://raw.githubusercontent.com/pingproxies/public-dns-directory/main/resolvers/by-country/US.txt

Features

Feature Description
9,800+ Servers Comprehensive coverage of public DNS resolvers worldwide
153 Countries Organized by ISO 3166-1 alpha-2 country codes
Rich Metadata Uptime (24h/30d/90d/1y), DNSSEC, blocking capabilities
Multiple Formats TXT for tools, JSON for developers, CSV for analysis
Auto-Updated Refreshed twice daily via GitHub Actions
Curated Lists Trusted, DNSSEC, ad-blocking, malware-blocking, family-safe

Available Lists

Global Lists

List Description Download
All Servers Complete IPv4 resolver list all.txt
Trusted Verified providers (Google, Cloudflare, Quad9) trusted.txt
DNSSEC DNSSEC-validating servers dnssec.txt
Ad-Blocking Blocks advertisements ad-blocking.txt
Malware-Blocking Blocks malicious domains malware-blocking.txt
Family-Safe Adult content filtering family-safe.txt
High Uptime 99%+ uptime (30 days) high-uptime.txt

By Country

Servers organized by ISO 3166-1 alpha-2 country codes.

Country IPv4 JSON
United States US.txt US.json
Germany DE.txt DE.json
United Kingdom GB.txt GB.json
France FR.txt FR.json
Netherlands NL.txt NL.json
Japan JP.txt JP.json
Canada CA.txt CA.json
Australia AU.txt AU.json

Browse all 153 countries →

By Continent

Continent File
Africa AF.txt
Asia AS.txt
Europe EU.txt
North America NA.txt
Oceania OC.txt
South America SA.txt

Usage Examples

Security Tools

# massdns - High-performance DNS resolution
massdns -r resolvers/global/all.txt -t A domains.txt -o S

# shuffledns - Subdomain enumeration
shuffledns -d example.com -r resolvers/global/trusted.txt -w wordlist.txt

# dnsx - DNS toolkit
cat subdomains.txt | dnsx -r resolvers/by-country/US.txt -a -resp

Python

import requests

url = "https://raw.githubusercontent.com/pingproxies/public-dns-directory/main/data/resolvers.json"
data = requests.get(url).json()

# Get all trusted DNSSEC servers
trusted_dnssec = [
    r for r in data["resolvers"]
    if r["trusted"] and r["dnssec"]["validating"]
]

for server in trusted_dnssec[:5]:
    print(f"{server['ip']} - {server['organization']}")

cURL / Shell

# Get server count
curl -s https://raw.githubusercontent.com/pingproxies/public-dns-directory/main/data/stats.json | jq '.totals.servers'

# List all US servers
curl -s https://raw.githubusercontent.com/pingproxies/public-dns-directory/main/resolvers/by-country/US.txt | grep -v "^#"

Data Formats

TXT — For Security Tools

One IP per line, compatible with massdns, shuffledns, dnsx.

# Public DNS Servers - United States (US)
# Source: https://dnsdirectory.com
# Updated: 2024-02-04T06:00:00Z
# Total: 1,234 servers
#
8.8.8.8
8.8.4.4
1.1.1.1

JSON — For Developers

Full metadata with nested structure.

{
  "ip": "8.8.8.8",
  "version": 4,
  "country_code": "US",
  "country": "United States",
  "organization": "Google LLC",
  "trusted": true,
  "dnssec": { "aware": true, "validating": true },
  "blocking": { "ads": false, "malware": false, "adult": false },
  "uptime": { "24h": 100.0, "30d": 99.98, "90d": 99.97, "1y": 99.95 }
}

Files:

CSV — For Analysis

Flat format for spreadsheets and databases: resolvers.csv

File Structure

├── resolvers/
│   ├── global/           # Aggregated lists (all, trusted, dnssec, etc.)
│   ├── by-country/       # IPv4 by country code (US.txt, DE.txt, ...)
│   ├── by-country-ipv6/  # IPv6 by country code
│   └── by-continent/     # By continent (NA.txt, EU.txt, ...)
└── data/
    ├── resolvers.json    # Complete dataset with metadata
    ├── resolvers.csv     # Flat CSV export
    ├── stats.json        # Statistics
    ├── by-country/       # JSON per country
    └── by-continent/     # JSON per continent

Update Schedule

This repository is automatically updated twice daily via GitHub Actions:

Schedule Time
Morning 06:00 UTC
Evening 18:00 UTC

Related Projects

Contributing

See CONTRIBUTING.md for guidelines.

Note: Files in resolvers/ and data/ are auto-generated. Do not edit directly.

License

MIT License — see LICENSE for details.


Data provided by dnsdirectory.com and Ping Proxies

About

Daily-updated global directory of 9,800+ public DNS resolvers across 153 countries, with uptime, DNSSEC, and filtering metadata in TXT, JSON, and CSV formats.

Topics

Resources

License

Contributing

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages