功能亮点

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

快速开始

1. 下载 APK 并安装。
2. 点击 启动虚拟机，等待 就绪！，然后打开终端。

# 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

安装、两个后端、网络、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 版本、简短复现步骤以及诊断日志（应用中的 Settings → Export Diagnostic Log）。

相关项目

RikkaHub Agent 是 RikkaHub（原生 Android LLM 聊天客户端）的一个分支，它将其转变为真正的设备端智能体：80+ 设备工具、定时任务、AI 驱动的浏览器、Linux 工作区、SSH、屏幕自动化以及远程 Telegram 机器人，全部为可选启用。其 SSH 工具可以登录到正在运行的 Podroid VM（localhost:9922），因此你手机上的智能体无需你输入任何命令即可构建、运行和检查容器。

致谢

QEMU	机器模拟
Termux	终端模拟器引擎
Alpine Linux	客户机发行版

完整列表见 CREDITS.md。

许可证

GPLv2。如果 Podroid 对你有用，点个 star 能帮助其他人发现它。