AndroSH - Esegui distribuzioni Linux su Android (senza root, basato su ADB/Shizuku)

Indice

• Avvio rapido
• Funzionalità
• Distribuzioni supportate
• Panoramica
• Screenshot
• Architettura
• Installazione
• Aggiornamento
• Utilizzo
• Casi d'uso
• Sicurezza e privacy
• Componenti e sorgenti
• Risoluzione dei problemi
• Contribuire
• Licenza
• Autore
• Supporto

Avvio rapido

[!Important] Prima di iniziare: installa ed esegui prima Shizuku. Se sei nuovo a AndroSH, leggi la sezione completa Installazione qui sotto - copre la configurazione di Shizuku e la risoluzione dei problemi.

# 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

Funzionalità

• Multi-distro: esegui diverse distribuzioni Linux affiancate (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
• Linux basato su ADB/Shizuku: esegui distribuzioni Linux complete attraverso il livello Shell elevato di Android, con integrazione diretta del sistema Android - senza root
• Basato su SQLite: tracciamento veloce e affidabile dei tuoi ambienti
• Isolato: ogni ambiente Linux viene eseguito tramite PRoot con isolamento del filesystem/processi nello spazio utente
• Supporto GUI: funziona con Termux:X11 per un ambiente desktop completo - guida alla configurazione

Distribuzioni supportate

Ogni distribuzione sopra elencata proviene da una sorgente rootfs verificata e viene eseguita in un ambiente proot isolato - senza root.

Panoramica

AndroSH ti consente di distribuire e gestire più distribuzioni Linux complete su Android eseguendo PRoot attraverso il livello di esecuzione ADB/Shizuku. Questo fornisce un'esecuzione elevata lato Android senza root, mantenendo al contempo l'integrazione diretta con il sistema Android dall'interno degli ambienti Linux.

Capacità	AndroSH	Alternative tipiche
Più distro contemporaneamente	Sì	Di solito una sola distro
Gestione degli ambienti	SQLite + CLI	Gestione manuale dei file
Integrazione con il sistema Android	Esecuzione ADB/Shizuku	Varia a seconda della soluzione
Più istanze isolate	Sì	Istanza singola
Root richiesto	No (ADB/Shizuku)	Spesso richiede lo sblocco del bootloader

Screenshot

Comando	Anteprima	Cosa mostra
androsh launch kali	Visualizza	Avvio dell'ambiente Kali NetHunter
androsh list	Visualizza	Tutte le distribuzioni disponibili
androsh lsd	Visualizza	Gli ambienti che hai già installato

Architettura

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

Dall'interno di qualsiasi distro, puoi accedere direttamente al sistema 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

Installazione

Requisiti

• Dispositivo Android con Shizuku installato e in esecuzione
• Python 3.8+
• Termux o un emulatore di terminale compatibile
• Almeno 2 GB di spazio libero

Configurazione

# 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] quando esegui androsh setup, AndroSH verifica automaticamente se Shizuku è configurato correttamente e ti guida nella correzione in caso contrario.

Aggiornamento

cd AndroSH
git pull
pip install -r requirements.txt

Utilizzo

Distribuire un ambiente

androsh setup production --distro debian --type stable

Avviarlo

androsh launch production
# You're now root inside the Debian environment
root@localhost:~# apt update && apt install python3 git

Gestire gli ambienti

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

Gestire le distribuzioni direttamente