git clone https://github.com/boy-hack/ksubdomain.git
cd ksubdomain
# Recomenda-se injetar o número da versão 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

Uso:
  ksubdomain [opções globais] <comando> [opções do comando]

Comandos:
  enum, e      Modo enumeração: brute force de subdomínios para um domínio principal
  verify, v    Modo verificação: verifica se uma lista de domínios resolve
  test         Testa a velocidade máxima de envio da placa de rede local
  device       Exibe informações das placas de rede disponíveis
  help, h      Exibe ajuda

Opções Globais:
  --help, -h       Exibe ajuda
  --version, -v    Exibe informações da versão

Opções:
  --domain, -d          Especifica domínio (pode ser repetido)
  --filename, -f        Lê lista de domínios de um arquivo
  --stdin               Lê da entrada padrão
  --bandwidth, -b       Limite de largura de banda, ex: 5m, 10m, 100m (padrão 3m)
  --resolvers, -r       Especifica servidores DNS (padrão usa internos)
  --output, -o          Caminho do arquivo de saída
  --format, -f          Formato de saída: txt (padrão), json, csv, jsonl
  --silent, -s          Modo silencioso, exibe apenas domínios (sem banner e logs)
  --only-domain, --od   Exibe apenas domínios, sem IPs/registros
  --retry               Número de tentativas, -1 para tentativas infinitas (padrão 3)
  --timeout             Timeout em segundos para cada consulta (padrão 6)
  --interface, -e       Nome da placa de rede (pode ser repetido, envio concorrente)
  --wildcard-filter     Filtro de wildcard: none (padrão), basic, advanced
  --predict             Ativa modo de predição de subdomínios
  --quiet, -q           Não imprime resultados na tela (apenas arquivo)
  --color, -c           Saída colorida

# Verificar domínio único/múltiplos
./ksubdomain v -d www.example.com -d mail.example.com

# Ler de arquivo, salvar como txt
./ksubdomain v -f domains.txt -o output.txt

# Entrada via pipe, largura de banda 10M, modo silencioso para integração com ferramentas downstream
cat domains.txt | ./ksubdomain v --stdin -b 10m -s --od | httpx -silent

# Filtro avançado de wildcard, saída JSONL
./ksubdomain v -f domains.txt --wildcard-filter advanced --format jsonl -o output.jsonl

# Envio concorrente por múltiplas placas de rede (somando largura de banda)
./ksubdomain v -f domains.txt --interface eth0 --interface eth1

Opções:
  --domain, -d          Domínio principal alvo (pode ser repetido)
  --domain-list, --ds   Arquivo com vários domínios principais
  --filename, -f        Caminho do arquivo de dicionário (padrão usa dicionário interno)
  --use-ns-records      Lê registros NS do domínio e os adiciona aos resolvedores DNS
  (demais opções iguais ao modo verify)

# Enumerar domínio único (usando dicionário interno)
./ksubdomain e -d example.com

# Especificar arquivo de dicionário
./ksubdomain e -d example.com -f subdomains.txt -o result.txt

# Ativar modo de predição + filtro avançado de wildcard
./ksubdomain e -d example.com --predict --wildcard-filter advanced

# Enumerar vários domínios principais em lote
./ksubdomain e --domain-list roots.txt -b 10m --format jsonl -o result.jsonl

# Integrar com httpx via pipe
./ksubdomain e -d example.com --od -s | httpx -silent

# Testar velocidade máxima de envio da placa de rede
./ksubdomain test

# Ver placas de rede disponíveis
./ksubdomain device

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

# Integrar com httpx para detectar Web ativo
./ksubdomain e -d example.com -s --od | httpx -silent

# Integrar com nuclei para varredura de vulnerabilidades
./ksubdomain e -d example.com -s --od | nuclei -l /dev/stdin

# Processamento em fluxo JSONL, extrair apenas registros A
./ksubdomain e -d example.com --format jsonl | jq -r 'select(.type=="A") | .domain'

# Vários domínios em lote + deduplicação
./ksubdomain e --domain-list roots.txt -s --od | sort -u > all_subs.txt

# Buffer BPF pequeno, recomenda-se limitar largura de banda
sudo ./ksubdomain e -d example.com -b 5m

# Geralmente use eth0
./ksubdomain e -d example.com --interface eth0

# Necessário instalar Npcap primeiro e executar 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, coleta todos os resultados
results, err := scanner.Enum("example.com")

// Callback em fluxo, processamento em tempo real
err = scanner.EnumStream(ctx, "example.com", func(r sdk.Result) {
    fmt.Printf("%s => %v\n", r.Domain, r.Records)
})

# Testes unitários (não requer root)
go test ./pkg/...

# Testes de regressão (requer root + rede)
go build -o ksubdomain ./cmd/ksubdomain
sudo go test ./test/regression/... -tags regression -v -timeout 120s