Clematis

[ 中文 | English ]

🛠️ أداة قوية لتحويل ملفات PE (EXE/DLL) إلى شيل كود مستقل عن العنوان (position-independent shellcode).

✨ الميزات الرئيسية

• دعم تحويل ملفات PE (EXE/DLL) إلى شيل كود
• متوافق مع بنيتي x86 و x64
• دعم وسائط سطر الأوامر
• خوارزمية ضغط LZNT1 مدمجة لتقليل حجم ملف الإخراج بشكل كبير
• إخفاء اختياري لتعزيز التخفي

📦 التثبيت

المتطلبات

pip install pefile lznt1

🚀 الاستخدام

python clematis.py -f <PE_file> -o <output_file> [-g <true/false>] [-c <true/false>] [-p <parameters>]

المعاملات

أمثلة

# Show help information
python clematis.py -h

# Basic usage
python clematis.py -f target.exe -o output.bin

# Disable obfuscation and compression
python clematis.py -f target.exe -o output.bin -g false -c false

# Pass arguments to target program
python clematis.py -f target.exe -o output.bin -p arg1 arg2

python clematis.py -f target.exe -o output.bin -p "arg1 arg2"

💪 مزايانا

• 🎯 دعم DOT NET
• 🗜️ دعم الضغط
• 🎭 دعم الإخفاء
• 🔄 دعم تمرير المعاملات
• 🚀 دعم كامل لـ golang
• 💪 الشيل كود المولّد قوي ومستقر

💡 فلسفة التصميم

في بعض البيئات الخاصة، قد نواجه التحديات التالية:

- 🛡️ Unable to perform process injection (AV/EDR/XDR blocking)
- 🔄 Executing golang programs in current process may cause blocking
- 💾 Memory leaks may occur after golang program execution
- ⚠️ Threads created by golang cannot be released!

لمعالجة هذه المشكلات، قمنا بتطوير clematis:

- ✨ Convert golang programs to shellcode
- 🎯 Direct execution in current process
- ♻️ Automatic memory release after execution
- 🚀 Completely avoid golang-related memory issues
- 🔄 Reclaim all threads created by golang

📝 ملاحظات

• تأكد من وجود صلاحيات كافية لقراءة ملفات PE المصدرية وكتابة الملفات الهدف
• يُنصح بالضغط عند تحويل الملفات الكبيرة
• قد يضيف الإخفاء بعض الحمل على الأداء لكنه يوفر تمويهًا أفضل

⚠️ المشكلات المعروفة

• قد تفشل أجزاء من تطبيق (exe) مبني باستخدام mingw | gcc في التحميل، وقد يكون السبب هو إعادة التوطين (relocation)؟ ( غير منفّذ )
• وصول غير قانوني للذاكرة في DOT NET ( تم الإصلاح )

🗓️ الميزات المخطط لها

• خيارات تشفير متقدمة لأمان أفضل
• واجهة رسومية لسهولة التشغيل
• مراقبة تقدم التحويل في الوقت الفعلي
• معالجة الموارد في PE
• قدرات مراوغة محسّنة، مثل [ProxyDll, Syscall, ...]

🔄 التحديثات الأخيرة

• 2024-12-27

  • دعم DOT NET (x64 | x86)

• 2024-12-28

  • إصلاح أعطال محتملة في برامج DOT NET (قد لا تحدث)

  • إضافة معالجة لـ IMAGE_DIRECTORY_ENTRY_EXCEPTION ( x64 )

  • تحديث الواجهات البرمجية لاستخدام NTAPI

⚠️ تحذير

• نحن لا نخطط لإصدار هذا التحديث مجانًا، بل سنضعه في دائرتنا المدفوعة.
• هذا المشروع سيظل متاحًا ومجانيًا، لكن قد لا يتم تحديثه في المستقبل، شكرًا لك!

🔍 كيف يعمل

يحوّل Clematis ملفات PE إلى شيل كود عبر الخطوات التالية:

1. قراءة وتحليل ملف PE الهدف
2. معالجة وسائط سطر الأوامر (إن وُجدت)
3. ضغط LZNT1 اختياري
4. معالجة إخفاء اختيارية
5. توليد شيل كود نهائي مستقل عن العنوان

flowchart TD
    A[START] --> B[Read PE file]
    B --> C[Parse PE structure]
    C --> D{Is there a command line argument?}
    D -- TRUE --> E[Process command line arguments]
    D -- FALSE --> F{Enable compression?}
    E --> F
    F -- TRUE --> G[LZNT1 compression]
    F -- FALSE --> H{Enable obfuscation?}
    G --> H
    H -- TRUE --> I[Execute obfuscation processing]
    H -- FALSE --> J[Generate shellcode]
    I --> J
    J --> K[Output result]
    K --> L[END]

🤝 المساهمة

نرحب بالمساهمات عبر فتح القضايا (Issues) وطلبات السحب (Pull Requests)!