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/ に出力

技術スタック

アーキテクチャ

AirmonGUI
├── backend/    FastAPI REST API と WebSocket、ツールごとに1つのルートモジュール
│               app/routes/ (interfaces, airodump, aireplay, aircrack, handshake, captures)
│               app/models.py (バリデート済み Pydantic I/O), app/state.py (インプロセスジョブレジストリ)
│               app/utils.py (サブプロセスとsudoロジック), app/config.py (環境設定)
│
├── frontend/   Vue 3 シングルページアプリ、コントロールコンソール
│               views/ (Overview, Monitor, Scan, Signal, Deauth, Handshake, Crack, Captures, Reports, Terminal, Logs)
│               composables/ (リアクティブなジョブおよび状態ロジック), api/ (fetchラッパー)
│
└── website/    スタンドアロンReactランディングサイト（オプション）

バックエンドは http://127.0.0.1:8000/api で REST API を提供し、/ws/terminal でターミナル用 WebSocket を提供します（APIトークンでゲート制御；AIRMON_GUI_TERMINAL_ENABLED=0 で無効化）。開発時は :5173 の Vite 開発サーバーが両方をバックエンドにプロキシします。

要件

トラブルシューティング

「wlan0 をチャネル N にロックできませんでした」またはスキャンしてもネットワークが表示されない。 ほとんどの場合、インターフェースがまだマネージドモードです。モニターモードにすることでアダプターがキャプチャとチャネル切り替えを行えるようになります。まずモニタータブから有効にするか（airmon-ng start wlan0）、その後モニターインターフェース（多くの場合 wlan0mon、ドライバーによっては元の名前が残る）でスキャンしてください。スキャンはマネージドインターフェースをこのヒントとともに拒否します。シングルチャネルスキャンは、事前ロックが確認できない場合でも中断されなくなりました。airodump-ng 自身がチャネルを調整するためです。

初回の実行ではネットワークが表示されるのに、2回目では表示されない。 モニターインターフェースが残っているか、実行と実行の間に NetworkManager がアダプターを再取得してスタック状態になることがあります。スキャン前に airmon-ng check kill（チェックキルボタン）を実行し、同じインターフェースで別のスキャンを開始する前に前のスキャンを停止してください。

ロードマップ

これらのいずれかへの協力を歓迎します。貢献を参照。

• ワンコマンドランチャー（Makefile ターゲットまたは Docker Compose）でバックエンドとフロントエンドを起動
• GPUクラックのための hashcat 連携
• PMKID キャプチャと攻撃
• 時間経過によるクライアントとAPのグラフ
• Reports ビューの完成とエクスポート機能
• パッケージリリースとインストールスクリプト

アイデアがありますか？Issueを開いてください。機能リクエストや質問も歓迎します。

貢献

プルリクエストを歓迎します。小さく焦点を絞ったものほど良いです。

1. CONTRIBUTING.md を読み、セットアップ、検証、安全規則を確認してください。
2. Fork、ブランチを作成し、変更は1つのことに限定してください。
3. バックエンド（uvicorn）とフロントエンド（npm run dev）の両方が正常に起動することを確認してください。
4. 変更内容と理由を記載した PR を開いてください。

各フォルダには独自の README があります：backend、frontend、website。

このプロジェクトが役に立つなら、スターを付けていただけると他の人が見つけやすくなり、継続する価値があると判断できます。

スター履歴

法的責任と責任ある使用

AirmonGUI は、自分が所有しているか、評価のための書面による許可を得ているネットワークにおける、許可されたワイヤレステスト、研究、教育を目的としています。

許可なくネットワークやデバイスのトラフィックを傍受したり、認証解除することは、ほとんどの法域で違法です。デフォルトでは API と開発サーバーをループバックにバインドしているのはそのためです。共有ネットワークや公開ネットワークに公開しないでください。著者は誤用について一切責任を負いません。本ソフトウェアを使用することにより、自分が触れるすべてのネットワークとデバイスについて許可を得ていることを確認したものとみなします。

ネットワークを理解し防御するために使用し、他人のネットワークを攻撃するために使用しないでください。

ライセンス

MIT、LICENSE 参照。実際の作業を行う aircrack-ng プロジェクトを基に構築されています。