git clone https://github.com/boy-hack/ksubdomain.git
cd ksubdomain
# Il est recommandé d'injecter le numéro de version via 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

Usage :
  ksubdomain [options globales] <commande> [options de commande]

Commandes :
  enum, e      Mode énumération : brute-force des sous-domaines d'un domaine principal
  verify, v    Mode vérification : vérifie si une liste de domaines est résolue
  test         Teste la vitesse maximale d'envoi de la carte réseau locale
  device       Affiche les informations sur les cartes réseau disponibles
  help, h      Affiche l'aide

Options globales :
  --help, -h       Affiche l'aide
  --version, -v    Affiche la version

Options :
  --domain, -d          Spécifie un domaine (peut être répété)
  --filename, -f        Lit une liste de domaines depuis un fichier
  --stdin               Lit depuis l'entrée standard
  --bandwidth, -b       Limite de bande passante, ex. 5m, 10m, 100m (par défaut 3m)
  --resolvers, -r       Spécifie les serveurs DNS (utilise ceux intégrés par défaut)
  --output, -o          Chemin du fichier de sortie
  --format, -f          Format de sortie : txt (défaut), json, csv, jsonl
  --silent, -s          Mode silencieux, n'affiche que les domaines (sans bannière ni journal)
  --only-domain, --od   N'affiche que le nom de domaine, sans IP/enregistrement
  --retry               Nombre de tentatives, -1 pour illimité (défaut 3)
  --timeout             Délai d'attente en secondes pour chaque requête (défaut 6)
  --interface, -e       Nom de l'interface réseau (peut être répété pour concurrence)
  --wildcard-filter     Filtre de résolution générique : none (défaut), basic, advanced
  --predict             Active le mode prédiction de sous-domaines
  --quiet, -q           N'affiche pas les résultats à l'écran (écrit seulement dans le fichier)
  --color, -c           Sortie colorée

# Vérifier un/plusieurs domaines
./ksubdomain v -d www.example.com -d mail.example.com

# Depuis un fichier, sauvegarder en txt
./ksubdomain v -f domains.txt -o output.txt

# Entrée par pipe, bande passante 10M, mode silencieux pour chaînage
cat domains.txt | ./ksubdomain v --stdin -b 10m -s --od | httpx -silent

# Filtrage avancé des résolutions génériques, sortie JSONL
./ksubdomain v -f domains.txt --wildcard-filter advanced --format jsonl -o output.jsonl

# Concurrence multi-cartes (cumul de bande passante)
./ksubdomain v -f domains.txt --interface eth0 --interface eth1

Options :
  --domain, -d          Domaine principal cible (peut être répété)
  --domain-list, --ds   Fichier contenant plusieurs domaines principaux
  --filename, -f        Chemin du dictionnaire (utilise le dictionnaire intégré par défaut)
  --use-ns-records      Lit les enregistrements NS des domaines et les ajoute aux résolveurs DNS
  (Les autres options sont identiques au mode verify)

# Énumération d'un seul domaine (dictionnaire intégré)
./ksubdomain e -d example.com

# Spécifier un fichier dictionnaire
./ksubdomain e -d example.com -f subdomains.txt -o result.txt

# Activer le mode prédiction + filtrage avancé des résolutions génériques
./ksubdomain e -d example.com --predict --wildcard-filter advanced

# Énumération par lots de plusieurs domaines principaux
./ksubdomain e --domain-list roots.txt -b 10m --format jsonl -o result.jsonl

# Chaînage avec httpx
./ksubdomain e -d example.com --od -s | httpx -silent

# Tester la vitesse maximale d'envoi de la carte réseau
./ksubdomain test

# Afficher les cartes réseau disponibles
./ksubdomain device

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

# Chaînage avec httpx pour détecter les serveurs Web
./ksubdomain e -d example.com -s --od | httpx -silent

# Chaînage avec nuclei pour le scan de vulnérabilités
./ksubdomain e -d example.com -s --od | nuclei -l /dev/stdin

# Traitement en flux JSONL, ne conserver que les enregistrements A
./ksubdomain e -d example.com --format jsonl | jq -r 'select(.type=="A") | .domain'

# Énumération par lots multi-domaines + déduplication
./ksubdomain e --domain-list roots.txt -s --od | sort -u > all_subs.txt

# Le tampon BPF est petit, il est recommandé de limiter la bande passante
sudo ./ksubdomain e -d example.com -b 5m

# Utilise généralement eth0
./ksubdomain e -d example.com --interface eth0

# Nécessite d'abord l'installation de Npcap, exécuter en tant qu'administrateur
.\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",
})

// Bloquant, collecte tous les résultats
results, err := scanner.Enum("example.com")

// Callback de flux, traitement en temps réel
err = scanner.EnumStream(ctx, "example.com", func(r sdk.Result) {
    fmt.Printf("%s => %v\n", r.Domain, r.Records)
})

# Tests unitaires (pas besoin de root)
go test ./pkg/...

# Tests de régression (nécessite root + réseau)
go build -o ksubdomain ./cmd/ksubdomain
sudo go test ./test/regression/... -tags regression -v -timeout 120s