zone-walker v0.3.0

zone-walker

A CLI tool to walk through DNS zones using NSEC responses and enumerate the domains in a zone.

⚠️ zone-walker is beta software. Please report any issues encountered.

Installation

Requirements:

• getdns library installed - on Ubuntu, this requires the libgetdns-dev package.
• Node.js (tested on Node.js 16)

zone-walker is available via npm:

npm install --global zone-walker

Or use npx:

npx zone-walker ...

Usage

Usage: zone-walker [options] <zone>

Walks through DNS zones using NSEC responses and writes found domains to stdout.

Arguments:
  zone                          zone to traverse, e.g. "arpa."

Options:
  -P, --parallel <parallelism>  number of parallel searches to run (max: 36) (default: 1)
  -R, --rps <rps>               maximum number of domains to process per second (default: 10)
  -S, --start <domain>          start walking from after a specific domain. ignored if --parallel is passed (exclusive)
  -h, --help                    display help for command

Example

> zone-walker arpa.
as112.arpa
e164.arpa
home.arpa
in-addr.arpa
in-addr-servers.arpa
[ ... ]

Contributing

Bug fixes and features are welcome.

Run yarn locally to install dependencies.

To run the binary locally, use yarn start ....

To run tests, use yarn test. For more information on testing see test/README.md

See Also

• zone-walks - updated repository of TLD walks created using this tool
• ldns-walk - similar tool written in C, crashes when walking larger zones
• dnsrecon - DNS reconnaisance in Python, supports zone walking, though it doesn't work for TLDs
• TLDR2's Walkable Zones list - updated list of TLDs which allow zone walking