git clone https://github.com/boy-hack/ksubdomain.git
cd ksubdomain
# Si consiglia di iniettare il numero di versione tramite ldflags
go build -ldflags "-X github.com/boy-hack/ksubdomain/v2/pkg/core/conf.Version=v2.x.y" \
    -o ksubdomain ./cmd/ksubdomain

go install github.com/boy-hack/ksubdomain/v2/cmd/ksubdomain@latest

Utilizzo:
  ksubdomain [opzioni globali] <comando> [opzioni del comando]

Comandi:
  enum, e      Modalità enumerazione: brute force dei sottodomini di un dominio principale
  verify, v    Modalità verifica: verifica se un elenco di domini viene risolto
  test         Testa la velocità massima di invio della scheda di rete locale
  device       Mostra le informazioni sulle schede di rete disponibili
  help, h      Mostra l'aiuto

Opzioni globali:
  --help, -h       Mostra l'aiuto
  --version, -v    Stampa le informazioni sulla versione

Opzioni:
  --domain, -d          Specifica il dominio (ripetibile)
  --filename, -f        Legge l'elenco dei domini da un file
  --stdin               Legge dall'input standard
  --bandwidth, -b       Limite di banda, es. 5m, 10m, 100m (default 3m)
  --resolvers, -r       Specifica i server DNS (default usa quelli interni)
  --output, -o          Percorso del file di output
  --format, -f          Formato output: txt (default), json, csv, jsonl
  --silent, -s          Modalità silenziosa, mostra solo i domini (nessun banner o log)
  --only-domain, --od   Mostra solo il dominio, senza IP/record
  --retry               Numero di tentativi, -1 per tentativi infiniti (default 3)
  --timeout             Timeout in secondi per ogni query (default 6)
  --interface, -e       Specifica il nome della scheda di rete (ripetibile, per invio concorrente su più schede)
  --wildcard-filter     Filtro per record wildcard: none (default), basic, advanced
  --predict             Attiva la modalità di previsione dei sottodomini
  --quiet, -q           Non stampare i risultati a schermo (solo su file)
  --color, -c           Output a colori

# Verifica singolo/più domini
./ksubdomain v -d www.example.com -d mail.example.com

# Carica da file, salva come txt
./ksubdomain v -f domains.txt -o output.txt

# Input tramite pipe, banda 10M, modalità silenziosa per strumenti a valle
cat domains.txt | ./ksubdomain v --stdin -b 10m -s --od | httpx -silent

# Filtro avanzato per wildcard, output JSONL
./ksubdomain v -f domains.txt --wildcard-filter advanced --format jsonl -o output.jsonl

# Invio concorrente su più schede (accumula banda)
./ksubdomain v -f domains.txt --interface eth0 --interface eth1

Opzioni:
  --domain, -d          Dominio principale target (ripetibile)
  --domain-list, --ds   File con elenco di domini principali
  --filename, -f        Percorso del file dizionario (default usa il dizionario integrato)
  --use-ns-records      Legge i record NS del dominio e li aggiunge ai resolver DNS
  (le altre opzioni sono uguali alla modalità verify)

# Enumerazione di un singolo dominio (con dizionario integrato)
./ksubdomain e -d example.com

# Specifica il file dizionario
./ksubdomain e -d example.com -f subdomains.txt -o result.txt

# Attiva modalità previsione + filtro avanzato wildcard
./ksubdomain e -d example.com --predict --wildcard-filter advanced

# Enumerazione batch di più domini principali
./ksubdomain e --domain-list roots.txt -b 10m --format jsonl -o result.jsonl

# Pipe verso httpx
./ksubdomain e -d example.com --od -s | httpx -silent

# Testa la velocità massima di invio della scheda di rete
./ksubdomain test

# Visualizza le schede di rete disponibili
./ksubdomain device

./ksubdomain e -d example.com --interface eth0 --interface eth1 -b 20m

# Integrazione con httpx per rilevare Web attivi
./ksubdomain e -d example.com -s --od | httpx -silent

# Integrazione con nuclei per scansione vulnerabilità
./ksubdomain e -d example.com -s --od | nuclei -l /dev/stdin

# Elaborazione stream JSONL, prendi solo record A
./ksubdomain e -d example.com --format jsonl | jq -r 'select(.type=="A") | .domain'

# Batch multi-dominio + deduplicazione
./ksubdomain e --domain-list roots.txt -s --od | sort -u > all_subs.txt

# Il buffer BPF è piccolo, si consiglia di limitare la banda
sudo ./ksubdomain e -d example.com -b 5m

# Di solito si usa eth0
./ksubdomain e -d example.com --interface eth0

# È necessario installare Npcap ed eseguire come amministratore
.\ksubdomain.exe enum -d example.com

go get github.com/boy-hack/ksubdomain/v2/sdk

import "github.com/boy-hack/ksubdomain/v2/sdk"

scanner := sdk.NewScanner(&sdk.Config{
    Bandwidth:      "5m",
    Retry:          3,
    WildcardFilter: "advanced",
})

// Bloccante, raccoglie tutti i risultati
results, err := scanner.Enum("example.com")

// Callback in streaming, elaborazione in tempo reale
err = scanner.EnumStream(ctx, "example.com", func(r sdk.Result) {
    fmt.Printf("%s => %v\n", r.Domain, r.Records)
})

# Test unitari (senza root)
go test ./pkg/...

# Test di regressione (richiede root + rete)
go build -o ksubdomain ./cmd/ksubdomain
sudo go test ./test/regression/... -tags regression -v -timeout 120s