ahmed-alnassif/androshAndroSH No-Root Multi-Distribuição Linux no Android via Shizuku/ADB - Execute Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, OpenSUSE e Chimera com integração total ao sistema, isolamento proot e GUI Termux:X11.
Execute e gerencie distribuições Linux completas no seu dispositivo Android - sem necessidade de root.
[!Important] Antes de começar: instale e execute o Shizuku primeiro. Se você é novo no AndroSH, leia a seção completa de Instalação abaixo - ela cobre a configuração do Shizuku e a solução de problemas.
# No 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
Todas as distribuições acima são provenientes de uma fonte rootfs verificada e são executadas em um ambiente proot isolado - sem necessidade de root.
O AndroSH permite implantar e gerenciar múltiplas distribuições Linux completas no Android executando o PRoot através da camada de execução ADB/Shizuku. Isso proporciona execução elevada no lado do Android sem root, mantendo a integração direta com o sistema Android de dentro dos ambientes 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:whiteDe dentro de qualquer distro, você pode acessar diretamente o sistema 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] quando você executa
androsh setup, o AndroSH verifica automaticamente se o Shizuku está configurado corretamente e orienta você na correção, caso não esteja.
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
Consulte AndroSH_Help.md para todos os comandos e flags, incluindo controle de verbosidade (--verbose / --quiet) e formatação de timestamp (--time-style).
Aprendendo Linux
androsh setup classroom --distro ubuntu --type stable
apt install gcc python3-dev git curl wget
Pesquisa de segurança / testes de penetração
androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark
Ambientes de desenvolvimento leves
androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli
Estação de trabalho em movimento
androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools
Executando vários ambientes ao mesmo tempo
androsh setup frontend --distro ubuntu -t stable
androsh setup backend --distro debian -t stable
androsh setup security --distro kali-nethunter -t nano
androsh lsd
| Componente | Fonte | Finalidade |
|---|---|---|
| PRoot | ahmed-alnassif/proot | Builds automatizados, estaticamente vinculados e otimizados para Android |
| BusyBox NDK | Magisk-Modules-Repo/busybox-ndk | Utilitários Unix essenciais (tar, grep, awk, etc.) para Android |
Pipelines de build: PRoot builder · BusyBox NDK sources · AndroSH core
Todas as dependências são rastreáveis até suas fontes upstream e mantidas em sincronia com atualizações de segurança.
Redefinir um ambiente corrompido
androsh setup <distro> --distro debian -t stable --resetup
Limpar arquivos temporários
androsh clean <distro>
Reinstalar o comando global androsh
cd AndroSH
python main.py install
Problemas com o Shizuku
Contribuições de todos os tipos são bem-vindas - código, documentação, relatórios de bugs, ideias de recursos, traduções, testes ou apenas compartilhar feedback. Seja corrigindo um erro de digitação ou adicionando suporte a uma nova distro, toda contribuição ajuda.
Formas de se envolver:
Nenhuma contribuição é pequena demais - se você não tem certeza de onde começar, abra uma issue e pergunte.
Configure um ambiente de desenvolvimento:
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 - livre para uso comercial e de pesquisa.
Ahmed Al-Nassif
Cada bit de suporte, grande ou pequeno, ajuda a manter o projeto crescendo.
Ambientes Linux profissionais no seu bolso - sem exigir root no Android.
| Capacidade | AndroSH | Alternativas Típicas |
|---|
| Múltiplas distros ao mesmo tempo | Sim | Geralmente apenas uma distro |
| Gerenciamento de ambientes | SQLite + CLI | Manipulação manual de arquivos |
| Integração com o sistema Android | Execução ADB/Shizuku | Varia conforme a solução |
| Múltiplas instâncias isoladas | Sim | Instância única |
| Requer root | Não (ADB/Shizuku) | Frequentemente requer desbloqueio do bootloader |
| Comando | Prévia | O que mostra |
|---|
androsh launch kali | Ver | Iniciando o ambiente Kali NetHunter |
androsh list | Ver | Todas as distribuições disponíveis |
androsh lsd | Ver | Ambientes que você já instalou |