DuckLogger

DuckLogger — USB-клавиатурный логгер на базе ESP32-S3. Он записывает нажатия клавиш в текстовый файл и предоставляет беспроводной доступ для скачивания логов через встроенную точку доступа Wi-Fi. Для повторения этого проекта не требуется собственная печатная плата. Используемое здесь оборудование стоит менее $10 в сумме на таких площадках, как Aliexpress.

Возможности

• Запись нажатий клавиш: Записывает нажатия и сохраняет их в лог-файл во внутренней флеш-памяти.
• Два режима Wi-Fi: Поддерживает режим Wi-Fi Station (подключение к существующей сети) и режим точки доступа (Hotspot).
• Веб-центр управления и контроля: Доступ к встроенному веб-интерфейсу для управления устройством. Центр управления позволяет:
  • Скачивание логов: Легко скачивайте сохранённый файл лога нажатий.
  • Удалённая живая клавиатура: Подключите виртуальную клавиатуру и отправляйте нажатия через WebSocket в реальном времени с почти нулевой задержкой.
  • Внедрение DuckyScript: Удалённо внедряйте и выполняйте полезные нагрузки DuckyScript.
  • Настройки устройства: Обновляйте конфигурации режимов точки доступа/станции прямо из веб-интерфейса.

Доступ к веб-интерфейсу:

http://192.168.4.1/

(В режиме точки доступа)

Используемые компоненты

• ESP32-S3 SuperMini
• CH9350 HID Module
• 4 мама-папа перемычки

Начало работы

1. Схема подключения

CH9350 поддерживает несколько режимов работы, которые настраиваются с помощью встроенных DIP-переключателей.

Установите S0 в положение GND (0), а все остальные переключатели оставьте в противоположном положении (1). Это включает режим USB Host, который преобразует ввод с USB-клавиатуры в последовательные данные, передаваемые через UART со скоростью по умолчанию 115200 бод.

2. Прошивка MicroPython

DuckLogger написан на MicroPython. Прошейте вашу плату прошивкой MicroPython. Инструкции по прошивке здесь.

После прошивки отключите и снова подключите плату через USB.

3. Клонирование репозитория

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

4. Установка DuckLogger на плату

Убедитесь, что плата подключена через USB, затем выполните:

python flasher.py

Программа flasher автоматически:

• Установит mpremote и необходимые пакеты MicroPython на плату
• Сожмёт index.html и скопирует все файлы на плату
• Перезагрузит плату

Использование

1. Подключите USB-клавиатуру к модулю CH9350 HID.

2. Подключите ESP32-S3 SuperMini к целевому ПК с помощью кабеля USB-C — USB-A.

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

Сторонние библиотеки

Этот проект включает Microdot от Miguel Grinberg (лицензия MIT):
https://github.com/miguelgrinberg/microdot