AndroSH - Android पर Linux वितरण चलाएँ (No Root, ADB/Shizuku Powered)

अपने Android डिवाइस पर पूर्ण Linux वितरण चलाएँ और प्रबंधित करें - 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)
• ADB/Shizuku-संचालित Linux: Android की elevated Shell परत के माध्यम से पूर्ण Linux वितरण चलाएँ, सीधे Android सिस्टम एकीकरण के साथ - root की आवश्यकता नहीं
• SQLite-आधारित: आपके वातावरण की तेज़, विश्वसनीय ट्रैकिंग
• पृथक: प्रत्येक Linux वातावरण PRoot के माध्यम से userspace फ़ाइलसिस्टम/प्रोसेस आइसोलेशन के साथ चलता है
• GUI समर्थन: पूर्ण डेस्कटॉप वातावरण के लिए Termux:X11 के साथ काम करता है - सेटअप गाइड

समर्थित वितरण

ऊपर दिया गया प्रत्येक वितरण सत्यापित rootfs स्रोत से आता है और एक पृथक proot वातावरण में चलता है - root की आवश्यकता नहीं।

अवलोकन

AndroSH आपको ADB/Shizuku निष्पादन परत के माध्यम से PRoot चलाकर Android पर कई पूर्ण Linux वितरणों को तैनात और प्रबंधित करने देता है। यह root के बिना elevated Android-पक्षीय निष्पादन प्रदान करता है, जबकि Linux वातावरण के अंदर से सीधे Android सिस्टम एकीकरण बनाए रखता है।

स्क्रीनशॉट

आर्किटेक्चर

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

इंस्टॉलेशन

आवश्यकताएँ

• Shizuku इंस्टॉल और चालू के साथ Android डिवाइस
• 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 देखें, जिसमें verbosity नियंत्रण (--verbose / --quiet) और timestamp फ़ॉर्मेटिंग (--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

हल्के dev वातावरण

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 निष्पादन संदर्भ के लिए उपलब्ध अनुमतियों के भीतर चलते हैं; Android root की आवश्यकता नहीं।
• प्रोसेस आइसोलेशन: प्रत्येक वातावरण proot के माध्यम से सैंडबॉक्स्ड चलता है
• अखंडता जाँच: SHA-256 चेकसम प्रत्येक डाउनलोड को सत्यापित करते हैं
• कोई टेलीमेट्री नहीं: शून्य डेटा संग्रह, सब कुछ आपके डिवाइस पर स्थानीय रहता है
• ओपन सोर्स: प्रत्येक घटक ऑडिट करने योग्य है

घटक और स्रोत

बिल्ड पाइपलाइन: PRoot builder · BusyBox NDK sources · AndroSH core

सभी निर्भरताएँ अपने upstream स्रोतों तक ट्रेस करने योग्य हैं और सुरक्षा अपडेट के साथ सिंक में रखी जाती हैं।

समस्या निवारण

टूटे हुए वातावरण को रीसेट करें

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

अस्थायी फ़ाइलें साफ़ करें

androsh clean <distro>

वैश्विक androsh कमांड को पुनः इंस्टॉल करें

cd AndroSH
python main.py install

Shizuku समस्याएँ

• पुष्टि करें कि Shizuku चल रहा है और AndroSH उसमें अधिकृत है
• यदि समस्याएँ बनी रहती हैं, तो Shizuku सेवा को पुनः स्थापित करने के लिए डिवाइस को रीबूट करें

योगदान

सभी प्रकार के योगदान स्वागत हैं - कोड, दस्तावेज़ीकरण, बग रिपोर्ट, फ़ीचर विचार, अनुवाद, परीक्षण, या बस प्रतिक्रिया साझा करना। चाहे आप टाइपो ठीक कर रहे हों या नए डिस्ट्रो के लिए समर्थन जोड़ रहे हों, हर योगदान मदद करता है।

शामिल होने के तरीके:

• कोड: बग ठीक करें, फ़ीचर जोड़ें, प्रदर्शन सुधारें
• दस्तावेज़ीकरण: README सुधारें, गाइड लिखें, उदाहरण जोड़ें
• परीक्षण: विभिन्न डिवाइस/Android संस्करणों पर AndroSH आज़माएँ और जो पाएँ उसकी रिपोर्ट करें
• बग रिपोर्ट: पुनरुत्पादन के स्पष्ट चरणों के साथ एक issue खोलें
• फ़ीचर अनुरोध: ऐसे विचार या वर्कफ़्लो सुझाएँ जिन्हें आप समर्थित देखना चाहेंगे
• समुदाय समर्थन: issues/discussions में प्रश्नों के उत्तर देने में मदद करें

कोई भी योगदान बहुत छोटा नहीं है - यदि आप निश्चित नहीं हैं कि कहाँ से शुरू करें, तो एक issue खोलें और पूछें।

एक dev वातावरण सेट करें:

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 उत्साही मिलते हैं वहाँ इसकी सिफ़ारिश करके

हर सहायता, बड़ी या छोटी, प्रोजेक्ट को बढ़ते रहने में मदद करती है।