LIKE-DBG

LIKE-DBG (LInux-KErnel-DeBuGger) هو مختبر مُحاط بالحاويات بالكامل لتصحيح أخطاء نواة لينكس واستغلال ثغراتها. يقوم ببناء نواة ونظام ملفات جذري أو تبنّيهما، ثم يُقلعهما تحت QEMU، ويضعك داخل جلسة GDB تفاعلية (pwndbg أو GEF)، مع ربط كل جزء في نافذة tmux واحدة.

الهدف هو إزالة الإعداد الممل حتى يذهب وقتك إلى النواة، لا إلى البنية التحتية. كل خطوة تعمل داخل Docker، لذا فإن الأشياء الوحيدة التي تثبّتها على المضيف هي Docker وtmux وPython وuv. اختر إصدار نواة (أو سلّمه تحدّي CTF)، ونفّذ أمرًا واحدًا، وستصل إلى start_kernel مع رموز كاملة.

ما الذي يفعله

أمر واحد يحلّ إعداداتك، ويبني نواة ونظام ملفات جذري أو يعيد استخدامهما، ويُقلع الضيف، ويُرفق المُصحّح:

uv run ./start_kgdb

الحلقة هي حلقة تبقى داخلها: ابنِ أو تبنَّ نواة وrootfs، وأقلعها تحت QEMU (الـ Debuggee)، وأرفق GDB (الـ Debugger)، ثم حرّر، وسلّم، وشغّل، وأحدث انهيارًا، وحدّد السبب الجذري، وكرّر.

هناك طريقتان للحصول على نواة:

• ابنِ نواتك بنفسك. اختر إصدارًا، وملف تعريف تصحيح، ومترجمًا؛ يقوم LIKE-DBG بتنزيله وتهيئته وبنائه مرة واحدة، ثم يخزّنه مؤقتًا. هذا هو الخيار اليومي لدراسة النواة وتطوير الاستغلالات. راجع docs/build-your-own-kernel.md.
• أحضِر نواة CTF أو نواة خارجية. سلّمه bzImage/Image الخاص بتحدٍّ ما (بالإضافة إلى vmlinux وinitramfs إن كانت لديك) وسيقلعها كما هي حرفيًا تحت GDB. راجع docs/ctf-foreign-kernel.md.

أبرز الميزات

• يعمل على macOS وLinux، مع اكتشاف المضيف تلقائيًا. تقلع Apple Silicon ضيوف arm64 بتسريع HVF الأصلي؛ أما x86_64-on-Mac وLinux بدون KVM فيرجعان إلى TCG داخل الحاوية؛ وLinux مع KVM يستخدمه. يتم اختيار التخزين والتسريع والشبكات لكل مضيف وتسجيلها لكل تشغيل.
• المعماريات: x86_64 وarm64.
• إعداد TOML مع ملفات تعريف التصحيح. حزمة TOML طبقية (إعدادات المشروع الافتراضية، والتجاوزات المحلية الشخصية، والسيناريوهات المسماة، وCLI) بالإضافة إلى ملفات تعريف مسماة (exploit-dev، hardened، kasan، ubsan، lockdep، وغيرها) تُحل إلى أجزاء إعداد النواة وإعدادات وقت التشغيل الافتراضية. يلتقط التحقق من .config بعد البناء ملف تعريف لم يُطبَّق. لاحظ أن exploit-dev (الافتراضي) يوقف KASLR فقط؛ تبقى SMEP وSMAP وKPTI مفعّلة ما لم تبدّل ملفات التعريف أو تبدّلها بنفسك (راجع docs/configuration.md).
• مصحّح أخطاء حديث. تعتمد تشغيلات النواة افتراضيًا على pwndbg لمجموعة أوامر النواة الخاصة به (قاعدة KASLR، slab، current، التنقل بين المهام والوحدات، البحث عن الرموز)؛ وGEF يُفعَّل بسطر واحد.
• حلقة تطوير الاستغلال الداخلية. يسلّم --run و--upload استغلالًا إلى الضيف الحي عبر مشاركة 9p أو SSH. يُترجم ملف .c واحد بلا أعلام تلقائيًا ترجمة ساكنة بـ musl إلى معمارية الهدف؛ وأي شيء آخر يُسلَّم كما هو. راجع exploit/README.md.
• وحدات مخصصة. ابنِ وحدات خارج الشجرة مقابل النواة قيد التشغيل وحمّلها عند الطلب باستخدام --insmod و--rmmod؛ وتُحمَّل رموزها تلقائيًا في GDB. راجع modules/README.md.
• استخبارات الانهيار. مصرف طرفية تسلسلي مطابق بايتًا ببايت، ومحلل panic/oops/KASAN/UBSAN، و نقطة توقف تلقائية تحبس GDB عند الخطأ مع تتبّع خلفي مرمّز. ويعيد --analyze-crash توليد تقرير دون اتصال.
• جلسات متزامنة. يحصل كل إقلاع على جلسة tmux خاصة به مسماة وفق ما تصححه، ومنافذ مضيف خاصة به، وطبقة rootfs خاصة به بالنسخ عند الكتابة، لذا يمكن تصحيح تحديين جنبًا إلى جنب ويهبط --run/--insmod دائمًا في الضيف الذي كتبت الأوامر من لوحته.
• مخرجات التشغيل. تكتب كل جلسة artifacts/runs/<id>/ بختم زمني يتضمن الإعدادات المحلولة، وملف تعريف المضيف، وسجلات الأوامر، والسجلات، ونصوص اللوحات.

