git clone https://github.com/boy-hack/ksubdomain.git
cd ksubdomain
# Рекомендуется внедрить номер версии через 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

Использование:
  ksubdomain [глобальные опции] <команда> [опции команды]

Команды:
  enum, e      Режим перебора: перебор поддоменов для основного домена
  verify, v    Режим проверки: проверка, разрешаются ли домены в списке
  test         Тестирование максимальной скорости отправки локальной сетевой карты
  device       Просмотр доступных сетевых интерфейсов
  help, h      Показать справку

Глобальные опции:
  --help, -h       Показать справку
  --version, -v    Вывести информацию о версии

Опции:
  --domain, -d          Указать домен (можно повторять)
  --filename, -f        Читать список доменов из файла
  --stdin               Читать из стандартного ввода
  --bandwidth, -b       Ограничение пропускной способности, например 5m, 10m, 100m (по умолчанию 3m)
  --resolvers, -r       Указать DNS-серверы (по умолчанию встроенные)
  --output, -o          Путь к выходному файлу
  --format, -f          Формат вывода: txt (по умолчанию), json, csv, jsonl
  --silent, -s          Тихий режим, вывод только доменов (без баннера и логов)
  --only-domain, --od   Выводить только домены, без IP/записей
  --retry               Количество повторов, -1 для бесконечных повторов (по умолчанию 3)
  --timeout             Таймаут одного запроса в секундах (по умолчанию 6)
  --interface, -e       Указать сетевой интерфейс (можно повторять для параллельной работы)
  --wildcard-filter     Фильтрация wildcard-записей: none (по умолчанию), basic, advanced
  --predict             Включить режим предсказания поддоменов
  --quiet, -q           Не выводить результаты на экран (только в файл)
  --color, -c           Цветной вывод

# Проверка одного/нескольких доменов
./ksubdomain v -d www.example.com -d mail.example.com

# Чтение из файла, сохранение в txt
./ksubdomain v -f domains.txt -o output.txt

# Ввод через конвейер, пропускная способность 10M, тихий режим для передачи в downstream
cat domains.txt | ./ksubdomain v --stdin -b 10m -s --od | httpx -silent

# Расширенная фильтрация wildcard, вывод JSONL
./ksubdomain v -f domains.txt --wildcard-filter advanced --format jsonl -o output.jsonl

# Параллельная работа с несколькими интерфейсами (суммирование пропускной способности)
./ksubdomain v -f domains.txt --interface eth0 --interface eth1

Опции:
  --domain, -d          Целевой основной домен (можно повторять)
  --domain-list, --ds   Файл со списком основных доменов
  --filename, -f        Путь к файлу словаря (по умолчанию встроенный словарь)
  --use-ns-records      Читать NS-записи домена и добавлять их в DNS-резолверы
  (остальные опции как в режиме verify)

# Перебор одного домена (с использованием встроенного словаря)
./ksubdomain e -d example.com

# Указание файла словаря
./ksubdomain e -d example.com -f subdomains.txt -o result.txt

# Включение режима предсказания + расширенная фильтрация wildcard
./ksubdomain e -d example.com --predict --wildcard-filter advanced

# Пакетный перебор нескольких основных доменов
./ksubdomain e --domain-list roots.txt -b 10m --format jsonl -o result.jsonl

# Передача в httpx через конвейер
./ksubdomain e -d example.com --od -s | httpx -silent

# Тестирование максимальной скорости отправки сетевой карты
./ksubdomain test

# Просмотр доступных сетевых интерфейсов
./ksubdomain device

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

# Совместно с httpx для обнаружения живых веб-серверов
./ksubdomain e -d example.com -s --od | httpx -silent

# Совместно с nuclei для сканирования уязвимостей
./ksubdomain e -d example.com -s --od | nuclei -l /dev/stdin

# Потоковая обработка JSONL, извлечение только A-записей
./ksubdomain e -d example.com --format jsonl | jq -r 'select(.type=="A") | .domain'

# Пакетный перебор нескольких доменов + дедупликация
./ksubdomain e --domain-list roots.txt -s --od | sort -u > all_subs.txt

# Буфер BPF мал, рекомендуется ограничить пропускную способность
sudo ./ksubdomain e -d example.com -b 5m

# Обычно используется eth0
./ksubdomain e -d example.com --interface eth0

# Требуется предварительная установка Npcap, запуск от имени администратора
.\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",
})

// 阻塞式，收集所有结果
results, err := scanner.Enum("example.com")

// 流式回调，实时处理
err = scanner.EnumStream(ctx, "example.com", func(r sdk.Result) {
    fmt.Printf("%s => %v\n", r.Domain, r.Records)
})

# Модульные тесты (без root)
go test ./pkg/...

# Регрессионные тесты (требуется root + сеть)
go build -o ksubdomain ./cmd/ksubdomain
sudo go test ./test/regression/... -tags regression -v -timeout 120s