🧭 super_dns_client #

A modern, lightweight, and native-integrated DNS resolver for Dart and Flutter —
supporting both DNS-over-HTTPS (DoH) and traditional UDP/TCP lookups
with system-aware DNS discovery across all major platforms.

Built for Flutter, Dart CLI, and backend apps.

🚀 Features #

• 🔍 Query A, AAAA, CNAME, SRV, TXT records
• 🌐 Supports DoH and traditional UDP/TCP DNS
• 🧩 Native System DNS detection (macOS, Linux, Android, iOS)
• ⚙️ Public resolver fallback with automatic switching
• 💾 TTL-based SRV caching
• 🧱 Built with universal_io, super_raw, and super_ip
• ✅ Null-safe, CI-tested, production-ready

📦 Installation #

dependencies:
  super_dns_client: ^0.3.0

Then run:

dart pub get

💡 Example #

import 'package:super_dns_client/super_dns_client.dart';
import 'package:super_dns_client/src/udp_tcp/system_udp_srv_client.dart';
import 'package:super_dns_client/src/udp_tcp/public_udp_srv_client.dart';

void main() async {
  // Example 1: DNS-over-HTTPS (Cloudflare)
  final doh = DnsOverHttps.cloudflare();
  final records = await doh.lookup('google.com');
  for (var ip in records) {
    print('DoH → ${ip.address}');
  }

  // Example 2: SRV lookup via System-configured DNS
  final systemClient = SystemUdpSrvClient();
  final systemRecords = await systemClient.lookupSrv('_jmap._tcp.example.com');
  for (var r in systemRecords) {
    print('SystemDNS → ${r.target}:${r.port}');
  }

  // Example 3: SRV lookup via Public DNS resolvers
  final publicClient = PublicUdpSrvClient();
  final publicRecords = await publicClient.lookupSrv('_jmap._tcp.example.com');
  for (var r in publicRecords) {
    print('PublicDNS(${r.resolverName}) → ${r.target}:${r.port}');
  }
}

⚙️ Platform-specific System DNS Detection #

🧠 System detection is handled automatically by SystemUdpSrvClient,
which internally uses PlatformSystemDns to bridge native resolvers.

⚙️ Available DNS Resolvers #

🔸 DNS-over-HTTPS (DoH) #

🔸 Traditional (UDP/TCP) #

• System resolvers from platform configuration (Android, iOS, Linux, macOS)
• Public resolvers (Quad9, AdGuard, Yandex, OpenDNS, Cloudflare)
• TCP fallback for truncated UDP responses

🧪 Run Tests #

dart test

🌍 Example Output #

DnsOverHttps.cloudflare::SRV → _jmap._tcp.example.com → jmap.example.com:443
SystemUdpSrvClient::SRV → example.com:443
PublicUdpSrvClient(quad9)::SRV → jmap.example.com:443

🧠 Summary #

🪪 License #

Licensed under the MIT License.
See LICENSE for details.

❤️ Contributing #

Pull requests and ideas are welcome!
Open an issue or PR at GitHub Issues.