DuckLogger

DuckLogger هو مسجل مفاتيح USB يعتمد على ESP32-S3. يسجل ضغطات المفاتيح في ملف نصي، ويوفر وصولاً لاسلكياً لتنزيل السجلات من خلال نقطة اتصال Wi-Fi مدمجة. لا تتطلب إعادة إنشاء هذا المشروع أي لوحة دوائر مطبوعة مخصصة. الأجهزة المستخدمة هنا تكلف أقل من 10 دولارات إجمالاً في أماكن مثل Aliexpress.

الميزات

• تسجيل ضغطات المفاتيح: يسجل ضغطات المفاتيح ويحفظها في ملف سجل في ذاكرة الفلاش الداخلية.
• وضعا Wi-Fi مزدوجان: يدعم كلاً من وضع المحطة (الاتصال بشبكة موجودة) ووضع نقطة الوصول (النقطة الساخنة).
• مركز القيادة والتحكم عبر الويب: يمكنك الوصول إلى واجهة ويب مدمجة لإدارة جهازك. يسمح لك مركز التحكم بما يلي:
  • تنزيل السجلات: تنزيل ملف سجل ضغطات المفاتيح المحفوظ بسهولة.
  • لوحة مفاتيح حية عن بُعد: إرفاق لوحة مفاتيح افتراضية حية وإرسال ضغطات مفاتيح عبر WebSocket في الوقت الفعلي مع زمن انتقال يكاد يكون معدوماً.
  • حقن DuckyScript: حقن وتنفيذ حمولات DuckyScript عن بُعد.
  • إعدادات الجهاز: تحديث إعدادات وضع نقطة الوصول/المحطة مباشرة من واجهة الويب.

الوصول إلى واجهة الويب على:

http://192.168.4.1/

(عندما يكون في وضع نقطة الوصول)

المكونات المستخدمة

• ESP32-S3 SuperMini
• وحدة CH9350 HID
• 4 أسلاك توصيل أنثوية

البدء

1. المخططات

يدعم CH9350 أوضاع تشغيل متعددة، يتم تكوينها باستخدام مفاتيح DIP الموجودة على اللوحة.

اضبط S0 على موضع GND (0) واترك جميع المفاتيح الأخرى في الموضع المعاكس (1). هذا يمكّن وضع مضيف USB، الذي يحول مدخلات لوحة المفاتيح 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

سيقوم المبرمج تلقائياً بما يلي:

• تثبيت 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