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

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.

Capacité	AndroSH	Alternatives typiques
Plusieurs distros à la fois	Oui	Généralement une seule distro
Gestion des environnements	SQLite + CLI	Gestion manuelle des fichiers
Intégration au système Android	Exécution ADB/Shizuku	Varie selon la solution
Plusieurs instances isolées	Oui	Instance unique
Root requis	Non (ADB/Shizuku)	Nécessite souvent le déverrouillage du bootloader

Captures d'écran

Commande	Aperçu	Ce qu'elle montre
androsh launch kali	Voir	Lancement de l'environnement Kali NetHunter
androsh list	Voir	Toutes les distributions disponibles
androsh lsd	Voir	Environnements que vous avez déjà installés

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