AndroSH - تشغيل توزيعات Linux على Android (بدون root، مدعوم بـ ADB/Shizuku)

شغّل وأدر توزيعات Linux كاملة على جهاز Android الخاص بك - دون الحاجة إلى root.

جدول المحتويات

• البدء السريع
• الميزات
• التوزيعات المدعومة
• نظرة عامة
• لقطات الشاشة
• البنية
• التثبيت
• التحديث
• الاستخدام
• حالات الاستخدام
• الأمان والخصوصية
• المكونات والمصادر
• استكشاف الأخطاء وإصلاحها
• المساهمة
• الترخيص
• المؤلف
• الدعم

البدء السريع

[!Important] قبل أن تبدأ: قم بتثبيت وتشغيل Shizuku أولاً. إذا كنت جديداً على AndroSH، اقرأ قسم التثبيت الكامل أدناه - فهو يغطي إعداد Shizuku واستكشاف الأخطاء وإصلاحها.

# In Termux
apt update && apt install -y python git
git clone --depth 1 https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
pip install -r requirements.txt
python main.py install

androsh setup demo --distro debian --type stable
androsh launch demo

الميزات

• توزيعات متعددة: شغّل عدة توزيعات Linux جنباً إلى جنب (Arch، Fedora، Alpine، Debian، Ubuntu، Kali، Void، Manjaro، Chimera، openSUSE)
• Linux مدعوم بـ ADB/Shizuku: شغّل توزيعات Linux كاملة عبر طبقة Shell المرتفعة الصلاحيات في Android، مع تكامل مباشر مع نظام Android - دون الحاجة إلى root
• مدعوم بـ SQLite: تتبع سريع وموثوق لبيئاتك
• معزول: كل بيئة Linux تعمل عبر PRoot مع عزل نظام الملفات/العمليات على مستوى مساحة المستخدم
• دعم واجهة المستخدم الرسومية: يعمل مع Termux:X11 لبيئة سطح مكتب كاملة - دليل الإعداد

التوزيعات المدعومة

كل توزيعة مما سبق تأتي من مصدر rootfs موثّق وتعمل في بيئة proot معزولة - دون الحاجة إلى root.

نظرة عامة

يتيح لك AndroSH نشر وإدارة عدة توزيعات Linux كاملة على Android عبر تشغيل PRoot من خلال طبقة تنفيذ ADB/Shizuku. يوفر ذلك تنفيذاً مرتفع الصلاحيات على جانب Android دون root مع الحفاظ على التكامل المباشر مع نظام Android من داخل بيئات Linux.

لقطات الشاشة

البنية

Android Device → ADB/Shizuku Execution Context→ Proot Virtualization → Linux Environment(s)

graph TD
    A[Android Device] --> B[ADB / Shizuku]
    B --> C[Android Shell Execution Context]
    C --> D[PRoot]

    D --> E[Alpine]
    D --> F[Debian]
    D --> G[Ubuntu]
    D --> H[Kali NetHunter]

    E --> I[Android System Integration]
    F --> I
    G --> I
    H --> I

    I --> K[Android Command Execution]
    I --> L[Android Filesystem Access]
    I --> M[Android Network Access]

    style D fill:#FF6B00,color:white
    style I fill:#4CAF50,color:white

من داخل أي توزيعة، يمكنك الوصول مباشرة إلى نظام Android:

# List installed Android packages
pm list packages -f

# Kernel info
cat /proc/version

# Android system properties
getprop | grep version

# Network routes
ip route show

التثبيت

المتطلبات

• جهاز Android مع تثبيت وتشغيل Shizuku
• Python 3.8+
• Termux أو محاكي طرفية متوافق
• مساحة تخزين فارغة لا تقل عن 2 GB

الإعداد

# Install prerequisites in Termux
apt update && apt install -y python git

# Get AndroSH
git clone --depth 1 https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH

# Install dependencies
pip install -r requirements.txt

# Make the `androsh` command available globally
python main.py install

[!Tip] عند تشغيل androsh setup، يتحقق AndroSH تلقائياً مما إذا كان Shizuku مُهيأً بشكل صحيح ويرشدك خلال إصلاحه إن لم يكن كذلك.

التحديث

cd AndroSH
git pull
pip install -r requirements.txt

الاستخدام

نشر بيئة

androsh setup production --distro debian --type stable

تشغيلها

androsh launch production
# You're now root inside the Debian environment
root@localhost:~# apt update && apt install python3 git

إدارة البيئات

