ahmed-alnassif/androshAndroSH — мультидистрибутивный Linux на Android без root через Shizuku/ADB — запускайте Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, OpenSUSE и Chimera с полной системной интеграцией, изоляцией proot и графическим интерфейсом Termux:X11.
Запускайте и управляйте полноценными дистрибутивами 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
Каждый из перечисленных дистрибутивов поставляется из проверенного источника 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
# 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 setupAndroSH автоматически проверяет, правильно ли настроен 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
| Компонент | Источник | Назначение |
|---|---|---|
| PRoot | ahmed-alnassif/proot | Статически слинкованные, оптимизированные для Android автоматические сборки |
| BusyBox NDK | Magisk-Modules-Repo/busybox-ndk | Базовые утилиты Unix (tar, grep, awk и т. д.) для Android |
Конвейеры сборки: 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
Мы приветствуем любой вклад — код, документацию, сообщения об ошибках, идеи функций, переводы, тестирование или просто отзывы. Исправляете ли вы опечатку или добавляете поддержку нового дистрибутива — каждый вклад помогает.
Способы принять участие:
Не бывает слишком маленького вклада — если вы не знаете, с чего начать, откройте 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
Любая поддержка, большая или маленькая, помогает проекту расти.
Профессиональные окружения Linux в вашем кармане — без необходимости root на Android.
| Возможность | AndroSH | Типичные альтернативы |
|---|
| Несколько дистрибутивов одновременно | Да | Обычно только один дистрибутив |
| Управление окружениями | SQLite + CLI | Ручная работа с файлами |
| Интеграция с системой Android | Выполнение через ADB/Shizuku | Зависит от решения |
| Несколько изолированных экземпляров | Да | Один экземпляр |
| Требуется root | Нет (ADB/Shizuku) | Часто требуется разблокировка загрузчика |
| Команда | Просмотр | Что показано |
|---|
androsh launch kali | Просмотр | Запуск окружения Kali NetHunter |
androsh list | Просмотр | Все доступные дистрибутивы |
androsh lsd | Просмотр | Уже установленные окружения |