AndroSH - Exécuter 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 - sans 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'usage
• Sécurité et confidentialité
• Composants et sources
• Dépannage
• Contribuer
• Licence
• Auteur
• Support

Démarrage rapide

[!Important] Avant de commencer : installez et lancez d'abord Shizuku. Si vous débutez avec AndroSH, lisez la section complète 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-distro : 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 élevée d'Android, avec une intégration directe au système Android - sans root requis
• Basé sur SQLite : suivi rapide et fiable de vos environnements
• Isolé : chaque environnement Linux s'exécute via PRoot avec isolation du système de fichiers et des processus en 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é - sans 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 offre une exécution élevée 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 n'importe quelle distro, 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 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 si Shizuku est correctement configuré 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 verbosité (--verbose / --quiet) et le formatage des horodatages (--time-style).

Cas d'usage

Apprentissage de 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

Station de travail mobile

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é

• Frontière de privilèges Android : les opérations côté Android s'exécutent dans les limites des permissions disponibles pour 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é : les 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 · BusyBox NDK sources · AndroSH core

Toutes les dépendances sont traçables jusqu'à leurs sources amont et maintenues à jour avec les correctifs 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

• Confirmez 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

Contribuer

Les contributions de toutes sortes sont les bienvenues - code, documentation, rapports de bugs, idées de fonctionnalités, traductions, tests, ou simplement partage de retours. Que vous corrigiez une faute de frappe ou ajoutiez la prise en charge d'une nouvelle distro, chaque contribution aide.

Façons de vous impliquer :

• Code : corrigez des bugs, ajoutez des fonctionnalités, améliorez les performances
• Documentation : améliorez le README, rédigez des guides, ajoutez des exemples
• Tests : essayez AndroSH sur différents appareils/versions d'Android et rapportez ce que vous trouvez
• Rapports de bugs : ouvrez une issue avec des étapes de reproduction claires
• Demandes de fonctionnalités : suggérez des idées ou des workflows que vous aimeriez voir pris en charge
• Support communautaire : aidez à répondre aux questions dans les issues/discussions

Aucune contribution n'est trop petite - si vous ne savez pas par où commencer, ouvrez une issue et demandez.

Configurer 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

Contributeurs

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 - cela aide les autres à découvrir le projet
• Partagez-le avec des amis, des communautés, ou sur les réseaux sociaux si AndroSH vous a été utile
• Ouvrez une issue pour signaler des bugs
• Lancez une discussion pour suggérer des fonctionnalités ou poser des questions
• Partagez votre cas d'usage - dites-nous comment vous utilisez AndroSH, cela aide à orienter le développement futur
• Faites passer le mot en écrivant à ce sujet, en réalisant une vidéo, ou en le recommandant partout où les passionnés d'Android/Linux se retrouvent

Chaque soutien, petit ou grand, aide le projet à grandir.