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-десктоп — запуск 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

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

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

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

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

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

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

Лицензия

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