DuckLogger

DuckLogger は ESP32-S3 ベースの USB キーロガーです。キー入力をテキストファイルに記録し、内蔵の Wi-Fi アクセスポイントを介してログをダウンロードするためのワイヤレスアクセスを提供します。 このプロジェクトを再現するのにカスタム PCB は必要ありません。使用するハードウェアは、Aliexpress などで合計 10 ドル以下です。

機能

• キー入力ログ記録: キー入力を記録し、内部フラッシュストレージのログファイルに保存します。
• デュアル Wi-Fi モード: Wi-Fi ステーションモード（既存のネットワークに接続）とアクセスポイント（ホットスポット）モードの両方をサポートします。
• Web コマンド＆コントロールセンター: 内蔵の Web インターフェースにアクセスしてデバイスを管理できます。コントロールセンターでは以下のことが可能です：
  • ログのダウンロード: 保存されたキー入力ログファイルを簡単にダウンロードできます。
  • リモートライブキーボード: ライブ仮想キーボードを接続し、WebSocket を介してほぼ遅延なくリアルタイムでキー入力を送信できます。
  • DuckyScript インジェクション: DuckyScript ペイロードをリモートで注入・実行できます。
  • デバイス設定: Web UI から直接 AP/ステーションモードの設定を更新できます。

Web UI には以下からアクセス：

http://192.168.4.1/

(アクセスポイントモード時)

使用コンポーネント

• ESP32-S3 SuperMini
• CH9350 HID Module
• 4 Female Jumper Wires

はじめに

1. 配線図

CH9350 は複数の動作モードをサポートしており、オンボードの DIP スイッチで設定します。

S0 を GND 位置（0）に設定し、他のすべてのスイッチを反対の位置（1）に保ちます。これにより USB ホストモードが有効になり、USB キーボードの入力がデフォルトの 115200 ボーの UART 経由でシリアルデータに変換されます。

2. MicroPython の書き込み

DuckLogger は MicroPython で書かれています。ボードに MicroPython ファームウェアを書き込んでください。 書き込み手順はこちらで確認してください。

書き込み後、USB 経由でボードを抜き差ししてください。

3. リポジトリのクローン

git clone https://github.com/Itsmmdoha/duckLogger.git
cd duckLogger

4. ボードへの DuckLogger のインストール

ボードが USB で接続されていることを確認し、以下を実行：

python flasher.py

フラッシャーは自動的に以下を行います：

• mpremote と必要な MicroPython パッケージをボードにインストール
• index.html を圧縮し、すべてのファイルをボードにコピー
• ボードを再起動

使用方法

1. USB キーボードを CH9350 HID モジュールに接続します。
2. ESP32-S3 SuperMini を USB-C to USB-A ケーブルで対象 PC に接続します。
3. デバイスは自動的に以下を行います：
   • キー入力の記録を開始
   • 設定に応じて Wi-Fi に接続するか、Wi-Fi アクセスポイントを作成
   • HTTP サーバーを起動

アクセスポイントモード（デフォルト）の場合は、Wi-Fi アクセスポイントに接続し（デフォルトパスワード: duckPass1234）、以下を開きます：

http://192.168.4.1/

コマンド＆コントロールセンターにアクセスします。

サポートされている DuckyScript 構文

DuckLogger は現在、ペイロード注入のための基本的な DuckyScript コマンドセットをサポートしています：

リポジトリ構造

.
├── flasher.py
├── index.html
├── lib
│   ├── access_point.py
│   ├── api.py
│   ├── duckyscript.py
│   ├── keyboard.py
│   ├── key_led.py
│   ├── logger.py
│   ├── mapper.py
│   ├── microdot
│   │   ├── helpers.py
│   │   ├── __init__.py
│   │   ├── microdot.py
│   │   └── websocket.py
│   ├── queue.py
│   ├── settings.py
│   ├── uart_buffer.py
│   ├── wifi.py
│   └── wifi_radio.py
├── LICENSE
├── main.py
├── README.md
├── resources.md
└── settings.json

サードパーティライブラリ

このプロジェクトには Miguel Grinberg による Microdot（MIT ライセンス）が含まれています： https://github.com/miguelgrinberg/microdot