Что вы получаете

• Podman, Docker и LXC — предустановлены и готовы к работе сразу после загрузки
• Настоящая виртуальная машина — Alpine Linux на собственном ядре через QEMU или с аппаратным ускорением AVF на поддерживаемых устройствах с pKVM
• Встроенный терминал — полная поддержка xterm-256color, 122 цветовые темы, 13 шрифтов, изменение размера в реальном времени
• Рабочий стол X11 — запускайте GUI-приложения Linux во встроенном просмотрщике с поддержкой касаний, клавиатуры, мыши и звука
• Проброс USB, SSH, проброс портов и мост из гостевой системы в Android
• Резервное копирование контейнеров, просмотр состояния виртуальной машины и устройства в реальном времени и общий доступ к папке Downloads с гостевой системой
• Английский и 中文, без root, любое устройство arm64 на Android 8+

Быстрый старт

1. Скачайте APK и установите его.
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

Настройка, два бэкенда, сеть, 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)

Сборка отдельных компонентов и сведения о toolchain: CONTRIBUTING.md.

Участие в разработке

Приветствуется любой вклад: сообщения об ошибках, правки конфигурации ядра, новые темы, улучшение UI, исправления ввода X11 — что угодно.

• Pull requests: сначала прочитайте CONTRIBUTING.md. Держите изменения в рамках задачи, запускайте ./build-all.sh test перед пушем и объясняйте почему в описании PR.
• Сообщения об ошибках: откройте issue, указав ваше устройство и версию Android, краткое воспроизведение и диагностический лог (Settings → Export Diagnostic Log в приложении).

Связанные проекты

RikkaHub Agent — это форк RikkaHub, нативного Android-клиента для чата с LLM, превращающий его в настоящего агента на устройстве: 80+ инструментов для работы с устройством, запланированные задачи, управляемый ИИ браузер, рабочее пространство Linux, SSH, автоматизация экрана и удалённый Telegram-бот — всё по желанию. Его SSH-инструмент может подключаться к работающей ВМ Podroid (localhost:9922), так что агент на вашем телефоне может собирать, запускать и инспектировать контейнеры без ввода команд с вашей стороны.

Благодарности

QEMU	Эмуляция машины
Termux	Движок эмулятора терминала
Alpine Linux	Гостевая дистрибуция

Полный список в CREDITS.md.

Лицензия

GPLv2. Если Podroid вам полезен, звезда поможет другим людям найти его.