|
42 | 42 |
|
43 | 43 | ```bash |
44 | 44 | go install github.com/TMHSDigital/subenum@latest |
| 45 | +subenum yourdomain.com # a domain you own or are authorized to test |
45 | 46 | ``` |
46 | 47 |
|
| 48 | +With no `-w`, subenum uses its built-in list of the 5,000 most common subdomain labels (from SecLists, MIT-licensed), so a first scan finds real results without hunting for a wordlist. See [Choosing a wordlist](#choosing-a-wordlist) for larger lists. |
| 49 | + |
47 | 50 | Or build from a clone, which also gives you the sample wordlists used below: |
48 | 51 |
|
49 | 52 | ```bash |
@@ -234,7 +237,7 @@ make help # list all targets |
234 | 237 |
|
235 | 238 | | Flag | Default | Description | |
236 | 239 | | :--- | :---: | :--- | |
237 | | -| `-w <file>` | n/a | Wordlist file, one prefix per line; `#` comments allowed; `-` reads stdin **(required)** | |
| 240 | +| `-w <file>` | bundled top-5000 | Wordlist file, one prefix per line; `#` comments allowed; `-` reads stdin. Omit it to use the built-in list (see [Choosing a wordlist](#choosing-a-wordlist)) | |
238 | 241 | | `-dL <file>` | n/a | File of apex domains to scan, one per line (`-` reads stdin), instead of a `<domain>` argument. Each domain is an independent scan; results share one output | |
239 | 242 | | `-t <n>` | `100` | Concurrent worker goroutines | |
240 | 243 | | `-timeout <ms>` | `1000` | DNS timeout in milliseconds, applied to each record-type lookup separately | |
@@ -338,6 +341,19 @@ Press `Ctrl+C` at any time to abort. In-flight queries drain, partial results ar |
338 | 341 |
|
339 | 342 | With `-dL`, each domain is scanned in turn as an independent scan: `-max-queries`, `-rate` and the reliability guard apply per target. A failed target does not stop the others, but a reliability abort (the resolver looks overloaded) skips the remaining targets unless `-no-abort` is set. A per-target status list is printed at the end. |
340 | 343 |
|
| 344 | +### Choosing a wordlist |
| 345 | + |
| 346 | +Results can only be as good as the wordlist. Without `-w`, subenum uses its bundled top-5000 list (`data/subdomains-5k.txt`, from SecLists' `subdomains-top1million-5000.txt`), a good first pass that takes seconds. For deeper coverage: |
| 347 | + |
| 348 | +| List | Size | Notes | |
| 349 | +|------|------|-------| |
| 350 | +| [SecLists `Discovery/DNS`](https://github.com/danielmiessler/SecLists/tree/master/Discovery/DNS) | 5k to 1M+ | `subdomains-top1million-20000.txt` and `-110000.txt` are the usual next steps | |
| 351 | +| [Assetnote wordlists](https://wordlists.assetnote.io/) (`best-dns-wordlist.txt`) | ~9M | Built from real DNS data; for long, thorough scans | |
| 352 | +| [n0kovo subdomains](https://github.com/n0kovo/n0kovo_subdomains) | 50k to 3M | Tiered lists from scraped certificates | |
| 353 | +| [trickest wordlists](https://github.com/trickest/wordlists) | varies | Also maintains a public resolver list for `-r` | |
| 354 | + |
| 355 | +List size sets the query volume: each entry costs one query per record type (two with the default `A,AAAA`), per attempt, per recursion level. A 1M-entry list at `-rate 500` is about 70 minutes of wire time per target, so pair big lists with `-rate` (and `-r` for a resolver pool), and use `-max-queries` as a budget. `tools/wordlist-gen` builds a small target-specific list from a domain's own terms. |
| 356 | + |
341 | 357 | ### Monitoring for new subdomains |
342 | 358 |
|
343 | 359 | `-diff previous.jsonl` reports only what changed since an earlier run: `+ name` for new subdomains and `- name` for ones that disappeared (only when the run's verdict is `complete`, so failed lookups are never mistaken for removals). The `-o` file keeps the full current results for the next comparison, and the exit code is `4` when anything changed. [docs/monitoring.md](docs/monitoring.md) has a ready-to-use scheduled GitHub Actions workflow that opens an issue when new names appear. |
|
0 commit comments