ahmed-alnassif/androshएंड्रॉइड पर Shizuku/ADB के माध्यम से No-Root Multi-Distro Linux - Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, OpenSUSE और Chimera चलाएँ जिसमें पूर्ण सिस्टम एकीकरण, proot आइसोलेशन और Termux:X11 GUI शामिल है।
# AndroSH - Android पर Linux वितरण चलाएँ (No Root, ADB/Shizuku Powered)
<div align="center">
**अपने Android डिवाइस पर पूर्ण Linux वितरण चलाएँ और प्रबंधित करें - 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)
- **ADB/Shizuku-संचालित Linux**: Android की elevated Shell परत के माध्यम से पूर्ण Linux वितरण चलाएँ, सीधे Android सिस्टम एकीकरण के साथ - root की आवश्यकता नहीं
- **SQLite-आधारित**: आपके वातावरण की तेज़, विश्वसनीय ट्रैकिंग
- **पृथक**: प्रत्येक Linux वातावरण PRoot के माध्यम से userspace फ़ाइलसिस्टम/प्रोसेस आइसोलेशन के साथ चलता है
- **GUI समर्थन**: पूर्ण डेस्कटॉप वातावरण के लिए Termux:X11 के साथ काम करता है - [सेटअप गाइड](https://github.com/ahmed-alnassif/AndroSH/discussions/6#discussioncomment-15720947)
## समर्थित वितरण
ऊपर दिया गया प्रत्येक वितरण सत्यापित rootfs स्रोत से आता है और एक पृथक proot वातावरण में चलता है - root की आवश्यकता नहीं।
## अवलोकन
AndroSH आपको ADB/Shizuku निष्पादन परत के माध्यम से PRoot चलाकर Android पर कई पूर्ण Linux वितरणों को तैनात और प्रबंधित करने देता है। यह root के बिना elevated Android-पक्षीय निष्पादन प्रदान करता है, जबकि Linux वातावरण के अंदर से सीधे Android सिस्टम एकीकरण बनाए रखता है।
| क्षमता | AndroSH | सामान्य विकल्प |
|---|---|---|
| एक साथ कई डिस्ट्रो | हाँ | आमतौर पर केवल एक डिस्ट्रो |
| वातावरण प्रबंधन | SQLite + CLI | मैन्युअल फ़ाइल हैंडलिंग |
| Android सिस्टम एकीकरण | ADB/Shizuku निष्पादन | समाधान के अनुसार भिन्न |
| कई पृथक इंस्टेंस | हाँ | एकल इंस्टेंस |
| Root आवश्यक | नहीं (ADB/Shizuku) | अक्सर bootloader unlock आवश्यक |
## स्क्रीनशॉट
| कमांड | पूर्वावलोकन | यह क्या दिखाता है |
|---|:---:|---|
| `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
```
## इंस्टॉलेशन
### आवश्यकताएँ
- [Shizuku](https://github.com/RikkaApps/Shizuku/releases/latest) इंस्टॉल और चालू के साथ Android डिवाइस
- 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) देखें, जिसमें verbosity नियंत्रण (`--verbose` / `--quiet`) और timestamp फ़ॉर्मेटिंग (`--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
```
**हल्के dev वातावरण**
```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 निष्पादन संदर्भ के लिए उपलब्ध अनुमतियों के भीतर चलते हैं; Android root की आवश्यकता नहीं।
- **प्रोसेस आइसोलेशन**: प्रत्येक वातावरण 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) | Android के लिए मुख्य Unix उपयोगिताएँ (tar, grep, awk, आदि) |
बिल्ड पाइपलाइन: [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)
सभी निर्भरताएँ अपने upstream स्रोतों तक ट्रेस करने योग्य हैं और सुरक्षा अपडेट के साथ सिंक में रखी जाती हैं।
## समस्या निवारण
**टूटे हुए वातावरण को रीसेट करें**
```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 सुधारें, गाइड लिखें, उदाहरण जोड़ें
- **परीक्षण**: विभिन्न डिवाइस/Android संस्करणों पर AndroSH आज़माएँ और जो पाएँ उसकी रिपोर्ट करें
- **बग रिपोर्ट**: पुनरुत्पादन के स्पष्ट चरणों के साथ एक issue खोलें
- **फ़ीचर अनुरोध**: ऐसे विचार या वर्कफ़्लो सुझाएँ जिन्हें आप समर्थित देखना चाहेंगे
- **समुदाय समर्थन**: issues/discussions में प्रश्नों के उत्तर देने में मदद करें
कोई भी योगदान बहुत छोटा नहीं है - यदि आप निश्चित नहीं हैं कि कहाँ से शुरू करें, तो एक issue खोलें और पूछें।
एक dev वातावरण सेट करें:
```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 वातावरण - Android root की आवश्यकता के बिना।*
</div>