5Ghost WiFi Lab — セットアップ・ユーザーガイド

PINGEQUA · Dual-Band Wi-Fi Lab

5Ghost WiFi Lab — セットアップ・ユーザーガイド

Flipper Zero 向け PINGEQUA 5Ghost BW16（RTL8720DN）デュアルバンド Wi-Fi 開発ボード用。外部アンテナ版、ブラック版、グリーン版の3種類をカバーしており、いずれも同じボード、ファームウェア、アプリを共有します。

モジュール RTL8720DN (BW16) · 2.4 GHz + 5 GHz · 802.11 a/b/g/n
ホスト Flipper Zero · GPIO ヘッダー · UART (TX/RX) + 5V/GND
Flipper アプリ 5Ghost WiFi Lab .fap
モジュールファームウェア 5Ghost — 工場出荷時にプリロード済み
ソースとリリース github.com/pingequalab/5ghost-wifi-lab

クイックスタート — 3ステップ

ボードはプリロード済みです。通常の使用ではフラッシュするものはありません。

1
ボードを装着します。 Flipper Zero の電源を切り、その後 5Ghost モジュールを GPIO ヘッダー（上部のピン）に取り付けます。4本線の UART 接続が唯一の接続で、はんだ付けもジャンパー線も不要です。
2
アプリをコピーします。 GitHub Releases から最新の .fap をダウンロードし、Flipper の SD カードの /ext/apps/GPIO/ に配置します（qFlipper またはカードリーダーを使用）。
3
起動します。 Flipper で Apps → GPIO → 5Ghost WiFi Lab に進みます。ボードが検出されるとヘッダーに Official と表示され—これで稼働中です。
単一の汎用 .fap。 1つのビルドが Official、Momentum、Unleashed の各ファームウェアで動作します—公式ファームウェアが無効化する API を避けているため、どの環境でもクリーンにロードされます。選ぶべき別バージョンはありません。

アプリの中身

  • デュアルバンドスキャン — 2.4 および 5 GHz の AP を、信号強度、暗号化、正確な PMF（対応 / 必須）、WPA3 検出、同一 SSID のメッシュマーカーと共に一覧表示します。
  • チャンネルマップ — 両バンドの混雑状況を表示し、最も空いているチャンネルをハイライトします。
  • ハンドシェイクキャプチャ — 5 GHz で WPA/WPA2 の4ウェイハンドシェイクを取得し、標準の PCAP として SD に保存します。hashcat（モード 22000）や aircrack-ng にそのまま設定できます。
  • Evil Portal — キャプティブポータルページ：内蔵、同梱のデモ、または SD カード上の独自 .html。
  • PMF 対応 Deauth — 2.4 + 5 GHz で動作し、ターゲットが 802.11w / WPA3 で保護されている場合は、黙って失敗するのではなくその旨を通知します。
  • AP 作成 · ビーコン — キャプティブポータル付きのソフト AP を立ち上げたり、カスタム / ランダム / Rickroll のビーコンを送信したりできます。
  • すべて SD へ — スキャン（CSV）、認証情報、ハンドシェイク（PCAP）が /ext/apps_data/5ghost/ に保存され、画面上で確認されます。

互換性

ホスト機器 Flipper Zero（GPIO / UART）— 必須、付属せず
Flipper ファームウェア Official · Momentum · Unleashed
モジュール RTL8720DN (BW16)、5Ghost ファームウェアプリロード済み
非対応 他の BW16 ボード（ファームウェア/ピン配置が異なる）· ESP32 ボード（5 GHz 無線なし）· Flipper なしの単体使用

ファームウェアとブラウザリカバリ

通常、モジュールをフラッシュする必要はありません—プリロード済みで出荷されます。これはセーフティネットとしてのみです。モジュールファームウェアの更新が途中で中断された、破損した、または工場出荷状態に戻したい場合は、Web ブラウザから再フラッシュできます—Arduinoもツールチェーンもコマンドラインも不要です。

