AndroSH - Exécutez des distributions Linux sur Android (sans root, propulsé par ADB/Shizuku)

Exécutez et gérez des distributions Linux complètes sur votre appareil Android - aucun root requis.

Table des matières

• Démarrage rapide
• Fonctionnalités
• Distributions prises en charge
• Aperçu
• Captures d'écran
• Architecture
• Installation
• Mise à jour
• Utilisation
• Cas d'utilisation
• Sécurité et confidentialité
• Composants et sources
• Dépannage
• Contribution
• Licence
• Auteur
• Support

Démarrage rapide

[!Important] Avant de commencer : installez et lancez d'abord Shizuku. Si vous débutez avec AndroSH, lisez toute la section Installation ci-dessous - elle couvre la configuration de Shizuku et le dépannage.

# 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

Fonctionnalités

• Multi-distribution : exécutez plusieurs distributions Linux côte à côte (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
• Linux propulsé par ADB/Shizuku : exécutez des distributions Linux complètes via la couche Shell à privilèges élevés d'Android, avec une intégration directe au système Android - aucun root requis
• Basé sur SQLite : suivi rapide et fiable de vos environnements
• Isolé : chaque environnement Linux s'exécute via PRoot avec une isolation du système de fichiers et des processus dans l'espace utilisateur
• Support GUI : fonctionne avec Termux:X11 pour un environnement de bureau complet - guide de configuration

Distributions prises en charge

Chaque distribution ci-dessus provient d'une source rootfs vérifiée et s'exécute dans un environnement proot isolé - aucun root requis.

Aperçu

AndroSH vous permet de déployer et de gérer plusieurs distributions Linux complètes sur Android en exécutant PRoot via la couche d'exécution ADB/Shizuku. Cela fournit une exécution avec des privilèges élevés côté Android sans root, tout en conservant une intégration directe au système Android depuis l'intérieur des environnements Linux.

Captures d'écran

Architecture

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

Depuis l'intérieur de n'importe quelle distribution, vous pouvez accéder directement au système 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

Installation

Prérequis

• Appareil Android avec Shizuku installé et en cours d'exécution
• Python 3.8+
• Termux ou un émulateur de terminal compatible
• Au moins 2 Go d'espace de stockage libre

Configuration

# 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] lorsque vous exécutez androsh setup, AndroSH vérifie automatiquement que Shizuku est configuré correctement et vous guide pour le corriger si ce n'est pas le cas.

Mise à jour

cd AndroSH
git pull
pip install -r requirements.txt

Utilisation

Déployer un environnement

androsh setup production --distro debian --type stable

Le lancer

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

Gérer les environnements

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

Gérer les distributions directement

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

Référence complète des commandes

Consultez AndroSH_Help.md pour chaque commande et option, y compris le contrôle de la verbosité (--verbose / --quiet) et le format des horodatages (--time-style).

Cas d'utilisation

Apprendre Linux

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

Recherche en sécurité / tests d'intrusion

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

Environnements de développement légers

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

Poste de travail nomade

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

Exécuter plusieurs environnements à la fois

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

Sécurité et confidentialité

• Limite des privilèges Android : les opérations côté Android s'exécutent dans la limite des permissions disponibles dans le contexte d'exécution ADB/Shizuku ; aucun root Android n'est requis.
• Isolation des processus : chaque environnement s'exécute en sandbox via proot
• Vérifications d'intégrité : des sommes de contrôle SHA-256 valident chaque téléchargement
• Aucune télémétrie : zéro collecte de données, tout reste local sur votre appareil
• Open source : chaque composant est auditable

Composants et sources

Pipelines de build : PRoot builder · Sources BusyBox NDK · Noyau d'AndroSH

Toutes les dépendances sont traçables jusqu'à leurs sources amont et maintenues synchronisées avec les mises à jour de sécurité.

Dépannage

Réinitialiser un environnement cassé

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

Nettoyer les fichiers temporaires

androsh clean <distro>

Réinstaller la commande globale androsh

cd AndroSH
python main.py install

Problèmes avec Shizuku

• Vérifiez que Shizuku est en cours d'exécution et qu'AndroSH y est autorisé
• Si les problèmes persistent, redémarrez l'appareil pour restaurer le service Shizuku

Contribution

Les contributions et la recherche en sécurité sont les bienvenues. Domaines prioritaires actuels :

• Optimisation des performances
• Outillage de déploiement
• Durcissement de la sécurité

Configurez un environnement de développement :

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

Licence

GPLv3 - libre pour un usage commercial et de recherche.

Auteur

Ahmed Al-Nassif

• GitHub: @ahmed-alnassif

Support

• Mettez une étoile au dépôt si vous le trouvez utile
• Ouvrez une issue pour signaler des bugs
• Suggérez des fonctionnalités ou partagez comment vous utilisez AndroSH