Skip to content

ar USER GUIDE

github-actions[bot] edited this page Nov 17, 2026 · 5 revisions

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 جهازك المروَّت خادم SSH خاصاً. يأخذك هذا الدليل من التثبيت إلى اتصال عامل، بما في ذلك نقل الملفات ووضع ما-قبل-أول-فتح (BFU).

تسجيل الدخول يكون افتراضيًا صدفة جذر (root) كاملة. فضّل المفاتيح على كلمات المرور، واربط فقط على الشبكات التي تثق بها، ولا تُعرّض المنفذ للإنترنت المفتوح دون سبب أبداً.

1. التثبيت

ثبّت ملف zip الخاص بالوحدة في مدير KernelSU أو APatch أو Magisk (أو من صدفة باستخدام ksud module install / apd module install)، ثم افتح WebUI الخاصة بالوحدة.

2. أضف مفتاحاً (مُستحسَن)

في WebUI، تحت Authorized keys، الصق مفتاحك العام (ssh-ed25519 AAAA... you@host) واضغط Add key. المفاتيح هي الافتراضي وأأمن طريقة للدخول.

لإنشاء مفتاح على حاسوبك، إن لم يكن لديك واحد:

ssh-keygen -t ed25519 -C "you@host"
cat ~/.ssh/id_ed25519.pub     # paste this into the WebUI

3. أو عيّن كلمة مرور

تسجيل الدخول بكلمة المرور معطَّل افتراضياً (تسجيل الدخول افتراضيًا جذر، لذا تُفضَّل المفاتيح). ولتفعيله، فعّل Password login في الإعدادات، ثم تحت Password accounts عيّن كلمة مرور لمستخدم تسجيل الدخول. تُحسَب البصمة في متصفحك باستخدام PBKDF2؛ ولا تغادر كلمة المرور نفسها الصفحة أبداً.

4. اختر منفذاً ومكان الاستماع

تحت Settings، عيّن Port واختر الروابط. افتراضياً يستمع VD Dropbear على الاسترجاع المحلي فقط؛ وللوصول إليه من شبكتك المحلية أو VPN، فعّل الواجهات التي تريدها. تجنّب Listen on all interfaces ما لم تفهم مدى التعرُّض.

اضغط Save & restart للتطبيق، ثم Start إن لم يكن يعمل بالفعل.

5. اتصل

ssh -p 2222 root@<device-ip>
sftp -P 2222 root@<device-ip>
scp -P 2222 file root@<device-ip>:/sdcard/
rsync -e 'ssh -p 2222' -av ./dir/ root@<device-ip>:/sdcard/dir/

sftp-server وscp وrsync مُضمَّنة، لذا تعمل SFTP وsshfs وعملاء الواجهة الرسومية والنسخ الاحتياطي جميعها عبر الاتصال نفسه.

الاتصال عبر USB (بدون wifi، بدون ADB)

لنقل أسرع وأكثر استقرارًا ودون أي شبكة في المسار، اتصل بالخادم عبر كابل USB باستخدام مشاركة الاتصال عبر USB، دون ADB أو تصحيح أخطاء USB:

  1. وصّل الكابل ثم فعّل في الهاتف مشاركة الاتصال عبر USB (الإعدادات -> الشبكة -> نقطة الاتصال والتوصيل).
  2. ينضم الهاتف إلى شبكة صغيرة عبر USB فقط، غالبًا على 192.168.42.129.
  3. في الخطوة 4 أعلاه، أضف هذا العنوان إلى الروابط المحددة (LISTEN_ADDRESSES) واترك كل الواجهات مُعطّلًا، كي يردّ الخادم عبر الكابل فقط.

ثم اتصل بعنوان USB بدلًا من اللاسلكي:

ssh -p 2222 root@192.168.42.129
scp -P 2222 file root@192.168.42.129:/sdcard/

إذا لم يكن 192.168.42.129 هو العنوان على جهازك، فتحقق من واجهة USB في الهاتف بالأمر ip addr.

6. قبل أول فتح (BFU)

افتراضياً لا يبدأ الخادم الخفي إلا بعد أن تفتح الجهاز مرة واحدة (AFU)، لأن أسراره تقيم على التخزين المشفَّر ببيانات الاعتماد. إذا احتجت إلى SSH قبل أول فتح (مثلاً لفتح جهاز عن بُعد بعد إعادة التشغيل)، فعّل Start before first unlock (BFU). حينها تنتقل الأسرار إلى التخزين المشفَّر بالجهاز، وهو قابل للقراءة قبل الفتح: مقايضة متعمَّدة وموثَّقة. انظر نموذج الأمان في README.

7. التحكم في الخادم الخفي

  • WebUI: التشغيل / الإيقاف / إعادة التشغيل، والحالة الحية (قيد التشغيل، PID، المنفذ، الوضع، بصمة مفتاح المضيف).
  • زر Action في المدير: يعيد تشغيل الخادم الخفي.
  • كما يبدأ تلقائياً عند الإقلاع (ما لم تعطّله).

استكشاف الأخطاء وإصلاحها

  • لا يبدأ. تحقق من /data/adb/vddropbear/state/daemon.log. تأكد أن Enabled مُفعَّل وأنه أمكن توليد مفتاح مضيف.
  • رُفِض المفتاح. تأكد أن سطر المفتاح العام مطابق تماماً لما يقدّمه عميلك، وأن اسم المستخدم الذي تسجّل الدخول به حساب يتعرّف عليه النظام (عادةً root).
  • تعذّر الاتصال من جهاز آخر. على الأرجح ما زلت مربوطاً على الاسترجاع المحلي فقط: فعّل الواجهة التي تحتاجها وأعد التشغيل.
  • تفشل SFTP/scp لكن الصدفة تعمل. تأكد أن sftp-server المُضمَّن قد شُحِن لمعمارية ABI الخاصة بك؛ تعرض حالة WebUI الـ ABI المكتشَفة.

تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.

Clone this wiki locally