androsh list                       # See what's available to install
androsh lsd                        # See what's already installed
androsh clean production           # Free up space / remove temp files
androsh remove production --force  # Delete an environment

إدارة التوزيعات مباشرة

androsh distro list                                              # List available distros
androsh distro info ubuntu                                       # Get details on a distro
androsh distro download alpine --type alpine-minirootfs --file alpine-edge.tar.gz

مرجع الأوامر الكامل

راجع AndroSH_Help.md لكل أمر وخيار، بما في ذلك التحكم في مستوى التفصيل (--verbose / --quiet) وتنسيق الطوابع الزمنية (--time-style).

حالات الاستخدام

تعلّم Linux

androsh setup classroom --distro ubuntu --type stable
apt install gcc python3-dev git curl wget

البحث الأمني / اختبار الاختراق

androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark

بيئات تطوير خفيفة الوزن

androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli

محطة عمل أثناء التنقل

androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools

تشغيل عدة بيئات في وقت واحد

androsh setup frontend --distro ubuntu -t stable
androsh setup backend --distro debian -t stable
androsh setup security --distro kali-nethunter -t nano
androsh lsd

الأمان والخصوصية

• حدود صلاحيات Android: تعمل العمليات على جانب Android ضمن الصلاحيات المتاحة لسياق تنفيذ ADB/Shizuku؛ لا حاجة إلى root على Android.
• عزل العمليات: كل بيئة تعمل في صندوق رمل عبر proot
• فحوصات السلامة: مجموع اختباري SHA-256 يتحقق من كل تنزيل
• لا تتبع: صفر جمع بيانات، كل شيء يبقى محلياً على جهازك
• مفتوح المصدر: كل مكوّن قابل للتدقيق

المكونات والمصادر

خطوط أنابيب البناء: PRoot builder · BusyBox NDK sources · AndroSH core

جميع التبعيات قابلة للتتبع إلى مصادرها الأصلية وتُبقى متزامنة مع التحديثات الأمنية.

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

إعادة تعيين بيئة معطوبة

androsh setup <distro> --distro debian -t stable --resetup

تنظيف الملفات المؤقتة

androsh clean <distro>

إعادة تثبيت أمر androsh العام

cd AndroSH
python main.py install

مشاكل Shizuku

• تأكد من أن Shizuku يعمل وأن AndroSH مصرّح له فيه
• إذا استمرت المشاكل، أعد تشغيل الجهاز لاستعادة خدمة Shizuku

المساهمة

نرحب بجميع أنواع المساهمات - الكود، التوثيق، تقارير الأخطاء، أفكار الميزات، الترجمات، الاختبار، أو مجرد مشاركة الملاحظات. سواء كنت تصلح خطأً مطبعياً أو تضيف دعماً لتوزيعة جديدة، كل مساهمة تساعد.

طرق للمشاركة:

• الكود: إصلاح الأخطاء، إضافة ميزات، تحسين الأداء
• التوثيق: تحسين README، كتابة أدلة، إضافة أمثلة
• الاختبار: جرّب AndroSH على أجهزة/إصدارات Android مختلفة وأبلغ عما تجده
• تقارير الأخطاء: افتح issue مع خطوات واضحة لإعادة الإنتاج
• طلبات الميزات: اقترح أفكاراً أو سير عمل تود دعمه
• دعم المجتمع: ساعد في الإجابة على الأسئلة في issues/discussions

لا توجد مساهمة صغيرة جداً - إذا لم تكن متأكداً من أين تبدأ، افتح issue واسأل.

إعداد بيئة تطوير:

git clone https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

المساهمون

الترخيص

GPLv3 - مجاني للاستخدام التجاري والبحثي.

المؤلف

Ahmed Al-Nassif

• GitHub: @ahmed-alnassif

الدعم

• ضع نجمة للمستودع إذا وجدته مفيداً - يساعد الآخرين على اكتشاف المشروع
• شاركه مع الأصدقاء أو المجتمعات أو على وسائل التواصل الاجتماعي إذا كان AndroSH مفيداً لك
• افتح issue للإبلاغ عن الأخطاء
• ابدأ discussion لاقتراح ميزات أو طرح أسئلة
• شارك حالة استخدامك - أخبرنا كيف تستخدم AndroSH، فهذا يساعد في تشكيل التطوير المستقبلي
• انشر الخبر بالكتابة عنه، أو صنع فيديو، أو التوصية به أينما يتواجد عشاق Android/Linux

كل دعم، كبيراً كان أو صغيراً، يساعد في نمو المشروع.