AirmonGUI

aircrack-ng ワイヤレスツールキット向けのローカルWebインターフェースです。

スクリーンショット · クイックスタート · 機能 · ロードマップ · 貢献

[!WARNING] 自分が所有しているか、テストする書面での許可を得ているネットワークでのみ使用してください。許可なくネットワークをスキャン、認証解除、またはトラフィックをキャプチャすることは、ほとんどの国で違法です。詳細は法的責任と責任ある使用を参照してください。

これは何か

AirmonGUI は airmon-ng、airodump-ng、aireplay-ng、aircrack-ng を、自分のマシン上で動作する1つのWebアプリにまとめたものです。モニターモードの有効化、ネットワークのスキャン、WPAハンドシェイクのキャプチャ、そしてクラックまでを、フラグを覚える代わりにラベル付きのフォームをクリックして進められます。

各ツールを再実装しているわけではありません。バックエンドは実際のバイナリをシェル経由で呼び出し、その出力を解析するため、表示される内容はスイートが実際に行った処理そのものです。UI は 127.0.0.1 にバインドされ、API は決してマシンの外に出ません。

なぜ作ったのか

aircrack-ng スイートは優れていますが、ワークフローは4つの別々のコマンドと多くのフラグを頭に入れておく必要があります。カードをモニターモードにする、チャネルをホッピングしてターゲットを見つける、BSSID にロックする、正しいチャネルで deauth を送出する、4ウェイハンドシェイクを待つ、そしてキャプチャをワードリストに渡す。チャネルを間違えると deauth は無効になります。--bssid を忘れるとキャプチャにノイズが混ざります。

この一連の流れを、手順を案内する画面のセットとして、電波状況を表示し、各ステップ間の状態を正しく保持するものにしたかったのです。それがこれです。攻撃の実際の動作を学ぶため、ラボ作業、そして許可された評価の迅速化に役立ちます。

機能

しくみ

サイドバーを上から下へと進めます。以下が各画面です。

以下のスクリーンショットのネットワーク、BSSID、クライアントは実際のキャプチャではなく、合成されたデモデータです。

1. アダプターをモニターモードにする

インターフェースを選択し、ドライバー、チップセット、PHY を確認して、モニターモードをオンにします。終わったらそのインターフェースだけ解除します。

2. 電波をスキャンする

airodump-ng ジョブを開始し、アクセスポイントとクライアントが見つかるたびに表示。テーブルをフィルタリングし、任意のネットワークを deauth またはハンドシェイクワークフローに直接送信できます。

3. ターゲットを選ぶ

シグナル分析はすべてのアクセスポイントをスコアリングし、シグナルが強く、セキュリティが弱く、アクティブなクライアントがいるものを上位に表示します。各チャネルの混雑状況と周辺ネットワークのセキュリティも表示されます。自分のデバイスはフラグが付くため、誤って自分自身をターゲットにすることはありません。

4. ハンドシェイクをキャプチャする

この画面では、airodump-ng をターゲットの BSSID とチャネルにロックし、自動deauthエンジンを実行してクライアントを切断して再接続させ、4ウェイハンドシェイクがキャプチャされると即座に緑色に変わります。

5. クラックする

aircrack-ng にキャプチャとワードリストを指定します。実行中にログがストリーム表示され、パスフレーズがリストにあれば上部に表示されます。

その他のスクリーンショット：deauth、キャプチャ、ログ

チャネルロック付きのスタンドアロンdeauth、実行履歴、解析済みイベント出力：

キャプチャファイル管理：

セッションコマンド履歴：

クイックスタート

Linux、root権限、モニターモード対応ワイヤレスアダプター、および $PATH に aircrack-ng スイートが必要です。詳細は要件を参照してください。

# 0. スイートをインストール（Debian、Ubuntu、Kali）
sudo apt update && sudo apt install aircrack-ng wireless-tools

# 1. クローン
git clone https://github.com/ELHart05/AirmonGUI.git
cd AirmonGUI

# 2. バックエンド（ターミナル1）
cd backend
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
sudo -E .venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000

# 3. フロントエンド（ターミナル2）
cd frontend
npm install
npm run dev

http://localhost:5173 を開きます。UI は 127.0.0.1:8000 とのみ通信します。

初回接続時、UI は API トークンを要求します。バックエンドは起動時にコンソールに次のように出力します：

======================================================================
AirmonGUI API token (generated for this run):

    Xy3k...long-random-string...

Paste it into the AirmonGUI web UI when prompted.
======================================================================

そのトークンをロック解除画面に貼り付けます。再起動後も同じトークンを使い続けたい場合は、backend/.env に AIRMON_GUI_AUTH_TOKEN を設定します（バックエンドは起動時にこのファイルを読み込みます）。ヘルスチェックを除くすべてのAPIルートにはこのトークンが必要です。これにより、操作しているローカルプロセスや偶々開いているウェブページが、背後でワイヤレスツールを操作することを防ぎます。バックエンドを 127.0.0.1 以外にバインドする場合は、トークンを明示的に設定する必要があります。設定しないと起動しません。

シングルユーザーマシンでプロンプトが煩わしい場合は、AIRMON_GUI_AUTH_ENABLED=false と設定して認証を完全にオフにできます。UI はロック解除画面をスキップします。認証をオフにした場合、バックエンドはループバック以外にはバインドしません。API_HOST を 127.0.0.1 以外に指定すると起動しません。

root が必要なのは、airmon-ng、airodump-ng、aireplay-ng が raw ソケットを使用するためです。.venv/bin/uvicorn を直接呼び出してください（単に uvicorn としない）。sudo は PATH をリセットするため、virtualenv を見失います。-E フラグは設定した AIRMON_GUI_* 変数を保持します。サーバーを root として実行したくない場合は、それらのバイナリに対してパスワードなしの sudo を設定し、backend/app/utils.py を調整してください。

cd frontend
npm run build   # 静的ファイルを frontend/dist/ に出力

技術スタック

アーキテクチャ