1
フラッシャーを開きます。 デスクトップの Chrome または Edge（または Android の Chrome）で flash.pingequa.com/devices/bw16-5ghost にアクセスします。Safari と Firefox は Web Serial API に対応しておらず、フラッシュできません。
2
ボードを接続します。 USB-C データケーブルでボードをコンピューターに接続し、Connect をクリックしてポートを選びます。OS が求めた場合は CH340 シリアルドライバをインストールしてください。
3
フラッシュします。 Flash をクリックします。自動的にダウンロードモードに入ります。失敗した場合は BOOT を押しながら RESET を軽く押し、BOOT を離して再接続します。フルイメージは 115200 baud で数分かかります—最後まで完了させてください。

トラブルシューティング

  • Flipper でアプリが表示されない： .fap が /ext/apps/GPIO/ にあることを確認し、Flipper を再起動してください。
  • ヘッダーに「Official」が表示されない / ボードが検出されない： Flipper の電源を切り、モジュールを GPIO ヘッダーにしっかりと取り付け直して電源を入れ直します。
  • 「App too old」または API 警告： お使いのファームウェア用の最新 .fap を GitHub Releases からダウンロードしてください。
  • 5 GHz の結果がない： 近くに 5 GHz ネットワークがあることを確認してください。5 GHz の到達距離は 2.4 GHz よりも本質的に短くなります。
  • 一部の AP で Deauth が効かない： それらは PMF（802.11w）/ WPA3 で保護されており、設計上免疫です—5Ghost はスキャン一覧でそれらをフラグ付けします。
  • 不正なフラッシュ後にモジュールが応答しない： 上記のブラウザリカバリフラッシャーを使用してください。

正直な限界

  • WPA3-SAE はオフラインで解読できません — どのツールでも不可能です。取得した SAE ハンドシェイクには、オフラインで解読可能なハッシュは含まれません。5Ghost は WPA3 を検出し、それをごまかすことなく「手の届かない」とラベル付けします。
  • PMF / WPA3 の AP は Deauth できません — これは 802.11w が設計通りに機能しているためです。
  • ハンドシェイクキャプチャは 5 GHz で動作します — 2.4 GHz ではこのチップはクライアントのアップリンクを受信できないことが多いため、キャプチャは 5 GHz 経路を使用します。
  • チャンネルをまたぐメッシュローミング（802.11r）は、シングルラジオのハードウェアでは完全に抑制するのが難しいです。

FAQ

フラッシュや配線は必要ですか？

いいえ。ボードは 5Ghost ファームウェアプリロード済みで出荷されます。GPIO ヘッダーに装着し、1つの .fap を SD カードにコピーするだけで、それがセットアップのすべてです。ブラウザでの再フラッシュはリカバリ用としてのみ存在します。

どの Flipper ファームウェアに対応していますか？

Official、Momentum、Unleashed です—3つすべてに対応する単一の汎用 .fap ビルドです。

オンボードアンテナと 8 dBi 外部アンテナでガイドは異なりますか？

いいえ。すべてのバリエーションでボード、ファームウェア、アプリは同じです。異なるのはアンテナと色だけで、セットアップは同一です。

WPA3 を解読できますか？

どのツールもオフラインでは不可能です。WPA/WPA2 については、4ウェイハンドシェイクを PCAP に取得し、ご自身のマシンで hashcat/aircrack-ng にかけられます。

Flipper Zero なしで動作しますか？

いいえ—これはコンパニオンモジュールです。Flipper がアプリと画面を動かすホストとなります。

責任ある使用に関するご注意。 許可されたセキュリティテスト、ネットワーク管理、教育目的にのみ使用してください。ご自身が所有する、または明示的な書面による許可を得ているネットワークや機器のみをテストしてください。許可のないネットワークの傶受や妨害は、ほとんどの法域で違法です。エンドユーザーは、現地の法律および無線規制—FCC Part 15（米国）、CE / RED（EU）、および現地の同等規定—への遵守について単独で責任を負います。「Flipper Zero」は Flipper Devices Inc. の商標であり、本製品は独立したコンパニオン製品であって、Flipper Devices との提携や同社による推奨はありません。

サポートが必要ですか？support@pingequa.com まで、注文番号、製品バリエーション、Flipper ファームウェアのバージョン、セットアップの写真を添えてメールしてください。