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

Esegui e gestisci distribuzioni Linux complete sul tuo dispositivo Android - senza root.

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.

Screenshot

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

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

Riferimento completo dei comandi

Consulta AndroSH_Help.md per ogni comando e flag, inclusi il controllo della verbosità (--verbose / --quiet) e la formattazione dei timestamp (--time-style).

Casi d'uso

Imparare Linux

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

Ricerca sulla sicurezza / penetration testing

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

Ambienti di sviluppo leggeri

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

Workstation in movimento

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

Eseguire più ambienti contemporaneamente

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

Sicurezza e privacy

• Confine dei privilegi Android: le operazioni lato Android vengono eseguite entro i permessi disponibili al contesto di esecuzione ADB/Shizuku; non è richiesto il root di Android.
• Isolamento dei processi: ogni ambiente viene eseguito in sandbox tramite proot
• Controlli di integrità: checksum SHA-256 convalidano ogni download
• Nessuna telemetria: zero raccolta dati, tutto rimane locale sul tuo dispositivo
• Open source: ogni componente è verificabile

Componenti e sorgenti

Pipeline di build: PRoot builder · BusyBox NDK sources · AndroSH core

Tutte le dipendenze sono riconducibili alle loro sorgenti upstream e mantenute sincronizzate con gli aggiornamenti di sicurezza.

Risoluzione dei problemi

Reimpostare un ambiente corrotto

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

Pulire i file temporanei

androsh clean <distro>

Reinstallare il comando globale androsh

cd AndroSH
python main.py install

Problemi con Shizuku

• Conferma che Shizuku sia in esecuzione e che AndroSH sia autorizzato al suo interno
• Se i problemi persistono, riavvia il dispositivo per ripristinare il servizio Shizuku

Contribuire

Contributi di ogni tipo sono benvenuti - codice, documentazione, segnalazioni di bug, idee per funzionalità, traduzioni, test o semplicemente condivisione di feedback. Che tu stia correggendo un refuso o aggiungendo il supporto per una nuova distro, ogni contributo è utile.

Modi per partecipare:

• Codice: correggi bug, aggiungi funzionalità, migliora le prestazioni
• Documentazione: migliora il README, scrivi guide, aggiungi esempi
• Test: prova AndroSH su dispositivi/versioni di Android diverse e segnala ciò che trovi
• Segnalazioni di bug: apri una issue con passaggi chiari per riprodurre il problema
• Richieste di funzionalità: suggerisci idee o flussi di lavoro che vorresti vedere supportati
• Supporto alla community: aiuta a rispondere alle domande nelle issue/discussioni

Nessun contributo è troppo piccolo - se non sei sicuro da dove iniziare, apri una issue e chiedi.

Configura un ambiente di sviluppo:

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

Contributori

Licenza

GPLv3 - libero per uso commerciale e di ricerca.

Autore

Ahmed Al-Nassif

• GitHub: @ahmed-alnassif

Supporto

• Metti una stella al repo se lo trovi utile - aiuta gli altri a scoprire il progetto
• Condividilo con amici, community o sui social media se AndroSH ti è stato utile
• Apri una issue per segnalare bug
• Avvia una discussione per suggerire funzionalità o fare domande
• Condividi il tuo caso d'uso - raccontaci come usi AndroSH, aiuta a plasmare lo sviluppo futuro
• Spargi la voce scrivendone, realizzando un video o consigliandolo ovunque si ritrovino gli appassionati di Android/Linux

Ogni forma di supporto, grande o piccola, aiuta il progetto a crescere.