git clone https://github.com/boy-hack/ksubdomain.git
cd ksubdomain
# Se recomienda inyectar el número de versión mediante 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

Uso:
  ksubdomain [opciones globales] <comando> [opciones del comando]

Comandos:
  enum, e      Modo enumeración: fuerza bruta de subdominios en un dominio principal
  verify, v    Modo verificación: verifica si una lista de dominios resuelve
  test         Prueba la velocidad máxima de envío de la tarjeta de red local
  device       Muestra información de las tarjetas de red disponibles
  help, h      Muestra ayuda

Opciones globales:
  --help, -h       Muestra ayuda
  --version, -v    Imprime la versión

Opciones:
  --domain, -d          Especifica un dominio (repetible)
  --filename, -f        Lee la lista de dominios desde un archivo
  --stdin               Lee desde la entrada estándar
  --bandwidth, -b       Límite de ancho de banda, ej. 5m, 10m, 100m (por defecto 3m)
  --resolvers, -r       Especifica servidores DNS (por defecto usa los incorporados)
  --output, -o          Ruta del archivo de salida
  --format, -f          Formato de salida: txt (por defecto), json, csv, jsonl
  --silent, -s          Modo silencioso, solo muestra dominios (sin banner ni logs)
  --only-domain, --od   Solo muestra el dominio, sin IP/registro
  --retry               Número de reintentos, -1 para reintentos infinitos (por defecto 3)
  --timeout             Timeout de consulta individual en segundos (por defecto 6)
  --interface, -e       Especifica el nombre de la interfaz (repetible, múltiples interfaces concurrentes)
  --wildcard-filter     Filtro de comodín: none (por defecto), basic, advanced
  --predict             Habilita el modo de predicción de subdominios
  --quiet, -q           No imprime resultados en pantalla (solo escribe en archivo)
  --color, -c           Salida con colores

# Verificar un solo dominio / múltiples dominios
./ksubdomain v -d www.example.com -d mail.example.com

# Leer desde archivo, guardar en txt
./ksubdomain v -f domains.txt -o output.txt

# Entrada por pipe, ancho de banda 10M, modo silencioso para canalizar a herramientas posteriores
cat domains.txt | ./ksubdomain v --stdin -b 10m -s --od | httpx -silent

# Filtro avanzado de comodín, salida en JSONL
./ksubdomain v -f domains.txt --wildcard-filter advanced --format jsonl -o output.jsonl

# Envío concurrente con múltiples interfaces (suma de ancho de banda)
./ksubdomain v -f domains.txt --interface eth0 --interface eth1

Opciones:
  --domain, -d          Dominio principal objetivo (repetible)
  --domain-list, --ds   Archivo con múltiples dominios principales
  --filename, -f        Ruta del diccionario (por defecto usa el diccionario incorporado)
  --use-ns-records      Lee los registros NS del dominio y los agrega a los resolvedores DNS
  (las demás opciones son iguales que en modo verify)

# Enumerar un solo dominio (usando diccionario incorporado)
./ksubdomain e -d example.com

# Especificar archivo de diccionario
./ksubdomain e -d example.com -f subdomains.txt -o result.txt

# Habilitar modo de predicción + filtro avanzado de comodín
./ksubdomain e -d example.com --predict --wildcard-filter advanced

# Enumeración por lotes de múltiples dominios principales
./ksubdomain e --domain-list roots.txt -b 10m --format jsonl -o result.jsonl

# Canalizar a httpx
./ksubdomain e -d example.com --od -s | httpx -silent

# Probar velocidad máxima de envío de la tarjeta de red
./ksubdomain test

# Ver tarjetas de red disponibles
./ksubdomain device

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

# Integración con httpx para detectar servicios web activos
./ksubdomain e -d example.com -s --od | httpx -silent

# Integración con nuclei para escaneo de vulnerabilidades
./ksubdomain e -d example.com -s --od | nuclei -l /dev/stdin

# Procesamiento en flujo con JSONL, filtrado solo de registros A
./ksubdomain e -d example.com --format jsonl | jq -r 'select(.type=="A") | .domain'

# Múltiples dominios por lotes + deduplicación
./ksubdomain e --domain-list roots.txt -s --od | sort -u > all_subs.txt

# El buffer BPF es pequeño, se recomienda limitar el ancho de banda
sudo ./ksubdomain e -d example.com -b 5m

# Normalmente se usa eth0
./ksubdomain e -d example.com --interface eth0

# Requiere instalar Npcap y ejecutar como administrador
.\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",
})

// Bloqueante, recolecta todos los resultados
results, err := scanner.Enum("example.com")

// Streaming con callback, procesa en tiempo real
err = scanner.EnumStream(ctx, "example.com", func(r sdk.Result) {
    fmt.Printf("%s => %v\n", r.Domain, r.Records)
})

# Pruebas unitarias (no requiere root)
go test ./pkg/...

# Pruebas de regresión (requiere root + red)
go build -o ksubdomain ./cmd/ksubdomain
sudo go test ./test/regression/... -tags regression -v -timeout 120s