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

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

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

البدء السريع

[!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.

القدرة	AndroSH	البدائل النموذجية
توزيعات متعددة في وقت واحد	نعم	عادةً توزيعة واحدة فقط
إدارة البيئات	SQLite + CLI	تعامل يدوي مع الملفات
التكامل مع نظام Android	تنفيذ ADB/Shizuku	يختلف حسب الحل
نسخ معزولة متعددة	نعم	نسخة واحدة
يتطلب root	لا (ADB/Shizuku)	غالباً يتطلب فتح bootloader

لقطات الشاشة

الأمر	المعاينة	ما يعرضه
androsh launch kali	عرض	تشغيل بيئة Kali NetHunter
androsh list	عرض	جميع التوزيعات المتاحة
androsh lsd	عرض	البيئات التي قمت بتثبيتها بالفعل

البنية

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