AndroSH – Linux-Distributionen auf Android ausführen (ohne Root, ADB/Shizuku-basiert)

Vollständige Linux-Distributionen auf Ihrem Android-Gerät ausführen und verwalten – ohne Root.

Inhaltsverzeichnis

• Schnellstart
• Funktionen
• Unterstützte Distributionen
• Überblick
• Screenshots
• Architektur
• Installation
• Aktualisierung
• Verwendung
• Anwendungsfälle
• Sicherheit & Datenschutz
• Komponenten & Quellen
• Fehlerbehebung
• Mitwirken
• Lizenz
• Autor
• Unterstützung

Schnellstart

[!Important] Bevor Sie beginnen: Installieren und starten Sie zuerst Shizuku. Wenn Sie neu bei AndroSH sind, lesen Sie den vollständigen Abschnitt Installation unten – er behandelt die Shizuku-Einrichtung und Fehlerbehebung.

# 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

Funktionen

• Multi-Distro: mehrere Linux-Distributionen parallel ausführen (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
• ADB/Shizuku-basiertes Linux: vollständige Linux-Distributionen über die erweiterte Shell-Ebene von Android ausführen, mit direkter Android-Systemintegration – ohne Root
• SQLite-gestützt: schnelle, zuverlässige Verwaltung Ihrer Umgebungen
• Isoliert: jede Linux-Umgebung läuft über PRoot mit Userspace-Dateisystem-/Prozessisolierung
• GUI-Unterstützung: funktioniert mit Termux:X11 für eine vollständige Desktop-Umgebung – Einrichtungsanleitung

Unterstützte Distributionen

Jede der oben genannten Distributionen stammt aus einer verifizierten Rootfs-Quelle und läuft in einer isolierten proot-Umgebung – ohne Root.

Überblick

AndroSH ermöglicht es Ihnen, mehrere vollständige Linux-Distributionen auf Android bereitzustellen und zu verwalten, indem PRoot über die ADB/Shizuku-Ausführungsebene ausgeführt wird. Dies bietet eine erhöhte Ausführung auf der Android-Seite ohne Root, während die direkte Android-Systemintegration aus den Linux-Umgebungen heraus erhalten bleibt.

Screenshots

Architektur

Android-Gerät → ADB/Shizuku-Ausführungskontext → Proot-Virtualisierung → Linux-Umgebung(en)

graph TD
    A[Android-Gerät] --> B[ADB / Shizuku]
    B --> C[Android-Shell-Ausführungskontext]
    C --> D[PRoot]

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

    E --> I[Android-Systemintegration]
    F --> I
    G --> I
    H --> I

    I --> K[Android-Befehlsausführung]
    I --> L[Android-Dateisystemzugriff]
    I --> M[Android-Netzwerkzugriff]

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

Von jeder Distribution aus können Sie direkt auf das Android-System zugreifen:

# Installierte Android-Pakete auflisten
pm list packages -f

# Kernel-Informationen
cat /proc/version

# Android-Systemeigenschaften
getprop | grep version

# Netzwerk-Routen
ip route show

Installation

Voraussetzungen

• Android-Gerät mit installiertem und laufendem Shizuku
• Python 3.8+
• Termux oder ein kompatibler Terminal-Emulator
• Mindestens 2 GB freier Speicherplatz

Einrichtung

# Voraussetzungen in Termux installieren
apt update && apt install -y python git

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

# Abhängigkeiten installieren
pip install -r requirements.txt

# Den Befehl `androsh` global verfügbar machen
python main.py install

[!Tip] Wenn Sie androsh setup ausführen, prüft AndroSH automatisch, ob Shizuku korrekt konfiguriert ist, und führt Sie durch die Behebung, falls dies nicht der Fall ist.

Aktualisierung

cd AndroSH
git pull
pip install -r requirements.txt

Verwendung

Eine Umgebung bereitstellen

androsh setup production --distro debian --type stable

Sie starten

androsh launch production
# Sie sind jetzt root innerhalb der Debian-Umgebung
root@localhost:~# apt update && apt install python3 git

Umgebungen verwalten

androsh list                       # Zeigt an, was zur Installation verfügbar ist
androsh lsd                        # Zeigt an, was bereits installiert ist
androsh clean production           # Speicherplatz freigeben / temporäre Dateien entfernen
androsh remove production --force  # Eine Umgebung löschen

Distributionen direkt verwalten

androsh distro list                                              # Verfügbare Distributionen auflisten
androsh distro info ubuntu                                       # Details zu einer Distribution anzeigen
androsh distro download alpine --type alpine-minirootfs --file alpine-edge.tar.gz

Vollständige Befehlsreferenz

Siehe AndroSH_Help.md für jeden Befehl und jedes Flag, einschließlich Ausführlichkeitssteuerung (--verbose / --quiet) und Zeitstempelformatierung (--time-style).

Anwendungsfälle

Linux lernen

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

Sicherheitsforschung / Penetrationstests

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

Leichte Entwicklungsumgebungen

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

Workstation für unterwegs

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

Mehrere Umgebungen gleichzeitig ausführen

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

Sicherheit & Datenschutz

• Android-Berechtigungsgrenze: Android-seitige Vorgänge laufen innerhalb der Berechtigungen, die dem ADB/Shizuku-Ausführungskontext zur Verfügung stehen; kein Android-Root erforderlich.
• Prozessisolierung: jede Umgebung läuft über proot in einer Sandbox
• Integritätsprüfungen: SHA-256-Prüfsummen validieren jeden Download
• Keine Telemetrie: null Datenerfassung, alles bleibt lokal auf Ihrem Gerät
• Open Source: jede Komponente ist prüfbar

Komponenten & Quellen

Build-Pipelines: PRoot-Builder · BusyBox-NDK-Quellen · AndroSH-Kern

Alle Abhängigkeiten sind auf ihre Upstream-Quellen zurückführbar und werden mit Sicherheitsupdates synchron gehalten.

Fehlerbehebung

Eine beschädigte Umgebung zurücksetzen

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

Temporäre Dateien bereinigen

androsh clean <distro>

Den globalen Befehl androsh neu installieren

cd AndroSH
python main.py install

Shizuku-Probleme

• Stellen Sie sicher, dass Shizuku läuft und AndroSH darin autorisiert ist
• Wenn die Probleme weiterhin bestehen, starten Sie das Gerät neu, um den Shizuku-Dienst wiederherzustellen

Mitwirken

Beiträge aller Art sind willkommen – Code, Dokumentation, Fehlerberichte, Feature-Ideen, Übersetzungen, Tests oder einfach Feedback teilen. Ob Sie einen Tippfehler korrigieren oder Unterstützung für eine neue Distribution hinzufügen, jeder Beitrag hilft.

Möglichkeiten, sich zu beteiligen:

• Code: Fehler beheben, Funktionen hinzufügen, Leistung verbessern
• Dokumentation: die README verbessern, Anleitungen schreiben, Beispiele hinzufügen
• Tests: AndroSH auf verschiedenen Geräten/Android-Versionen ausprobieren und berichten, was Sie finden
• Fehlerberichte: ein Issue mit klaren Schritten zur Reproduktion eröffnen
• Feature-Anfragen: Ideen oder Workflows vorschlagen, die Sie unterstützt sehen möchten
• Community-Support: helfen, Fragen in Issues/Diskussionen zu beantworten

Kein Beitrag ist zu klein – wenn Sie nicht sicher sind, wo Sie anfangen sollen, eröffnen Sie ein Issue und fragen Sie.

Eine Entwicklungsumgebung einrichten:

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

Mitwirkende

Lizenz

GPLv3 – kostenlos für kommerzielle und Forschungszwecke.

Autor

Ahmed Al-Nassif

• GitHub: @ahmed-alnassif

Unterstützung

• Sternen Sie das Repository, wenn Sie es nützlich finden – es hilft anderen, das Projekt zu entdecken
• Teilen Sie es mit Freunden, Communities oder in sozialen Medien, wenn AndroSH für Sie nützlich war
• Eröffnen Sie ein Issue, um Fehler zu melden
• Starten Sie eine Diskussion, um Funktionen vorzuschlagen oder Fragen zu stellen
• Teilen Sie Ihren Anwendungsfall – erzählen Sie uns, wie Sie AndroSH nutzen, das hilft, die zukünftige Entwicklung zu gestalten
• Verbreiten Sie die Nachricht, indem Sie darüber schreiben, ein Video erstellen oder es überall empfehlen, wo sich Android/Linux-Enthusiasten aufhalten

Jede Unterstützung, ob groß oder klein, hilft, das Projekt am Wachsen zu halten.