ahmed-alnassif/androshAndroSH No-Root Multi-Distro Linux sur Android via Shizuku/ADB - Exécutez Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, OpenSUSE & Chimera avec une intégration système complète, isolation proot et interface graphique Termux:X11.
# AndroSH - Exécuter des distributions Linux sur Android (sans root, propulsé par ADB/Shizuku)
<div align="center">
**Exécutez et gérez des distributions Linux complètes sur votre appareil Android - sans root requis.**
<img src="https://raw.githubusercontent.com/ahmed-alnassif/androsh/main/Assets/docs/AndroSH.png" alt="AndroSH" width="98%" />
[](https://github.com/ahmed-alnassif/AndroSH/actions/workflows/tests.yml)
[](https://github.com/ahmed-alnassif/AndroSH/stargazers)
[](https://github.com/ahmed-alnassif/AndroSH/releases)
[](https://python.org)
[](/LICENSE)
[](https://www.android.com)
<img src="https://assets.kitploit.com/production/public/readmes/9438/a4edb8815ebca0fde7738d96503897a680bcd0aaf4c21f1b329f30c3a56b6ec3.png" alt="AndroSH Mobile Showcase" width="90%" />
</div>
## Table des matières
- [Démarrage rapide](#démarrage-rapide)
- [Fonctionnalités](#fonctionnalités)
- [Distributions prises en charge](#distributions-prises-en-charge)
- [Aperçu](#aperçu)
- [Captures d'écran](#captures-décran)
- [Architecture](#architecture)
- [Installation](#installation)
- [Mise à jour](#mise-à-jour)
- [Utilisation](#utilisation)
- [Cas d'usage](#cas-dusage)
- [Sécurité et confidentialité](#sécurité--confidentialité)
- [Composants et sources](#composants--sources)
- [Dépannage](#dépannage)
- [Contribuer](#contribuer)
- [Licence](#licence)
- [Auteur](#auteur)
- [Support](#support)
## Démarrage rapide
> [!Important]
> **Avant de commencer :** installez et lancez d'abord [Shizuku](https://github.com/RikkaApps/Shizuku/releases/latest). Si vous débutez avec AndroSH, lisez la section complète [Installation](#installation) ci-dessous - elle couvre la configuration de Shizuku et le dépannage.
```bash
# 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](https://github.com/ahmed-alnassif/AndroSH/discussions/6#discussioncomment-15720947)
## 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](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/launch-kali.png) | Lancement de l'environnement Kali NetHunter |
| `androsh list` | [Voir](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/list-available.png) | Toutes les distributions disponibles |
| `androsh lsd` | [Voir](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/list-installed.png) | Environnements que vous avez déjà installés |
## Architecture
```
Android Device → ADB/Shizuku Execution Context→ Proot Virtualization → Linux Environment(s)
```
```mermaid
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 :
```bash
# 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](https://github.com/RikkaApps/Shizuku/releases/latest) installé et en cours d'exécution
- Python 3.8+
- [Termux](https://github.com/termux/termux-app/releases/latest) ou un émulateur de terminal compatible
- Au moins 2 Go d'espace libre
### Configuration
```bash
# 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
```bash
cd AndroSH
git pull
pip install -r requirements.txt
```
## Utilisation
### Déployer un environnement
```bash
androsh setup production --distro debian --type stable
```
### Le lancer
```bash
androsh launch production
# You're now root inside the Debian environment
root@localhost:~# apt update && apt install python3 git
```
### Gérer les environnements
```bash
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
```bash
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](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/docs/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**
```bash
androsh setup classroom --distro ubuntu --type stable
apt install gcc python3-dev git curl wget
```
**Recherche en sécurité / tests d'intrusion**
```bash
androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark
```
**Environnements de développement légers**
```bash
androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli
```
**Station de travail mobile**
```bash
androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools
```
**Exécuter plusieurs environnements à la fois**
```bash
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
| Composant | Source | Objectif |
|---|---|---|
| PRoot | [ahmed-alnassif/proot](https://github.com/ahmed-alnassif/proot) | Builds automatisés liés statiquement et optimisés pour Android |
| BusyBox NDK | [Magisk-Modules-Repo/busybox-ndk](https://github.com/Magisk-Modules-Repo/busybox-ndk) | Utilitaires Unix de base (tar, grep, awk, etc.) pour Android |
Pipelines de build : [PRoot builder](https://github.com/ahmed-alnassif/proot) · [BusyBox NDK sources](https://github.com/ahmed-alnassif/busybox) · [AndroSH core](https://github.com/ahmed-alnassif/AndroSH)
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é**
```bash
androsh setup <distro> --distro debian -t stable --resetup
```
**Nettoyer les fichiers temporaires**
```bash
androsh clean <distro>
```
**Réinstaller la commande globale `androsh`**
```bash
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 :
```bash
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
[](https://github.com/ahmed-alnassif/AndroSH/graphs/contributors)
## Licence
GPLv3 - libre pour un usage commercial et de recherche.
## Auteur
**Ahmed Al-Nassif**
- GitHub : [@ahmed-alnassif](https://github.com/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.
---
<div align="center">
*Des environnements Linux professionnels dans votre poche - sans nécessiter de root Android.*
</div>