16 stable releases (3 major)
| 4.0.0 | Apr 24, 2025 |
|---|---|
| 3.0.7 | Feb 15, 2025 |
| 3.0.6 | Dec 9, 2024 |
| 3.0.5 | Oct 17, 2024 |
| 1.0.3 | Oct 21, 2023 |
#440 in Command line utilities
177 downloads per month
150KB
2K
SLoC
nu_plugin_dns
Nushell plugin that does DNS queries and parses
results into meaningful types. Intended to be a native replacement for
dig. Uses the excellent
hickory crates.
Usage
- All queries by default attempt to validate records with DNSSEC. If records
do not have DNSSEC or the nameserver does not support it, then by default, it
falls back to plain queries. This behavior can be tuned with the
--dnssecflag. - Supported protocols are UDP, TCP, TLS, HTTPS, and QUIC
- If no nameserver address is specified, the system's DNS config is used, or if none is available, falls back to Google.
Examples
simple query for A / AAAA records
> dns query amazon.com
╭─#─┬───────────────header───────────────┬────────question─────────┬───────────────────────────────────answer────────────────────────────────────┬───────────────────────────────────────────────authority───────────────────────────────────────────────┬───additional───┬──────────────────edns──────────────────┬─size──╮
│ 0 │ ╭─────────────────────┬──────────╮ │ ╭───────┬─────────────╮ │ [list 0 items] │ ╭─#─┬────name─────┬─type─┬─class─┬──ttl──┬─────────────────────rdata─────────────────────┬──proof───╮ │ [list 0 items] │ ╭─────────────┬──────────────────────╮ │ 106 B │
│ │ │ id │ 64823 │ │ │ name │ amazon.com. │ │ │ │ 0 │ amazon.com. │ SOA │ IN │ 15min │ ╭─────────┬─────────────────────────────────╮ │ insecure │ │ │ │ rcode_high │ 0 │ │ │
│ │ │ message_type │ RESPONSE │ │ │ type │ AAAA │ │ │ │ │ │ │ │ │ │ mname │ dns-external-master.amazon.com. │ │ │ │ │ │ version │ 0 │ │ │
│ │ │ op_code │ QUERY │ │ │ class │ IN │ │ │ │ │ │ │ │ │ │ rname │ hostmaster.amazon.com. │ │ │ │ │ │ │ ╭───────────┬──────╮ │ │ │
│ │ │ authoritative │ false │ │ ╰───────┴─────────────╯ │ │ │ │ │ │ │ │ │ serial │ 2010194083 │ │ │ │ │ │ flags │ │ dnssec_ok │ true │ │ │ │
│ │ │ truncated │ false │ │ │ │ │ │ │ │ │ │ │ refresh │ 3min │ │ │ │ │ │ │ ╰───────────┴──────╯ │ │ │
│ │ │ recursion_desired │ true │ │ │ │ │ │ │ │ │ │ │ retry │ 1min │ │ │ │ │ │ max_payload │ 1.2 kB │ │ │
│ │ │ recursion_available │ true │ │ │ │ │ │ │ │ │ │ │ expire │ 1wk │ │ │ │ │ │ opts │ {record 0 fields} │ │ │
│ │ │ authentic_data │ false │ │ │ │ │ │ │ │ │ │ │ minimum │ 15min │ │ │ │ │ ╰─────────────┴──────────────────────╯ │ │
│ │ │ response_code │ No Error │ │ │ │ │ │ │ │ │ │ ╰─────────┴─────────────────────────────────╯ │ │ │ │ │ │
│ │ │ query_count │ 1 │ │ │ │ ╰───┴─────────────┴──────┴───────┴───────┴───────────────────────────────────────────────┴──────────╯ │ │ │ │
│ │ │ answer_count │ 0 │ │ │ │ │ │ │ │
│ │ │ name_server_count │ 1 │ │ │ │ │ │ │ │
│ │ │ additional_count │ 1 │ │ │ │ │ │ │ │
│ │ ╰─────────────────────┴──────────╯ │ │ │ │ │ │ │
│ 1 │ ╭─────────────────────┬──────────╮ │ ╭───────┬─────────────╮ │ ╭─#─┬────name─────┬─type─┬─class─┬────ttl────┬──────rdata──────┬──proof───╮ │ [list 0 items] │ [list 0 items] │ ╭─────────────┬──────────────────────╮ │ 87 B │
│ │ │ id │ 28567 │ │ │ name │ amazon.com. │ │ │ 0 │ amazon.com. │ A │ IN │ 9min 2sec │ 205.251.242.103 │ insecure │ │ │ │ │ rcode_high │ 0 │ │ │
│ │ │ message_type │ RESPONSE │ │ │ type │ A │ │ │ 1 │ amazon.com. │ A │ IN │ 9min 2sec │ 54.239.28.85 │ insecure │ │ │ │ │ version │ 0 │ │ │
│ │ │ op_code │ QUERY │ │ │ class │ IN │ │ │ 2 │ amazon.com. │ A │ IN │ 9min 2sec │ 52.94.236.248 │ insecure │ │ │ │ │ │ ╭───────────┬──────╮ │ │ │
│ │ │ authoritative │ false │ │ ╰───────┴─────────────╯ │ ╰───┴─────────────┴──────┴───────┴───────────┴─────────────────┴──────────╯ │ │ │ │ flags │ │ dnssec_ok │ true │ │ │ │
│ │ │ truncated │ false │ │ │ │ │ │ │ │ ╰───────────┴──────╯ │ │ │
│ │ │ recursion_desired │ true │ │ │ │ │ │ │ max_payload │ 1.2 kB │ │ │
│ │ │ recursion_available │ true │ │ │ │ │ │ │ opts │ {record 0 fields} │ │ │
│ │ │ authentic_data │ false │ │ │ │ │ │ ╰─────────────┴──────────────────────╯ │ │
│ │ │ response_code │ No Error │ │ │ │ │ │ │ │
│ │ │ query_count │ 1 │ │ │ │ │ │ │ │
│ │ │ answer_count │ 3 │ │ │ │ │ │ │ │
│ │ │ name_server_count │ 0 │ │ │ │ │ │ │ │
│ │ │ additional_count │ 1 │ │ │ │ │ │ │ │
│ │ ╰─────────────────────┴──────────╯ │ │ │ │ │ │ │
╰───┴────────────────────────────────────┴─────────────────────────┴─────────────────────────────────────────────────────────────────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────────────┴────────────────┴────────────────────────────────────────┴───────╯
specify query type
> dns query --type CNAME en.wikipedia.org
╭─#─┬───────────────header───────────────┬───────────question────────────┬──────────────────────────────────────answer───────────────────────────────────────┬───authority────┬───additional───┬──────────────────edns──────────────────┬─size─╮
│ 0 │ ╭─────────────────────┬──────────╮ │ ╭───────┬───────────────────╮ │ ╭─#─┬───────name────────┬─type──┬─class─┬─ttl──┬────────rdata────────┬──proof───╮ │ [list 0 items] │ [list 0 items] │ ╭─────────────┬──────────────────────╮ │ 74 B │
│ │ │ id │ 55408 │ │ │ name │ en.wikipedia.org. │ │ │ 0 │ en.wikipedia.org. │ CNAME │ IN │ 1day │ dyna.wikimedia.org. │ insecure │ │ │ │ │ rcode_high │ 0 │ │ │
│ │ │ message_type │ RESPONSE │ │ │ type │ CNAME │ │ ╰───┴───────────────────┴───────┴───────┴──────┴─────────────────────┴──────────╯ │ │ │ │ version │ 0 │ │ │
│ │ │ op_code │ QUERY │ │ │ class │ IN │ │ │ │ │ │ │ ╭───────────┬──────╮ │ │ │
│ │ │ authoritative │ false │ │ ╰───────┴───────────────────╯ │ │ │ │ │ flags │ │ dnssec_ok │ true │ │ │ │
│ │ │ truncated │ false │ │ │ │ │ │ │ │ ╰───────────┴──────╯ │ │ │
│ │ │ recursion_desired │ true │ │ │ │ │ │ │ max_payload │ 1.2 kB │ │ │
│ │ │ recursion_available │ true │ │ │ │ │ │ │ opts │ {record 0 fields} │ │ │
│ │ │ authentic_data │ false │ │ │ │ │ │ ╰─────────────┴──────────────────────╯ │ │
│ │ │ response_code │ No Error │ │ │ │ │ │ │ │
│ │ │ query_count │ 1 │ │ │ │ │ │ │ │
│ │ │ answer_count │ 1 │ │ │ │ │ │ │ │
│ │ │ name_server_count │ 0 │ │ │ │ │ │ │ │
│ │ │ additional_count │ 1 │ │ │ │ │ │ │ │
│ │ ╰─────────────────────┴──────────╯ │ │ │ │ │ │ │
╰───┴────────────────────────────────────┴───────────────────────────────┴───────────────────────────────────────────────────────────────────────────────────┴────────────────┴────────────────┴────────────────────────────────────────┴──────╯
specify query types by numeric ID, and get numeric IDs in output
> dns query --type [5, 15] -c google.com
╭─#─┬────────────────────header─────────────────────┬───────────question───────────┬──────────────────────────────────────────────────answer───────────────────────────────────────────────────┬──────────────────────────────────────────────────authority───────────────────────────────────────────────────┬───additional───┬──────────────────edns──────────────────┬─size─╮
│ 0 │ ╭─────────────────────┬─────────────────────╮ │ ╭───────┬──────────────────╮ │ [list 0 items] │ ╭─#─┬────name─────┬──────type──────┬─────class─────┬─ttl──┬────────────────rdata────────────────┬──proof───╮ │ [list 0 items] │ ╭─────────────┬──────────────────────╮ │ 89 B │
│ │ │ id │ 38468 │ │ │ name │ google.com. │ │ │ │ 0 │ google.com. │ ╭──────┬─────╮ │ ╭──────┬────╮ │ 1min │ ╭─────────┬───────────────────────╮ │ insecure │ │ │ │ rcode_high │ 0 │ │ │
│ │ │ │ ╭──────┬──────────╮ │ │ │ │ ╭──────┬───────╮ │ │ │ │ │ │ │ name │ SOA │ │ │ name │ IN │ │ │ │ mname │ ns1.google.com. │ │ │ │ │ │ version │ 0 │ │ │
│ │ │ message_type │ │ name │ RESPONSE │ │ │ │ type │ │ name │ CNAME │ │ │ │ │ │ │ │ code │ 6 │ │ │ code │ 1 │ │ │ │ rname │ dns-admin.google.com. │ │ │ │ │ │ │ ╭───────────┬──────╮ │ │ │
│ │ │ │ │ code │ 1 │ │ │ │ │ │ code │ 5 │ │ │ │ │ │ │ ╰──────┴─────╯ │ ╰──────┴────╯ │ │ │ serial │ 750526362 │ │ │ │ │ │ flags │ │ dnssec_ok │ true │ │ │ │
│ │ │ │ ╰──────┴──────────╯ │ │ │ │ ╰──────┴───────╯ │ │ │ │ │ │ │ │ │ │ refresh │ 15min │ │ │ │ │ │ │ ╰───────────┴──────╯ │ │ │
│ │ │ │ ╭──────┬───────╮ │ │ │ │ ╭──────┬────╮ │ │ │ │ │ │ │ │ │ │ retry │ 15min │ │ │ │ │ │ max_payload │ 1.2 kB │ │ │
│ │ │ op_code │ │ name │ QUERY │ │ │ │ class │ │ name │ IN │ │ │ │ │ │ │ │ │ │ │ expire │ 30min │ │ │ │ │ │ opts │ {record 0 fields} │ │ │
│ │ │ │ │ code │ 0 │ │ │ │ │ │ code │ 1 │ │ │ │ │ │ │ │ │ │ │ minimum │ 1min │ │ │ │ │ ╰─────────────┴──────────────────────╯ │ │
│ │ │ │ ╰──────┴───────╯ │ │ │ │ ╰──────┴────╯ │ │ │ │ │ │ │ │ │ ╰─────────┴───────────────────────╯ │ │ │ │ │ │
│ │ │ authoritative │ false │ │ ╰───────┴──────────────────╯ │ │ ╰───┴─────────────┴────────────────┴───────────────┴──────┴─────────────────────────────────────┴──────────╯ │ │ │ │
│ │ │ truncated │ false │ │ │ │ │ │ │ │
│ │ │ recursion_desired │ true │ │ │ │ │ │ │ │
│ │ │ recursion_available │ true │ │ │ │ │ │ │ │
│ │ │ authentic_data │ false │ │ │ │ │ │ │ │
│ │ │ │ ╭──────┬──────────╮ │ │ │ │ │ │ │ │
│ │ │ response_code │ │ name │ No Error │ │ │ │ │ │ │ │ │
│ │ │ │ │ code │ 0 │ │ │ │ │ │ │ │ │
│ │ │ │ ╰──────┴──────────╯ │ │ │ │ │ │ │ │
│ │ │ query_count │ 1 │ │ │ │ │ │ │ │
│ │ │ answer_count │ 0 │ │ │ │ │ │ │ │
│ │ │ name_server_count │ 1 │ │ │ │ │ │ │ │
│ │ │ additional_count │ 1 │ │ │ │ │ │ │ │
│ │ ╰─────────────────────┴─────────────────────╯ │ │ │ │ │ │ │
│ 1 │ ╭─────────────────────┬─────────────────────╮ │ ╭───────┬───────────────╮ │ ╭─#─┬────name─────┬─────type──────┬─────class─────┬─ttl──┬───────────────rdata───────────────┬──proof───╮ │ [list 0 items] │ [list 0 items] │ ╭─────────────┬──────────────────────╮ │ 60 B │
│ │ │ id │ 24790 │ │ │ name │ google.com. │ │ │ 0 │ google.com. │ ╭──────┬────╮ │ ╭──────┬────╮ │ 5min │ ╭────────────┬──────────────────╮ │ insecure │ │ │ │ │ rcode_high │ 0 │ │ │
│ │ │ │ ╭──────┬──────────╮ │ │ │ │ ╭──────┬────╮ │ │ │ │ │ │ name │ MX │ │ │ name │ IN │ │ │ │ preference │ 10 │ │ │ │ │ │ │ version │ 0 │ │ │
│ │ │ message_type │ │ name │ RESPONSE │ │ │ │ type │ │ name │ MX │ │ │ │ │ │ │ code │ 15 │ │ │ code │ 1 │ │ │ │ exchange │ smtp.google.com. │ │ │ │ │ │ │ │ ╭───────────┬──────╮ │ │ │
│ │ │ │ │ code │ 1 │ │ │ │ │ │ code │ 15 │ │ │ │ │ │ ╰──────┴────╯ │ ╰──────┴────╯ │ │ ╰────────────┴──────────────────╯ │ │ │ │ │ │ flags │ │ dnssec_ok │ true │ │ │ │
│ │ │ │ ╰──────┴──────────╯ │ │ │ │ ╰──────┴────╯ │ │ ╰───┴─────────────┴───────────────┴───────────────┴──────┴───────────────────────────────────┴──────────╯ │ │ │ │ │ ╰───────────┴──────╯ │ │ │
│ │ │ │ ╭──────┬───────╮ │ │ │ │ ╭──────┬────╮ │ │ │ │ │ │ max_payload │ 1.2 kB │ │ │
│ │ │ op_code │ │ name │ QUERY │ │ │ │ class │ │ name │ IN │ │ │ │ │ │ │ opts │ {record 0 fields} │ │ │
│ │ │ │ │ code │ 0 │ │ │ │ │ │ code │ 1 │ │ │ │ │ │ ╰─────────────┴──────────────────────╯ │ │
│ │ │ │ ╰──────┴───────╯ │ │ │ │ ╰──────┴────╯ │ │ │ │ │ │ │
│ │ │ authoritative │ false │ │ ╰───────┴───────────────╯ │ │ │ │ │ │
│ │ │ truncated │ false │ │ │ │ │ │ │ │
│ │ │ recursion_desired │ true │ │ │ │ │ │ │ │
│ │ │ recursion_available │ true │ │ │ │ │ │ │ │
│ │ │ authentic_data │ false │ │ │ │ │ │ │ │
│ │ │ │ ╭──────┬──────────╮ │ │ │ │ │ │ │ │
│ │ │ response_code │ │ name │ No Error │ │ │ │ │ │ │ │ │
│ │ │ │ │ code │ 0 │ │ │ │ │ │ │ │ │
│ │ │ │ ╰──────┴──────────╯ │ │ │ │ │ │ │ │
│ │ │ query_count │ 1 │ │ │ │ │ │ │ │
│ │ │ answer_count │ 1 │ │ │ │ │ │ │ │
│ │ │ name_server_count │ 0 │ │ │ │ │ │ │ │
│ │ │ additional_count │ 1 │ │ │ │ │ │ │ │
│ │ ╰─────────────────────┴─────────────────────╯ │ │ │ │ │ │ │
╰───┴───────────────────────────────────────────────┴──────────────────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────┴────────────────┴────────────────────────────────────────┴──────╯
pipe name into command
> 'google.com' | dns query
pipe lists of names into command
> ['google.com', 'amazon.com'] | dns query
query record name that has labels with non-renderable bytes
> [ $"ding(char -u '07')-ds", "metric", "gstatic", "com" ] | each { into binary } | collect { $in } | dns query
pipe table of queries into command (ignores --type flag)
> [{name: 'google.com', type: 'A'}, {name: 'amazon.com', type: 'A'}] | dns query
choose a different protocol and/or port
> dns query -p tls -n dns.google -s 8.8.8.8 en.wikipedia.org
> dns query -p https -n cloudflare-dns.com -s 1.1.1.1 en.wikipedia.org
> dns query -p quic -n dns.adguard-dns.com -s 94.140.15.15:853 en.wikipedia.org
Configuration
You can specify any of the command line flags in your config.nu to make them
permanent. If an option is specified in both the config.nu and the CLI, the
CLI takes precedence.
$env.config.plugins.dns = {
server: "94.140.15.15"
protocol: https
dns-name: dns.adguard-dns.com
dnssec-mode: none
tasks: 16
timeout: 30sec
}
Install
cargo install nu_plugin_dns
plugin add $"($env.CARGO_HOME)/bin/nu_plugin_dns"
plugin use dns
Dependencies
~49–82MB
~1.5M SLoC