Podroid

Führe Linux-Container und einen vollständigen Linux-Desktop auf deinem Android-Telefon aus. Ohne Root.

Eine echte Alpine-Linux-VM mit eigenem Kernel – kein Chroot- oder Proot-Trick – damit sich Podman, Docker und LXC genauso verhalten wie auf einem Server.

Webseite · Dokumentation · APK herunterladen

Was du bekommst

Podman, Docker und LXC – vorinstalliert, sofort einsatzbereit beim Start
Eine echte VM – Alpine Linux auf einem angepassten Kernel über QEMU oder hardwarebeschleunigtes AVF auf unterstützten pKVM-Geräten
In-App-Terminal – vollständiges xterm-256color, 122 Farbschemata, 13 Schriftarten, Live-Größenanpassung
X11-Desktop – führe GUI-Linux-Apps in einem integrierten Viewer aus, mit Touch, Tastatur, Maus und Audio
USB-Durchreichung, SSH, Portweiterleitung und eine Gast-zu-Android-Brücke
Container-Backup, eine Live-VM-/Gerätestatusansicht und Freigabe des Downloads-Ordners für den Gast
Englisch und 中文, kein Root, jedes arm64-Gerät mit Android 8+

Schnellstart

Lade die APK herunter und installiere sie.
Tippe auf Start VM, warte auf Ready! und öffne das 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

Setup, die beiden Backends, Netzwerk, der X11-Viewer und die Fehlerbehebung – alles findest du in der Dokumentation.

Erstellen

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

Builds der einzelnen Komponenten und Toolchain-Details: CONTRIBUTING.md.

Mitwirken

Beiträge jeder Größe sind willkommen: Fehlerberichte, Kernel-Config-Anpassungen, neue Designs, UI-Verbesserungen, X11-Eingabefixes, alles.

Pull-Requests: Lies zuerst CONTRIBUTING.md. Halte Änderungen begrenzt, führe vor dem Pushen ./build-all.sh test aus und erkläre im PR-Beschreibungstext warum.
Fehlerberichte: Öffne ein Issue mit deinem Gerät und der Android-Version, einer kurzen Reproduktion und dem Diagnoseprotokoll (Settings → Export Diagnostic Log in der App).