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

Запускайте и управляйте полноценными дистрибутивами Linux на вашем Android-устройстве — root не требуется.

Содержание

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

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

[!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.

Скриншоты

Архитектура

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

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

androsh distro list                                              # List available distros
androsh distro info ubuntu                                       # Get details on a distro
androsh distro download alpine --type alpine-minirootfs --file alpine-edge.tar.gz

Полный справочник команд

См. AndroSH_Help.md — там описаны все команды и флаги, включая управление подробностью вывода (--verbose / --quiet) и форматирование временных меток (--time-style).

Сценарии использования

Изучение Linux

androsh setup classroom --distro ubuntu --type stable
apt install gcc python3-dev git curl wget

Исследование безопасности / тестирование на проникновение

androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark

Лёгкие среды разработки

androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli

Рабочая станция в пути

androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools

Запуск нескольких окружений одновременно

androsh setup frontend --distro ubuntu -t stable
androsh setup backend --distro debian -t stable
androsh setup security --distro kali-nethunter -t nano
androsh lsd

Безопасность и конфиденциальность

• Граница привилегий Android: операции на стороне Android выполняются в пределах разрешений, доступных контексту выполнения ADB/Shizuku; root Android не требуется.
• Изоляция процессов: каждое окружение работает в песочнице через proot
• Проверка целостности: контрольные суммы SHA-256 проверяют каждую загрузку
• Без телеметрии: сбор данных отсутствует, всё остаётся локально на вашем устройстве
• Открытый исходный код: каждый компонент доступен для аудита

Компоненты и источники

Конвейеры сборки: PRoot builder · BusyBox NDK sources · AndroSH core

Все зависимости отслеживаются до их исходных источников и синхронизируются с обновлениями безопасности.

Устранение неполадок

Сброс повреждённого окружения

androsh setup <distro> --distro debian -t stable --resetup

Очистка временных файлов

androsh clean <distro>

Переустановка глобальной команды androsh

cd AndroSH
python main.py install

Проблемы с Shizuku

• Убедитесь, что Shizuku запущен и AndroSH авторизован в нём
• Если проблемы сохраняются, перезагрузите устройство, чтобы восстановить службу Shizuku

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

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

Способы принять участие:

• Код: исправляйте ошибки, добавляйте функции, улучшайте производительность
• Документация: улучшайте README, пишите руководства, добавляйте примеры
• Тестирование: пробуйте AndroSH на разных устройствах и версиях Android и сообщайте о результатах
• Сообщения об ошибках: открывайте issue с чёткими шагами воспроизведения
• Запросы функций: предлагайте идеи или сценарии, которые вы хотели бы видеть поддержанными
• Поддержка сообщества: помогайте отвечать на вопросы в issues/discussions

Не бывает слишком маленького вклада — если вы не знаете, с чего начать, откройте issue и спросите.

Настройка среды разработки:

git clone https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Участники

Лицензия

GPLv3 — бесплатно для коммерческого и исследовательского использования.

Автор

Ahmed Al-Nassif

• GitHub: @ahmed-alnassif

Поддержка

• Поставьте звезду репозиторию, если он вам полезен — это помогает другим узнать о проекте
• Поделитесь им с друзьями, сообществами или в социальных сетях, если AndroSH был вам полезен
• Откройте issue, чтобы сообщить об ошибках
• Начните обсуждение, чтобы предложить функции или задать вопросы
• Расскажите о своём сценарии использования — поведайте нам, как вы используете AndroSH, это помогает формировать будущее развитие
• Распространите информацию, написав о проекте, сделав видео или рекомендуя его везде, где собираются энтузиасты Android/Linux

Любая поддержка, большая или маленькая, помогает проекту расти.