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     ワイルドカードフィルター: 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、サイレントモードでダウンストリームツールに連携
cat domains.txt | ./ksubdomain v --stdin -b 10m -s --od | httpx -silent

# 高度なワイルドカードフィルター、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

# 予測モード + 高度なワイルドカードフィルターを有効化
./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 と連携して生存 Web を検出
./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