Repository navigation
ar AI AGENTS
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
نقطة اتصال SSH دائمة تحوّل هاتفك إلى شيء يستطيع عميل ذكاء اصطناعي مستقل تشغيله مباشرة. أي عميل قادر على التحكم في صدفة (shell) أو اتصال SSH (مثل Claude Code أو aider أو سكربت يعمل بنموذج لغوي ضمن الحلقة أو أتمتتك الخاصة) يحصل على جلسة جذر (root) حقيقية على الجهاز، عبر الشبكة، دون وصلة USB ودون أي من رايات تصحيح الأخطاء الفاضحة لنفسها في ADB.
تتوسّع هذه الصفحة في الفكرة التي عُرضت في ملف README.
يعلن ADB عن نفسه: القيمتان adb_enabled وdevelopment_settings_enabled قابلتان للقراءة من الجميع،
ويُسجَّل الاتصال، ولا توجد طريقة مدعومة لإخفاء أن تصحيح الأخطاء مُفعَّل (أو كان مُفعَّلاً). أي عميل
يعمل عبر ADB يترك هذا الأثر على الجهاز ليقرأه أي تطبيق أو حزمة SDK لمكافحة الاحتيال. أما VD Dropbear
فهو البديل الخاص: تسجيل دخول SSH عادي، ببيانات اعتماد تتحكم بها أنت ولافتة لا تكشف شيئاً.
عبر اتصال واحد، يرى العميل صدفة عادية شبيهة بلينكس ويستطيع:
- قراءة الملفات وتحريرها، وتبديل الإعدادات، وإدارة الوحدات والحزم والخدمات؛
- فرز السجلات، وسحب المخرجات، وتشغيل التشخيص أو التحليل الجنائي عند الطلب؛
- نقل الملفات ومزامنتها في الاتجاهين عبر
scp/sftp/rsync: النسخ الاحتياطي والترحيل والتهيئة؛ - إدارة أسطول كامل من الأجهزة المروَّتة من مكان واحد، كلٌّ منها يُوصَل بمفتاحه الخاص.
ولأن المشروع مبني ليكون ملائماً للذكاء الاصطناعي (ملف إعدادات موثَّق، وعقد بيئة تشغيل صريح، ومسارات متوقَّعة وحالة بنص صريح)، يستطيع العميل اكتشاف كيفية استخدامه دون تخمين.
هذا جذر (root)، فتعامل معه كجذر:
- امنح العميل بيانات اعتماد خاصة به، لا بيانات اعتمادك الشخصية، ووجِّهه إلى حساب أقل امتيازًا (
shell) إن أردت الحدّ من نطاق وصوله؛ - اقصُر الربط على الشبكات التي تثق بها: الاسترجاع المحلي (loopback) أو شبكة VPN بدلاً من الإنترنت المفتوح (انظر الإعدادات)؛
- أبقِ مصادقة كلمة المرور معطَّلة؛ فالمفتاح قابل للإبطال ولا يُكتَب أبداً؛
- يمكنك إبطال مفتاح أو إيقاف الخادم الخفي (daemon) في أي وقت من WebUI؛
- تذكَّر أن الاتصال الافتراضي هو جلسة جذر كاملة: امنح العميل فقط النطاق الذي يحتاجه.
- أنشئ زوج مفاتيح خاصاً بالعميل وحده.
- أضف مفتاحه العام في WebUI (Authorized keys).
- اربط على الاسترجاع المحلي أو شبكة VPN فقط، على منفذ غير افتراضي.
- وجِّه إعداد SSH الخاص بالعميل إلى الجهاز ودعه يعمل.
عبر USB، بدون ADB: فعّل مشاركة الاتصال عبر USB واربط بعنوان USB للحصول على وصلة عبر الكابل فقط، مفيدة لعميل على حاسوب محمول موصول بالكابل. راجع دليل المستخدم.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.