Podroid

在 Android 手机上运行 Linux 容器和完整的 Linux 桌面。无需 root。

一个带有自己内核的真正 Alpine Linux 虚拟机——不是 chroot 或 proot 技巧——因此 Podman、Docker 和 LXC 的行为方式与在服务器上完全一致。

网站 · 文档 · 下载 APK

你将获得

Podman、Docker 和 LXC——预装，开机即可用
真正的虚拟机——基于 QEMU 在自定义内核上运行 Alpine Linux，或在受支持的 pKVM 设备上使用硬件加速的 AVF
应用内终端——完整 xterm-256color、122 个配色主题、13 种字体、实时调整大小
X11 桌面——在内置查看器中运行 GUI Linux 应用，支持触摸、键盘、鼠标和音频
USB 直通、SSH、端口转发 和 客户机到 Android 的桥接
容器备份、虚拟机/设备状态实时视图 以及与客户机共享 下载文件夹
英文和中文，无需 root，支持 Android 8+ 上的任意 arm64 设备

快速开始

下载 APK 并安装。
点击 启动 VM，等待 就绪！，然后打开终端。

# 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

安装设置、两种后端、网络、X11 查看器和故障排除都包含在文档中。

构建

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。

贡献

欢迎各种规模的贡献：错误报告、内核配置调整、新主题、UI 打磨、X11 输入修复，任何内容均可。

拉取请求： 先阅读 CONTRIBUTING.md。保持更改范围明确，推送前运行 ./build-all.sh test，并在 PR 描述中说明原因。
错误报告： 打开 issue，附上你的设备和 Android 版本、简短复现步骤以及诊断日志（应用中的 设置 → 导出诊断日志）。