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.
# AndroSH - Execute Distribuições Linux no Android (Sem Root, com ADB/Shizuku)
<div align="center">
**Execute e gerencie distribuições Linux completas no seu dispositivo Android - sem necessidade de root.**
<img src="https://raw.githubusercontent.com/ahmed-alnassif/androsh/main/Assets/docs/AndroSH.png" alt="AndroSH" width="98%" />
[](https://github.com/ahmed-alnassif/AndroSH/actions/workflows/tests.yml)
[](https://github.com/ahmed-alnassif/AndroSH/stargazers)
[](https://github.com/ahmed-alnassif/AndroSH/releases)
[](https://python.org)
[](/LICENSE)
[](https://www.android.com)
<img src="https://assets.kitploit.com/production/public/readmes/9438/a4edb8815ebca0fde7738d96503897a680bcd0aaf4c21f1b329f30c3a56b6ec3.png" alt="AndroSH Mobile Showcase" width="90%" />
</div>
## Índice
- [Início Rápido](#início-rápido)
- [Recursos](#recursos)
- [Distribuições Suportadas](#distribuições-suportadas)
- [Visão Geral](#visão-geral)
- [Capturas de Tela](#capturas-de-tela)
- [Arquitetura](#arquitetura)
- [Instalação](#instalação)
- [Atualização](#atualização)
- [Uso](#uso)
- [Casos de Uso](#casos-de-uso)
- [Segurança e Privacidade](#segurança-e-privacidade)
- [Componentes e Fontes](#componentes-e-fontes)
- [Solução de Problemas](#solução-de-problemas)
- [Contribuindo](#contribuindo)
- [Licença](#licença)
- [Autor](#autor)
- [Suporte](#suporte)
## Início Rápido
> [!Important]
> **Antes de começar:** instale e execute o [Shizuku](https://github.com/RikkaApps/Shizuku/releases/latest) primeiro. Se você é novo no AndroSH, leia a seção completa de [Instalação](#instalação) abaixo - ela cobre a configuração do Shizuku e a solução de problemas.
```bash
# 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
```
## Recursos
- **Multi-distro**: execute várias distribuições Linux lado a lado (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
- **Linux com ADB/Shizuku**: execute distribuições Linux completas através da camada Shell elevada do Android, com integração direta ao sistema Android - sem necessidade de root
- **Baseado em SQLite**: rastreamento rápido e confiável dos seus ambientes
- **Isolado**: cada ambiente Linux é executado através do PRoot com isolamento de sistema de arquivos/processos em espaço de usuário
- **Suporte a GUI**: funciona com o Termux:X11 para um ambiente de desktop completo - [guia de configuração](https://github.com/ahmed-alnassif/AndroSH/discussions/6#discussioncomment-15720947)
## Distribuições Suportadas
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.
## Visão Geral
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.
| 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 |
## Capturas de Tela
| Comando | Prévia | O que mostra |
|---|:---:|---|
| `androsh launch kali` | [Ver](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/launch-kali.png) | Iniciando o ambiente Kali NetHunter |
| `androsh list` | [Ver](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/list-available.png) | Todas as distribuições disponíveis |
| `androsh lsd` | [Ver](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/Screenshots/list-installed.png) | Ambientes que você já instalou |
## Arquitetura
```
Android Device → ADB/Shizuku Execution Context→ Proot Virtualization → Linux Environment(s)
```
```mermaid
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
```
De dentro de qualquer distro, você pode acessar diretamente o sistema Android:
```bash
# List installed Android packages
pm list packages -f
# Kernel info
cat /proc/version
# Android system properties
getprop | grep version
# Network routes
ip route show
```
## Instalação
### Requisitos
- Dispositivo Android com [Shizuku](https://github.com/RikkaApps/Shizuku/releases/latest) instalado e em execução
- Python 3.8+
- [Termux](https://github.com/termux/termux-app/releases/latest) ou um emulador de terminal compatível
- Pelo menos 2 GB de armazenamento livre
### Configuração
```bash
# 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.
## Atualização
```bash
cd AndroSH
git pull
pip install -r requirements.txt
```
## Uso
### Implantar um ambiente
```bash
androsh setup production --distro debian --type stable
```
### Iniciá-lo
```bash
androsh launch production
# You're now root inside the Debian environment
root@localhost:~# apt update && apt install python3 git
```
### Gerenciar ambientes
```bash
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
```
### Gerenciar distribuições diretamente
```bash
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
```
### Referência completa de comandos
Consulte [AndroSH_Help.md](https://github.com/ahmed-alnassif/androsh/blob/main/Assets/docs/AndroSH_Help.md) para todos os comandos e flags, incluindo controle de verbosidade (`--verbose` / `--quiet`) e formatação de timestamp (`--time-style`).
## Casos de Uso
**Aprendendo Linux**
```bash
androsh setup classroom --distro ubuntu --type stable
apt install gcc python3-dev git curl wget
```
**Pesquisa de segurança / testes de penetração**
```bash
androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark
```
**Ambientes de desenvolvimento leves**
```bash
androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli
```
**Estação de trabalho em movimento**
```bash
androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools
```
**Executando vários ambientes ao mesmo tempo**
```bash
androsh setup frontend --distro ubuntu -t stable
androsh setup backend --distro debian -t stable
androsh setup security --distro kali-nethunter -t nano
androsh lsd
```
## Segurança e Privacidade
- **Limite de privilégios do Android**: as operações no lado do Android são executadas dentro das permissões disponíveis para o contexto de execução ADB/Shizuku; nenhum root do Android é necessário.
- **Isolamento de processos**: cada ambiente é executado em sandbox via proot
- **Verificações de integridade**: checksums SHA-256 validam cada download
- **Sem telemetria**: zero coleta de dados, tudo permanece local no seu dispositivo
- **Código aberto**: cada componente é auditável
## Componentes e Fontes
| Componente | Fonte | Finalidade |
|---|---|---|
| PRoot | [ahmed-alnassif/proot](https://github.com/ahmed-alnassif/proot) | Builds automatizados, estaticamente vinculados e otimizados para Android |
| BusyBox NDK | [Magisk-Modules-Repo/busybox-ndk](https://github.com/Magisk-Modules-Repo/busybox-ndk) | Utilitários Unix essenciais (tar, grep, awk, etc.) para Android |
Pipelines de build: [PRoot builder](https://github.com/ahmed-alnassif/proot) · [BusyBox NDK sources](https://github.com/ahmed-alnassif/busybox) · [AndroSH core](https://github.com/ahmed-alnassif/AndroSH)
Todas as dependências são rastreáveis até suas fontes upstream e mantidas em sincronia com atualizações de segurança.
## Solução de Problemas
**Redefinir um ambiente corrompido**
```bash
androsh setup <distro> --distro debian -t stable --resetup
```
**Limpar arquivos temporários**
```bash
androsh clean <distro>
```
**Reinstalar o comando global `androsh`**
```bash
cd AndroSH
python main.py install
```
**Problemas com o Shizuku**
- Confirme que o Shizuku está em execução e que o AndroSH está autorizado nele
- Se os problemas persistirem, reinicie o dispositivo para restaurar o serviço do Shizuku
## Contribuindo
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:
- **Código**: corrija bugs, adicione recursos, melhore o desempenho
- **Documentação**: melhore o README, escreva guias, adicione exemplos
- **Testes**: experimente o AndroSH em diferentes dispositivos/versões do Android e relate o que encontrar
- **Relatórios de bugs**: abra uma issue com passos claros para reproduzir
- **Solicitações de recursos**: sugira ideias ou fluxos de trabalho que você gostaria de ver suportados
- **Suporte à comunidade**: ajude a responder perguntas em issues/discussões
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:
```bash
git clone https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
## Contribuidores
[](https://github.com/ahmed-alnassif/AndroSH/graphs/contributors)
## Licença
GPLv3 - livre para uso comercial e de pesquisa.
## Autor
**Ahmed Al-Nassif**
- GitHub: [@ahmed-alnassif](https://github.com/ahmed-alnassif)
## Suporte
- **Dê uma estrela no repositório** se achar útil - isso ajuda outras pessoas a descobrirem o projeto
- **Compartilhe** com amigos, comunidades ou nas redes sociais se o AndroSH foi útil para você
- **Abra uma issue** para relatar bugs
- **Inicie uma discussão** para sugerir recursos ou fazer perguntas
- **Compartilhe seu caso de uso** - conte-nos como você está usando o AndroSH, isso ajuda a moldar o desenvolvimento futuro
- **Divulgue** escrevendo sobre ele, fazendo um vídeo ou recomendando-o onde quer que entusiastas de Android/Linux se reúnam
Cada bit de suporte, grande ou pequeno, ajuda a manter o projeto crescendo.
---
<div align="center">
*Ambientes Linux profissionais no seu bolso - sem exigir root no Android.*
</div>