Repository navigation
ar ARCHITECTURE
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
VD Dropbear هو وحدة KernelSU / APatch / Magisk تشغّل خادم Dropbear SSH واحداً بالضبط، مُدار بالكامل عبر الإعدادات. لا شيء في خادم SSH مُثبَّت مسبقاً لجهاز بعينه؛ فكل ما هو خاص إما إعداد وقت تشغيل أو سر.
-
module/common/vddropbear.sh، المكتبة الأساسية: تحميل الإعدادات (مع قيم افتراضية مدمجة آمنة)، وتحديد مخزن الأسرار، وضمان وجود مفتاح مضيف، وبناء متجه وسائط Dropbear، وإدارة نسخة واحدة من الخادم الخفي (تشغيل / إيقاف / حالة / إعادة تشغيل). -
module/service.sh: مدخل الإقلاع. يحترم سياسة بدء التشغيل BFU/AFU؛ وفي وضع AFU ينتظر فتح التخزين المشفَّر ببيانات الاعتماد دون تعطيل الإقلاع. -
module/action.sh، زر Action في المدير: (إعادة) تشغيل الخادم الخفي. لا يقرأ stdin أبداً ويفصل الخادم الخفي إلى جلسته الخاصة، فلا يتجمّد المدير. -
module/common/vddb-webui.sh+module/webroot/index.html: الواجهة الخلفية لـ WebUI وصفحتها. -
patches/: تصحيحات صغيرة قابلة للتدقيق تُطبَّق على Dropbear الأصلي وقت البناء. -
scripts/build.shوscripts/build-bundles.shو.github/workflows/build.yml: عملية البناء.
يحمّل vddb_start الإعدادات، ويوقف أي نسخة قيد التشغيل، ويضمن وجود مفتاح مضيف، ثم يطلق خادماً خفياً
واحداً. يُشحَن الملف الثنائي باسم vddropbear، فيطابق اسم عمليته pgrep -x تماماً (لا يملك mksh
في أندرويد الخيار exec -a). يُطلَق بـ setsid كي ينفصل عن مجموعة عمليات المُستدعي: وهذا ما يمنع
زر Action في المدير من التوقف.
الإعدادات ليست سرّية وتقيم على التخزين المشفَّر بالجهاز (/data/adb/vddropbear)، وهي قابلة للقراءة
عند الإقلاع. أما الأسرار (مفتاح المضيف وauthorized_keys وبصمات كلمات المرور) فتكون افتراضياً على
التخزين المشفَّر ببيانات الاعتماد (/data/misc_ce/0/vddropbear)، الذي لا يُفتَح إلا بعد مصادقة
المستخدم. تفعيل START_IN_BFU ينقل الأسرار إلى التخزين المشفَّر بالجهاز كي يستطيع الخادم الخفي العمل
قبل أول فتح، على حساب أن تصبح تلك الأسرار قابلة للقراءة في وقت أبكر. تحسب الوحدة أي مخزن تستخدم في كل
مرحلة من مراحل الإقلاع.
يبقى خادم SSH هو Dropbear الأصلي؛ وتغييراتنا ليست سوى بضعة تصحيحات قابلة للمراجعة (انظر patches/README.md):
- لافتة هوية محايدة قابلة للضبط وقت التشغيل؛
- قراءة
authorized_keysمن مسار يُحدَّد عبر البيئة (كي تقيم المفاتيح في مخزن الأسرار)؛ - مصادقة كلمة المرور مقابل ملف بصمات PBKDF2 بدلاً من
crypt()/shadow في النظام، وهو ما يفتقر إليه أندرويد (انظر BUILDING.md).
صفحة ثابتة ضمن WebUI الخاص بالمدير (KernelSU / APatch / WebUI-X). تقود
module/common/vddb-webui.sh عبر جسر ksu.exec: الحالة، والتشغيل/الإيقاف/إعادة التشغيل،
وقراءة/كتابة الإعدادات، وإدارة المفاتيح وحسابات كلمات المرور. تعبر كل البيانات الجسر مُرمَّزة بـ
base64، فلا تفسّرها الصدفة أبداً؛ وتُحسَب بصمات كلمات المرور في المتصفح باستخدام WebCrypto، فلا تغادر
كلمة المرور الصريحة الصفحة أبداً.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.