Podroid

Запускайте Linux-контейнеры и полноценный рабочий стол Linux на вашем Android-смартфоне. Без root.

Настоящая виртуальная машина Alpine Linux с собственным ядром — не chroot и не трюк с proot — поэтому Podman, Docker и LXC работают в точности так же, как на сервере.

Веб-сайт · Документация · Скачать APK

_{Главный экран}

_{Работает}

_{Терминал}

_{Темы и шрифты}

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

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

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

Скачайте APK и установите его.
Нажмите 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 вам полезен, звезда поможет другим людям найти его.

Podroid v1.2.7