Podroid README

The project's README from github.com/ExTV/Podroid. As one markdown file: README.md.

Podroid logo

Podroid

Run Linux containers and a full Linux desktop on your Android phone. No root.

A real Alpine Linux VM with its own kernel - not a chroot or proot trick - so Podman, Docker and LXC behave exactly like they do on a server.

Release Downloads Stars License Android 8+ arm64

Website · Documentation · Download APK

Home screen before the VM starts
Home
Home screen with the VM running and network info
Running
Built-in terminal showing Alpine system info
Terminal
Terminal Quick Settings with themes and fonts
Themes & fonts

What you get

Quick start

  1. Download the APK and install it.
  2. Tap Start VM, wait for Ready!, open the 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, the two backends, networking, the X11 viewer and troubleshooting all live in the documentation.

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)

Per-component builds and toolchain details: CONTRIBUTING.md.

Contributing

Contributions of every size are welcome: bug reports, kernel-config tweaks, new themes, UI polish, X11 input fixes, anything.

RikkaHub Agent is a fork of RikkaHub, the native Android LLM chat client, that turns it into a real on-device agent: 80+ device tools, scheduled jobs, an AI-driven browser, a Linux workspace, SSH, screen automation and a remote Telegram bot, all opt-in. Its SSH tool can log into a running Podroid VM (localhost:9922), so an agent on your phone can build, run and inspect containers without you typing a command.

Credits

QEMU Machine emulation
Termux Terminal emulator engine
Alpine Linux The guest distribution

Full list in CREDITS.md.

License

GPLv2. If Podroid is useful to you, a star helps other people find it.

Podroid (ExTV/Podroid)

Searching Database…

3.5K ·GitHub
这是什么?Podroid 是一款免 root 的安卓应用,能在手机上启动真正的 Alpine Linux 虚拟机,让你运行 Linux 容器(Podman、Docker、LXC),甚至运行完整的图形界面桌面应用。
这只是个终端模拟器,还是带内核的真正虚拟机?它是真正的虚拟机,不是 chroot 或 proot 之类的技巧:Alpine Linux 通过 QEMU 运行在定制的内核上,在支持的 pKVM 设备上则运行于硬件加速的 AVF,容器行为和在真实服务器上完全一样。
怎么让它跑起来?下载 APK 并安装,然后点按“Start VM”并等待“Ready!”状态出现,再打开内置终端。
需要 root 或特定的安卓版本吗?不需要 root;任何运行 Android 8 或更新版本的 arm64 设备都能用。
每部手机都能获得硬件加速性能吗?不能——虚拟机默认通过软件模拟的 QEMU 运行,只有在支持 pKVM 的设备上才会切换到更快的硬件加速 AVF 通道。
虚拟机启动后已经预装了什么?Podman、Docker 和 LXC 都已预装,虚拟机启动完成的瞬间即可使用,无需额外配置。
能运行图形界面的 Linux 应用,还是只能用终端?除了带 122 套配色主题和 13 种字体的完整 xterm-256color 终端,Podroid 还内置 X11 查看器,可渲染图形界面的 Linux 应用,并支持触控、键盘、鼠标和声音。
能通过 SSH 访问虚拟机或使用 USB 设备吗?可以。Podroid 支持 USB 直通、SSH 访问、端口转发和客户机到安卓的桥接,还有容器备份以及与客户机共享下载文件夹。
RikkaHub Agent 是什么?它怎么连接 Podroid?RikkaHub Agent 是原生安卓大模型聊天客户端 RikkaHub 的一个分支,被改造成端侧 AI 智能体;它的 SSH 工具可以登录运行中的 Podroid 虚拟机(localhost:9922),让智能体自主构建和检查容器。
Creator
ExTV
Size
34 MB
Stars
3.5K
Age
7mo
Commits · 90 Days