Das bekommst du

• Podman, Docker und LXC – vorinstalliert und sofort nach dem Booten einsatzbereit
• Eine echte VM – Alpine Linux auf einem benutzerdefinierten Kernel via QEMU oder hardwarebeschleunigtes AVF auf unterstützten pKVM-Geräten
• Integriertes Terminal – vollständiges xterm-256color, 122 Farbdesigns, 13 Schriftarten, Live-Größenanpassung
• X11-Desktop – GUI-Linux-Apps in einem integrierten Viewer mit Touch, Tastatur, Maus und Audio ausführen
• USB-Passthrough, SSH, Port-Weiterleitung und eine Gast-zu-Android-Brücke
• Container-Backup, eine Live-Ansicht des VM-/Gerätestatus und Freigabe des Downloads-Ordners mit dem Gast
• Englisch und 中文, kein Root, jedes arm64-Gerät ab Android 8+

Schnellstart

1. Lade die APK herunter und installiere sie.
2. Tippe auf VM starten, warte auf Bereit! 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

# 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

Setup, die beiden Backends, Netzwerk, der X11-Viewer und die Fehlerbehebung sind alle in der Dokumentation beschrieben.

Build

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 pro Komponente und Details zur Toolchain: CONTRIBUTING.md.

Mitwirken

Beiträge jeder Größe sind willkommen: Fehlerberichte, Anpassungen der Kernel-Konfiguration, neue Themes, UI-Feinschliff, X11-Eingabekorrekturen, alles.

• Pull Requests: Lies zuerst CONTRIBUTING.md. Halte Änderungen fokussiert, führe ./build-all.sh test vor dem Push aus und erkläre im PR-Beschreibungstext, warum die Änderung nötig ist.
• Fehlerberichte: Eröffne ein Issue mit deinem Gerät und deiner Android-Version, einer kurzen Reproduktion und dem Diagnoseprotokoll (Einstellungen → Diagnoseprotokoll exportieren in der App).

Verwandte Projekte

RikkaHub Agent ist ein Fork von RikkaHub, dem nativen Android-LLM-Chat-Client, der ihn in einen echten On-Device-Agenten verwandelt: über 80 Gerätewerkzeuge, geplante Jobs, einen KI-gesteuerten Browser, einen Linux-Arbeitsbereich, SSH, Bildschirmautomatisierung und einen Remote-Telegram-Bot, alles optional. Sein SSH-Werkzeug kann sich in eine laufende Podroid-VM (localhost:9922) einloggen, sodass ein Agent auf deinem Telefon Container bauen, ausführen und inspizieren kann, ohne dass du einen Befehl eintippen musst.

Danksagungen

QEMU	Maschinenemulation
Termux	Terminal-Emulator-Engine
Alpine Linux	Die Gastdistribution

Vollständige Liste in CREDITS.md.

Lizenz

GPLv2. Wenn Podroid für dich nützlich ist, hilft ein Star anderen dabei, es zu finden.