المتطلبات

• Docker
• tmux
• Python 3.12 أو أحدث
• uv

شغّله كمستخدم غير جذري في مجموعة docker. تتم الترجمة المتقاطعة وأعمال initramfs داخل الحاويات (سلسلة أدوات musl من zig cc)، لذا لا حاجة لسلسلة أدوات متقاطعة على المضيف.

البدء السريع

# 1. Install dependencies
uv sync

# 2. Start the project tmux server (loads the shipped .tmux.conf)
tmux -L likedbg -f .tmux.conf new -s LIKE-DBG

# 3. Inside that tmux session: build-or-reuse a kernel, boot it, attach the debugger
uv run ./start_kgdb

أول تشغيل يبني صور الحاوية ونواة، لذا يستغرق بعض الوقت؛ أما التشغيلات اللاحقة فتعيد استخدام الذاكرة المؤقتة وتبدأ في ثوانٍ.

كل إقلاع يعيد تسمية جلسته وفقًا لما يقوم بتصحيحه (LIKE-DBG-pawnyable-lk01، LIKE-DBG-6_6_30-exploit-dev)، لذا فإن الجلسة التي تركتها قيد التشغيل لا تعيق التالية أبدًا ويمكن تصحيح تحدّيين جنبًا إلى جنب. افصل بـ C-b d؛ يُظهر tmux -L likedbg ls ما هو قيد التشغيل، و= أدناه هو صيغة المطابقة التامة في tmux (بدونها، قد تفوز جلسة -2):

tmux -L likedbg attach -t =LIKE-DBG-6_6_30-exploit-dev

من هنا، اقرأ docs/build-your-own-kernel.md للاطلاع على سير العمل الكامل، أو docs/ctf-foreign-kernel.md إذا كانت لديك تحدٍّ يحتاج إلى تصحيح. للحصول على جولة تطبيقية على الحلقة الكاملة مقابل برنامج تشغيل ضعيف مضمّن، اتبع جولة LK01.

الوثائق

المستند	يغطي
docs/walkthrough-lk01.md	ابدأ من هنا: مثال موجّه من البداية إلى النهاية مقابل برنامج تشغيل ضعيف مضمّن، من البناء إلى use-after-free إلى تقرير الانهيار.
docs/build-your-own-kernel.md	ابنِ نواة من المصدر، وأقلعها، ثم صحّحها وكرّر.
docs/ctf-foreign-kernel.md	تبنَّ نواة CTF أو نواة خارجية مقدَّمة وسلّم إليها الاستغلالات.
docs/configuration.md	حزمة إعدادات TOML، وملفات تعريف التصحيح، وكل خيار.
exploit/README.md	حلقة تطوير الاستغلال: حد الترجمة التلقائية ومخرج الطوارئ.
modules/README.md	وحدات مخصصة خارج الشجرة والتحميل التلقائي لرموز GDB.

يوفّر modules/lk01/ برنامج تشغيل تدريبي صغيرًا وضعيفًا عمدًا، بالإضافة إلى PoC للانهيار، مُهيَّأً لحلقة البناء والتحميل والاستغلال الكاملة كمثال عملي.

العرض التوضيحي

المساهمة

توجد شيفرة Python في src/likedbg/ والمقصود بها أن تكون قابلة للقراءة. يشغّل just test مجموعة الاختبارات، ويشغّل just lint كلاً من ruff وmypy، ويعيد just build-images بناء صور الحاويات بعد تغيير Dockerfile أو سكربت مضمّن. تقارير الأخطاء وطلبات الميزات وطلبات السحب مرحّب بها عبر متتبّع المشكلات وصفحة المناقشات.

الترخيص

MIT. راجع LICENSE.