O que você recebe

• Podman, Docker e LXC - pré-instalados, prontos no momento em que inicia
• Uma VM real - Alpine Linux em um kernel personalizado via QEMU, ou AVF acelerado por hardware em dispositivos pKVM compatíveis
• Terminal no aplicativo - xterm-256color completo, 122 temas de cores, 13 fontes, redimensionamento ao vivo
• Desktop X11 - execute aplicativos Linux com GUI em um visualizador integrado com toque, teclado, mouse e áudio
• Passthrough USB, SSH, encaminhamento de portas e uma ponte convidado-para-Android
• Backup de contêiner, uma visualização de status ao vivo da VM/dispositivo e compartilhamento da pasta Downloads com o convidado
• Inglês e 中文, sem root, qualquer dispositivo arm64 no Android 8+

Início rápido

1. Baixe o APK e instale-o.
2. Toque em Iniciar VM, aguarde Pronto! e abra o 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

A configuração, os dois backends, a rede, o visualizador X11 e a resolução de problemas estão todos na documentação.

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)

Detalhes de compilação por componente e da toolchain: CONTRIBUTING.md.

Contribuindo

Contribuições de todos os tamanhos são bem-vindas: relatos de bugs, ajustes na configuração do kernel, novos temas, refinamento da interface, correções de entrada do X11, qualquer coisa.

• Pull requests: leia o CONTRIBUTING.md primeiro. Mantenha as alterações com escopo definido, execute ./build-all.sh test antes de enviar e explique por que na descrição do PR.
• Relatos de bugs: abra uma issue com seu dispositivo e versão do Android, uma reprodução curta e o log de diagnóstico (Configurações → Exportar Log de Diagnóstico no app).

Projetos relacionados

RikkaHub Agent é um fork do RikkaHub, o cliente de chat LLM nativo para Android, que o transforma em um agente real no dispositivo: mais de 80 ferramentas de dispositivo, tarefas agendadas, um navegador controlado por IA, um workspace Linux, SSH, automação de tela e um bot remoto do Telegram, tudo opcional. Sua ferramenta SSH pode acessar uma VM Podroid em execução (localhost:9922), para que um agente no seu celular possa compilar, executar e inspecionar containers sem que você digite um comando.

Créditos

QEMU	Emulação de máquina
Termux	Motor do emulador de terminal
Alpine Linux	A distribuição guest

Lista completa em CREDITS.md.

Licença

GPLv2. Se o Podroid for útil para você, uma estrela ajuda outras pessoas a encontrá-lo.