AndroSH — запуск дистрибутивов Linux на Android (без root, на базе ADB/Shizuku)

Содержание

• Быстрый старт
• Возможности
• Поддерживаемые дистрибутивы
• Обзор
• Скриншоты
• Архитектура
• Установка
• Обновление
• Использование
• Сценарии использования
• Безопасность и конфиденциальность
• Компоненты и источники
• Устранение неполадок
• Участие в разработке
• Лицензия
• Автор
• Поддержка

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

[!Important] Перед началом: сначала установите и запустите Shizuku. Если вы впервые работаете с AndroSH, прочитайте полный раздел Установка ниже — в нём описана настройка Shizuku и устранение неполадок.

# In Termux
apt update && apt install -y python git
git clone --depth 1 https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
pip install -r requirements.txt
python main.py install

androsh setup demo --distro debian --type stable
androsh launch demo

Возможности

• Мультидистрибутивность: запускайте несколько дистрибутивов Linux одновременно (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
• Linux на базе ADB/Shizuku: запускайте полноценные дистрибутивы Linux через привилегированный слой Shell Android с прямой интеграцией в систему Android — root не требуется
• На базе SQLite: быстрое и надёжное отслеживание ваших окружений
• Изоляция: каждое окружение Linux работает через PRoot с изоляцией файловой системы и процессов в пользовательском пространстве
• Поддержка GUI: работает с Termux:X11 для полноценного рабочего стола — руководство по настройке

Поддерживаемые дистрибутивы

Каждый из перечисленных дистрибутивов поставляется из проверенного источника rootfs и работает в изолированном окружении proot — root не требуется.

Обзор

AndroSH позволяет развёртывать и управлять несколькими полноценными дистрибутивами Linux на Android, запуская PRoot через слой выполнения ADB/Shizuku. Это обеспечивает привилегированное выполнение на стороне Android без root, сохраняя при этом прямую интеграцию с системой Android изнутри окружений Linux.

Возможность	AndroSH	Типичные альтернативы
Несколько дистрибутивов одновременно	Да	Обычно только один дистрибутив
Управление окружениями	SQLite + CLI	Ручная работа с файлами
Интеграция с системой Android	Выполнение через ADB/Shizuku	Зависит от решения
Несколько изолированных экземпляров	Да	Один экземпляр
Требуется root	Нет (ADB/Shizuku)	Часто требуется разблокировка загрузчика

Скриншоты

Команда	Просмотр	Что показано
androsh launch kali	Просмотр	Запуск окружения Kali NetHunter
androsh list	Просмотр	Все доступные дистрибутивы
androsh lsd	Просмотр	Уже установленные окружения

Архитектура

Android Device → ADB/Shizuku Execution Context→ Proot Virtualization → Linux Environment(s)

graph TD
    A[Android Device] --> B[ADB / Shizuku]
    B --> C[Android Shell Execution Context]
    C --> D[PRoot]

    D --> E[Alpine]
    D --> F[Debian]
    D --> G[Ubuntu]
    D --> H[Kali NetHunter]

    E --> I[Android System Integration]
    F --> I
    G --> I
    H --> I

    I --> K[Android Command Execution]
    I --> L[Android Filesystem Access]
    I --> M[Android Network Access]

    style D fill:#FF6B00,color:white
    style I fill:#4CAF50,color:white

Изнутри любого дистрибутива вы можете напрямую обращаться к системе Android:

# List installed Android packages
pm list packages -f

# Kernel info
cat /proc/version

# Android system properties
getprop | grep version

# Network routes
ip route show

Установка

Требования

• Android-устройство с установленным и запущенным Shizuku
• Python 3.8+
• Termux или совместимый эмулятор терминала
• Не менее 2 ГБ свободного места

Настройка

# Install prerequisites in Termux
apt update && apt install -y python git

# Get AndroSH
git clone --depth 1 https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH

# Install dependencies
pip install -r requirements.txt

# Make the `androsh` command available globally
python main.py install

[!Tip] при запуске androsh setup AndroSH автоматически проверяет, правильно ли настроен Shizuku, и помогает исправить проблемы, если это не так.

Обновление

cd AndroSH
git pull
pip install -r requirements.txt

Использование

Развёртывание окружения

androsh setup production --distro debian --type stable

Запуск

androsh launch production
# You're now root inside the Debian environment
root@localhost:~# apt update && apt install python3 git

Управление окружениями

androsh list                       # See what's available to install
androsh lsd                        # See what's already installed
androsh clean production           # Free up space / remove temp files
androsh remove production --force  # Delete an environment

Прямое управление дистрибутивами