Cosa ottieni

• Podman, Docker e LXC - preinstallati, pronti appena si avvia
• Una vera VM - Alpine Linux su un kernel personalizzato tramite QEMU, oppure AVF con accelerazione hardware sui dispositivi pKVM supportati
• Terminale integrato - xterm-256color completo, 122 temi di colore, 13 caratteri, ridimensionamento in tempo reale
• Desktop X11 - esegui app Linux con interfaccia grafica in un visualizzatore integrato con touch, tastiera, mouse e audio
• Passthrough USB, SSH, port forwarding e un bridge guest-to-Android
• Backup dei container, una vista dello stato della VM/dispositivo in tempo reale e condivisione della cartella Download con il guest
• Inglese e 中文, nessun root, qualsiasi dispositivo arm64 su Android 8+

Avvio rapido

1. Scarica l'APK e installalo.
2. Tocca Avvia VM, attendi Pronto!, apri il terminale.

# 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, i due backend, il networking, il visualizzatore X11 e la risoluzione dei problemi sono tutti documentati nella documentazione.

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)

Build per componente e dettagli della toolchain: CONTRIBUTING.md.

Contribuire

Contributi di ogni dimensione sono benvenuti: segnalazioni di bug, ritocchi alla configurazione del kernel, nuovi temi, rifiniture dell'interfaccia, correzioni all'input X11, qualsiasi cosa.

• Pull request: leggi prima CONTRIBUTING.md. Mantieni le modifiche circoscritte, esegui ./build-all.sh test prima di fare push e spiega perché nella descrizione della PR.
• Segnalazioni di bug: apri una issue indicando il tuo dispositivo e la versione di Android, una breve procedura di riproduzione e il log diagnostico (Impostazioni → Esporta log diagnostico nell'app).

Progetti correlati

RikkaHub Agent è un fork di RikkaHub, il client di chat LLM nativo per Android, che lo trasforma in un vero agente on-device: oltre 80 strumenti per il dispositivo, job pianificati, un browser guidato dall'IA, un workspace Linux, SSH, automazione dello schermo e un bot Telegram remoto, tutti attivabili su richiesta. Il suo strumento SSH può accedere a una VM Podroid in esecuzione (localhost:9922), così un agente sul tuo telefono può compilare, eseguire e ispezionare container senza che tu debba digitare un comando.

Crediti

QEMU	Emulazione della macchina
Termux	Motore dell'emulatore di terminale
Alpine Linux	La distribuzione guest

Elenco completo in CREDITS.md.

Licenza

GPLv2. Se Podroid ti è utile, una star aiuta altre persone a trovarlo.