🧭 super_dns_client #

A modern and lightweight Dart library for performing DNS lookups via
🔹 DNS-over-HTTPS (DoH) and
🔹 traditional UDP/TCP resolvers — including System and Public SRV discovery.

Built for Flutter, Dart CLI, and backend apps.

🚀 Features #

• 🔍 Query A, AAAA, CNAME, SRV, TXT records
• 🌐 Supports both DoH and traditional UDP/TCP DNS
• ⚙️ Auto-detects System-configured DNS (macOS, Linux, Android, iOS)
• 🧩 Public resolver support: Quad9, AdGuard, Yandex, OpenDNS, Cloudflare, Google, Mullvad, etc.
• 💾 Built-in TTL-based SRV cache for performance
• 🧱 Built with universal_io, super_raw, and super_ip
• ✅ Null-safe, well-tested, CI-integrated

📦 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.linagora.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.linagora.com');
  for (var r in publicRecords) {
    print('PublicDNS(${r.resolverName}) → ${r.target}:${r.port}');
  }
}

⚙️ Available DNS Resolvers #

🔸 DNS-over-HTTPS (DoH) #

🔸 Traditional (UDP/TCP) #

• System-configured resolvers (/etc/resolv.conf, Android getprop, iOS fallback)
• Public resolvers (Quad9, AdGuard, Yandex, OpenDNS)
• TCP fallback if UDP is truncated or timed out

🧪 Run Tests #

dart test

🪪 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.

🌟 Example Output #

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

🧠 Summary #

✨ Since v0.3.0: super_dns_client is now a hybrid DNS resolver supporting
both DoH and UDP/TCP SRV record lookups with automatic fallback.