ahmed-alnassif/androshAndroSH No-Root Multi-Distro Linux على أندرويد عبر Shizuku/ADB - تشغيل Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, OpenSUSE و Chimera مع تكامل كامل للنظام، عزل proot وواجهة Termux:X11 GUI.
# AndroSH - تشغيل توزيعات Linux على Android (بدون root، مدعوم بـ ADB/Shizuku)
<div align="center">
**شغّل وأدر توزيعات Linux كاملة على جهاز Android الخاص بك - دون الحاجة إلى root.**
<img src="https://raw.githubusercontent.com/ahmed-alnassif/androsh/main/Assets/docs/AndroSH.png" alt="AndroSH" width="98%" />
[](https://github.com/ahmed-alnassif/AndroSH/actions/workflows/tests.yml)
[](https://github.com/ahmed-alnassif/AndroSH/stargazers)
[](https://github.com/ahmed-alnassif/AndroSH/releases)
[](https://python.org)
[](/LICENSE)
[](https://www.android.com)
<img src="https://assets.kitploit.com/production/public/readmes/9438/a4edb8815ebca0fde7738d96503897a680bcd0aaf4c21f1b329f30c3a56b6ec3.png" alt="AndroSH Mobile Showcase" width="90%" />
</div>
## جدول المحتويات
- [البدء السريع](#quick-start)
- [الميزات](#features)
- [التوزيعات المدعومة](#supported-distributions)
- [نظرة عامة](#overview)
- [لقطات الشاشة](#screenshots)
- [البنية](#architecture)
- [التثبيت](#installation)
- [التحديث](#updating)
- [الاستخدام](#usage)
- [حالات الاستخدام](#use-cases)
- [الأمان والخصوصية](#security--privacy)
- [المكونات والمصادر](#components--sources)
- [استكشاف الأخطاء وإصلاحها](#troubleshooting)
- [المساهمة](#contributing)
- [الترخيص](#license)
- [المؤلف](#author)
- [الدعم](#support)
## البدء السريع
> [!Important]
> **قبل أن تبدأ:** قم بتثبيت وتشغيل [Shizuku](https://github.com/RikkaApps/Shizuku/releases/latest) أولاً. إذا كنت جديداً على AndroSH، اقرأ قسم [التثبيت](#installation) الكامل أدناه - فهو يغطي إعداد Shizuku واستكشاف الأخطاء وإصلاحها.
```bash
# 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 لبيئة سطح مكتب كاملة - [دليل الإعداد](https://github.com/ahmed-alnassif/AndroSH/discussions/6#discussioncomment-15720947)
## التوزيعات المدعومة
كل توزيعة مما سبق تأتي من مصدر 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` | [عرض](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/launch-kali.png) | تشغيل بيئة Kali NetHunter |
| `androsh list` | [عرض](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/list-available.png) | جميع التوزيعات المتاحة |
| `androsh lsd` | [عرض](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/list-installed.png) | البيئات التي قمت بتثبيتها بالفعل |
## البنية
```
Android Device → ADB/Shizuku Execution Context→ Proot Virtualization → Linux Environment(s)
```
```mermaid
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:
```bash
# 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](https://github.com/RikkaApps/Shizuku/releases/latest)
- Python 3.8+
- [Termux](https://github.com/termux/termux-app/releases/latest) أو محاكي طرفية متوافق
- مساحة تخزين فارغة لا تقل عن 2 GB
### الإعداد
```bash
# 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 مُهيأً بشكل صحيح ويرشدك خلال إصلاحه إن لم يكن كذلك.
## التحديث
```bash
cd AndroSH
git pull
pip install -r requirements.txt
```
## الاستخدام
### نشر بيئة
```bash
androsh setup production --distro debian --type stable
```
### تشغيلها
```bash
androsh launch production
# You're now root inside the Debian environment
root@localhost:~# apt update && apt install python3 git
```
### إدارة البيئات
```bash
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
```
### إدارة التوزيعات مباشرة
```bash
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](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/docs/AndroSH_Help.md) لكل أمر وخيار، بما في ذلك التحكم في مستوى التفصيل (`--verbose` / `--quiet`) وتنسيق الطوابع الزمنية (`--time-style`).
## حالات الاستخدام
**تعلّم Linux**
```bash
androsh setup classroom --distro ubuntu --type stable
apt install gcc python3-dev git curl wget
```
**البحث الأمني / اختبار الاختراق**
```bash
androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark
```
**بيئات تطوير خفيفة الوزن**
```bash
androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli
```
**محطة عمل أثناء التنقل**
```bash
androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools
```
**تشغيل عدة بيئات في وقت واحد**
```bash
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 | [ahmed-alnassif/proot](https://github.com/ahmed-alnassif/proot) | بناء آلي مرتبط بشكل ثابت ومحسّن لـ Android |
| BusyBox NDK | [Magisk-Modules-Repo/busybox-ndk](https://github.com/Magisk-Modules-Repo/busybox-ndk) | أدوات Unix الأساسية (tar، grep، awk، إلخ) لـ Android |
خطوط أنابيب البناء: [PRoot builder](https://github.com/ahmed-alnassif/proot) · [BusyBox NDK sources](https://github.com/ahmed-alnassif/busybox) · [AndroSH core](https://github.com/ahmed-alnassif/AndroSH)
جميع التبعيات قابلة للتتبع إلى مصادرها الأصلية وتُبقى متزامنة مع التحديثات الأمنية.
## استكشاف الأخطاء وإصلاحها
**إعادة تعيين بيئة معطوبة**
```bash
androsh setup <distro> --distro debian -t stable --resetup
```
**تنظيف الملفات المؤقتة**
```bash
androsh clean <distro>
```
**إعادة تثبيت أمر `androsh` العام**
```bash
cd AndroSH
python main.py install
```
**مشاكل Shizuku**
- تأكد من أن Shizuku يعمل وأن AndroSH مصرّح له فيه
- إذا استمرت المشاكل، أعد تشغيل الجهاز لاستعادة خدمة Shizuku
## المساهمة
نرحب بجميع أنواع المساهمات - الكود، التوثيق، تقارير الأخطاء، أفكار الميزات، الترجمات، الاختبار، أو مجرد مشاركة الملاحظات. سواء كنت تصلح خطأً مطبعياً أو تضيف دعماً لتوزيعة جديدة، كل مساهمة تساعد.
طرق للمشاركة:
- **الكود**: إصلاح الأخطاء، إضافة ميزات، تحسين الأداء
- **التوثيق**: تحسين README، كتابة أدلة، إضافة أمثلة
- **الاختبار**: جرّب AndroSH على أجهزة/إصدارات Android مختلفة وأبلغ عما تجده
- **تقارير الأخطاء**: افتح issue مع خطوات واضحة لإعادة الإنتاج
- **طلبات الميزات**: اقترح أفكاراً أو سير عمل تود دعمه
- **دعم المجتمع**: ساعد في الإجابة على الأسئلة في issues/discussions
لا توجد مساهمة صغيرة جداً - إذا لم تكن متأكداً من أين تبدأ، افتح issue واسأل.
إعداد بيئة تطوير:
```bash
git clone https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
## المساهمون
[](https://github.com/ahmed-alnassif/AndroSH/graphs/contributors)
## الترخيص
GPLv3 - مجاني للاستخدام التجاري والبحثي.
## المؤلف
**Ahmed Al-Nassif**
- GitHub: [@ahmed-alnassif](https://github.com/ahmed-alnassif)
## الدعم
- **ضع نجمة للمستودع** إذا وجدته مفيداً - يساعد الآخرين على اكتشاف المشروع
- **شاركه** مع الأصدقاء أو المجتمعات أو على وسائل التواصل الاجتماعي إذا كان AndroSH مفيداً لك
- **افتح issue** للإبلاغ عن الأخطاء
- **ابدأ discussion** لاقتراح ميزات أو طرح أسئلة
- **شارك حالة استخدامك** - أخبرنا كيف تستخدم AndroSH، فهذا يساعد في تشكيل التطوير المستقبلي
- **انشر الخبر** بالكتابة عنه، أو صنع فيديو، أو التوصية به أينما يتواجد عشاق Android/Linux
كل دعم، كبيراً كان أو صغيراً، يساعد في نمو المشروع.
---
<div align="center">
*بيئات Linux احترافية في جيبك - دون الحاجة إلى root على Android.*
</div>