Goベースのネットワークエクスプロイト・MITMフレームワーク。認可されたペネトレーションテスト、ネットワーク偵察、トラフィック傍受、ワイヤレスセキュリティテスト、レイヤー2/3/7の攻撃研究に対応。
Go で書かれたローカルおよびネットワークセキュリティ評価フレームワークです。これは 研究および許可されたペネトレーションテスト用のツールであり、ネットワーク 評価パイプライン — ホストおよびサービスの検出、列挙、認証情報の監査、脆弱性の特定、および許可されたエクスプロイト — をカバーします。その 10 個の モジュールカテゴリは、偵察、列挙、OSINT、MITM(ARP/DHCP/DNS/IPv6 ポイズニングおよびインライン HTTP/HTTPS 傍受)、ワイヤレス、スイッチレイヤー、 Web、認証、スパイ活動、ポストエクスプロイトに及び、すべてがインタラクティブな セッション、ガイド付きウィザード、またはワンショットのコマンドシーケンスから操作されます。
MITM はこの広範な領域における一つの機能にすぎません。TOHA3EE は man-in-the-middle シナリオに限定されません。
警告: toha3ee はネットワークトラフィックを能動的にリダイレクト、ポイズニング、復号、傍受します。 所有しているネットワーク、または明示的にテストを許可されたネットワークでのみ使用してください。これらのモジュールを第三者に対して実行することは、ほとんどの法域で違法です。 まず
docs/Security.mdをお読みください。
ワンライナーインストーラーは、最新リリースからお使いのプラットフォーム用の ビルド済みバイナリを取得し、その SHA-256 チェックサムを検証して PATH に追加します。 ビルド済みバイナリがまだ存在しない場合は、代わりにソースからビルドします。
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.sh | sh
Windows (PowerShell):
irm https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.ps1 | iex
またはチェックアウトから:
make install # installs ~/.local/bin/toha3ee and adds it to PATH
インストールオプション(Unix):--prefix <dir>(デフォルト:root の場合は /usr/local/bin、
それ以外は ~/.local/bin)、--no-path でシェル rc の編集をスキップ、--from-source
でダウンロードの代わりにビルド、TOHA3EE_VERSION=<tag> でリリースを固定します。
システム全体にインストールするには sudo sh ... で実行します。Windows インストーラーは
バイナリを %LOCALAPPDATA%\Programs\toha3ee\bin に配置し、ユーザー PATH を更新します。
Windows-on-ARM64 では x64 ビルドが実行されます。
Linux では、インストーラーはアプリをデスクトップ環境にも登録します。ロゴを hicolor アイコン
テーマにインストールし、インストールプレフィックスの隣(例:/usr/local/share や
~/.local/share)に .desktop エントリを配置するため、toha3ee はアイコン付きで
GNOME の検索に表示されます。Windows では .ico をコピーし、スタートメニューのショートカットを
作成します。リリースの tarball/zip にはアイコンが含まれているため、インストーラーは同じ検証済み
アーティファクトからアイコンを登録できます。
アンインストール:バイナリと、インストーラーがシェル rc に追加した PATH 行を削除します
(Windows では %LOCALAPPDATA%\Programs\toha3ee)。
インストール後は、次のコマンドで更新します:
toha3ee updates # `toha3ee update` works as an alias
インストール済みバージョンを最新の公式QYVORA GitHubリリースと照合し、ダウンロードしたファイルのSHA-256を公開されているチェックサムと検証したうえで、バイナリをアトミックに差し替えます。ダウングレードは拒否され、失敗した場合は現在のバイナリがそのまま維持されます — GoツールチェーンやGitは不要です。詳細はdocs/Update.mdを参照してください。
Go 1.26以降とlibpcapが必要です。
# Debian/Ubuntu
sudo apt install libpcap-dev
# then
go build ./cmd/toha3ee
Linux ビルドには libpcap ヘッダーが必要です(インストーラーのソースからのフォールバックはそれらをチェックし、不足している場合は適切な apt/dnf コマンドを表示します)。macOS は Xcode Command Line Tools に libpcap が同梱されています。
# Interactive session (bare command drops straight in)
sudo ./toha3ee --iface eth0
# Interactive session (explicit subcommand)
sudo ./toha3ee tui --iface eth0
# Guided wizard
sudo ./toha3ee wizard --iface eth0
# One-shot: scan the subnet, then show what was found
sudo ./toha3ee --eval "net.scan; net.show" --iface eth0
# One-shot: procedural deep recon (synscan -> fingerprint -> service enum)
sudo ./toha3ee --eval "net.recon; net.profile" --iface eth0
# Non-interactive caplet script
sudo ./toha3ee run --iface eth0 caplets/basic.cap
# Dry-run a .toha3ee script (validates it, prints the plan, sends no packets)
./toha3ee build scripts/full-pipeline.toha3ee
# Execute a .toha3ee script non-interactively
sudo ./toha3ee script --iface eth0 scripts/full-pipeline.toha3ee
ほとんどの攻撃モジュールは root 権限を必要とします(raw ソケット、パケットキャプチャ、IP
フォワーディング)。可能な場合は root として、または CAP_NET_ADMIN/CAP_NET_RAW を付けて実行してください。
--no-color を追加すると色付き出力が無効になり、-v で詳細ログが有効になります。
ネットワークスタックに触れる動詞(tui、wizard、eval、run、
script)はデフォルトで管理者権限で実行されます。Linux/macOS では、ツールは
sudo の下で自身を再実行し、管理者(root)パスワードの入力を求めます。
ローカルのみの動詞は権限昇格を行わず、パスワードも不要です — version、modules、
capabilities、completion、help、updates、build、report は
呼び出したユーザーとして非特権で実行されます。ネットワーク系の動詞でも権限昇格を
抑制するには --no-sudo を渡す(または TOHA3EE_NO_SUDO=1 を設定する)ようにしてください。
すべてはモジュールです。モジュールは自身のパッケージの init() で自己登録され、
レジストリによって自動的に公開されます。攻撃を追加するとは、attacks.Module
契約(internal/attacks/attacks.go を参照)を実装するパッケージを
internal/attacks/ の下に追加することを意味します:
Meta() — ID、カテゴリ、リスク、ターゲット、説明、制限事項Preflight(ctx) — 実行前に前提条件を確認するRun(ctx, opts) — 攻撃ループ(ctx.Done を尊重する必要がある)Verify(ctx) — 何が起きたかを報告するCleanup(ctx) — すべてを元に戻し、ネットワークを復元する中央の safety ライフサイクル(internal/safety)が登録されたクリーンアップと
ハートビートを追跡するため、パニックや SIGINT が発生してもすべての攻撃が確実に
解体されます。また、共有の store がホストインベントリ、キャプチャした認証情報、
セッション、およびレポートジェネレーターに供給されるイベントログを保持します。
| パス | 目的 |
|---|---|
cmd/toha3ee | CLI: コンソール、ウィザード、--eval、caplet ランナー、script/build |
internal/ui | コンソールレンダリング: バナー、パレット、セクション、テーブル、ステータスグリフ、HUD |
internal/script | .toha3ee スクリプト言語: レキサー、パーサー、エンジン |
internal/attacks/ | カテゴリ別のすべての攻撃モジュール |
internal/netx/ | プロトコルプリミティブ(ARP、DHCP、DNS、NDP、802.11、SMB/NTLM、プロキシ、…) |
internal/hijack | HTTP/HTTPS MITM プロキシと認証情報/セッションの傍受 |
internal/phish | キャプティブポータル型フィッシングとログインページのクローン |
internal/store | 共有データストアとイベントバス |
internal/safety | クリーンアップ/ハートビートのライフサイクル |
internal/config | JSON 設定の読み込み |
internal/oui | MAC ベンダーデータベース |
pkg/certutil | フレームワーク CA とホストごとの TLS 証明書 |
完全で最新のカタログを表示するには toha3ee modules を実行してください。主なもの: