Podroid：安卓上的 Linux 容器虚拟机

项目简介

Podroid 是一款免 root 的 Android 应用，能在手机上跑起一个完整的 Alpine Linux 虚拟机。它使用 QEMU 搭配定制内核，在支持的 pKVM 设备上也可使用硬件加速的 AVF，因此它并非 chroot 或 proot 之类的取巧方案。正因为是真正的虚拟机，Podman、Docker 和 LXC 的行为与在服务器上一致。

项目支持 Android 8 及以上的 arm64 设备，界面提供英文与中文。

主要功能

• 容器运行时：Podman、Docker、LXC 预装，开机即可使用
• 两种后端：QEMU + 定制内核，或受支持 pKVM 设备上的硬件加速 AVF
• 内置终端：完整 xterm-256color，122 套配色主题、13 种字体，支持实时调整尺寸
• X11 桌面：在内置查看器中运行 Linux GUI 应用，支持触摸、键盘、鼠标与音频
• USB 直通、SSH、端口转发，以及客户机到 Android 的桥接
• 容器备份、实时 VM/设备状态视图、与客户机共享 Downloads 文件夹

安装与使用

1. 下载并安装 APK（见 Releases）。
2. 点击 Start VM，等待出现 Ready!，然后打开终端。

# 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

从源码构建：

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

分组件构建与工具链细节见 CONTRIBUTING.md。安装向导、两种后端、网络配置、X11 查看器与故障排查的说明都在文档里。

注意事项

• 仅支持 Android 8+ 的 arm64 设备，且不需要 root 权限。
• 需要授予通知权限，以便查看和停止虚拟机；同时需要允许后台不受限制运行，否则离开应用后 Android 可能杀掉虚拟机。
• 项目以 GPLv2 许可发布。

本作品整理自 GitHub 开源项目 ExTV/Podroid，原作者 @ExTV，许可证 GPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。