Ce que vous obtenez

• Podman, Docker et LXC - préinstallés, prêts dès le démarrage
• Une véritable VM - Alpine Linux sur un noyau personnalisé via QEMU, ou AVF accéléré par le matériel sur les appareils pKVM compatibles
• Terminal intégré - xterm-256color complet, 122 thèmes de couleurs, 13 polices, redimensionnement en direct
• Bureau X11 - exécutez des applications Linux graphiques dans une visionneuse intégrée avec tactile, clavier, souris et audio
• Passthrough USB, SSH, redirection de ports et un pont invité-vers-Android
• Sauvegarde des conteneurs, une vue en direct de l'état de la VM et de l'appareil et le partage du dossier Téléchargements avec l'invité
• Anglais et 中文, sans root, tout appareil arm64 sous Android 8+

Démarrage rapide

1. Téléchargez l'APK et installez-le.
2. Appuyez sur Démarrer la VM, attendez Prêt !, ouvrez le terminal.

# rootless containers, straight away
podman run --rm alpine echo "hello from a container"
docker run -d -p 8080:80 nginx

# expose that container to your phone and LAN, right from the VM shell
podroid-forward add 8080 8080 tcp     # TCP or UDP, on both the QEMU and AVF backends
curl http://<phone-ip>:8080
podroid-forward clean                 # remove every rule you added, in one go

# SSH in from your laptop (enable SSH in the setup wizard or Settings)
ssh root@<phone-ip> -p 9922        # password: podroid

# read this documentation with no network connection
podroid-forward add 9980 9980 tcp     # forward the docs port to the phone
podroid-docs                          # serves docs/guide at http://127.0.0.1:9980

La configuration, les deux backends, le réseau, la visionneuse X11 et le dépannage sont tous documentés dans la documentation.

Compilation

git clone https://github.com/ExTV/Podroid.git
cd Podroid
./build-all.sh all     # kernel, rootfs, QEMU and APK (needs Docker + Android SDK/NDK)

Détails des builds par composant et de la chaîne d'outils : CONTRIBUTING.md.

Contribution

Les contributions de toutes tailles sont les bienvenues : rapports de bugs, ajustements de configuration du noyau, nouveaux thèmes, améliorations de l'interface, corrections de saisie X11, tout est bon.

• Pull requests : lisez d'abord CONTRIBUTING.md. Limitez la portée des modifications, exécutez ./build-all.sh test avant de pousser, et expliquez pourquoi dans la description de la PR.
• Rapports de bugs : ouvrez une issue en précisant votre appareil et votre version d'Android, une courte procédure de reproduction et le journal de diagnostic (Settings → Export Diagnostic Log dans l'application).

Projets liés

RikkaHub Agent est un fork de RikkaHub, le client de chat LLM natif pour Android, qui le transforme en un véritable agent embarqué : plus de 80 outils pour l'appareil, des tâches planifiées, un navigateur piloté par IA, un espace de travail Linux, SSH, l'automatisation de l'écran et un bot Telegram distant, tous sur opt-in. Son outil SSH peut se connecter à une VM Podroid en cours d'exécution (localhost:9922), afin qu'un agent sur votre téléphone puisse compiler, exécuter et inspecter des conteneurs sans que vous ayez à taper une commande.

Crédits

QEMU	Émulation de machine
Termux	Moteur d'émulateur de terminal
Alpine Linux	La distribution invitée

Liste complète dans CREDITS.md.

Licence

GPLv2. Si Podroid vous est utile, une star aide d'autres personnes à le découvrir.