AndroSH - Execute Distribuições Linux no Android (Sem Root, com Tecnologia ADB/Shizuku)

Execute e gerencie distribuições Linux completas no seu dispositivo Android - sem necessidade de root.

Índice

• Início Rápido
• Recursos
• Distribuições Suportadas
• Visão Geral
• Capturas de Tela
• Arquitetura
• Instalação
• Atualização
• Uso
• Casos de Uso
• Segurança e Privacidade
• Componentes e Fontes
• Solução de Problemas
• Contribuindo
• Licença
• Autor
• Suporte

Início Rápido

[!Important] Antes de começar: instale e execute o Shizuku primeiro. Se você é novo no AndroSH, leia a seção Instalação completa abaixo - ela cobre a configuração e a solução de problemas do 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

Recursos

• Multi-distro: execute várias distribuições Linux lado a lado (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
• Linux com tecnologia ADB/Shizuku: execute distribuições Linux completas por meio da camada Shell elevada do Android, com integração direta com o sistema Android - sem necessidade de root
• Com suporte a SQLite: rastreamento rápido e confiável dos seus ambientes
• Isolado: cada ambiente Linux é executado por meio do PRoot com isolamento de sistema de arquivos/processos no espaço do usuário
• Suporte a GUI: funciona com Termux:X11 para um ambiente desktop completo - guia de configuração

Distribuições Suportadas

Cada distribuição acima é fornecida a partir de uma fonte rootfs verificada e é executada em um ambiente proot isolado - sem necessidade de root.

Visão Geral

O AndroSH permite que você implante e gerencie múltiplas distribuições Linux completas no Android executando o PRoot por meio 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 a partir dos ambientes Linux.

Capturas de Tela

Arquitetura

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

De dentro de qualquer distro, você pode acessar o sistema Android diretamente:

# 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 o Shizuku instalado e em execução
• Python 3.8+
• Termux ou um emulador de terminal compatível
• Pelo menos 2 GB de armazenamento livre

Configuração

# 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 o orienta na correção, caso não esteja.

Atualização

cd AndroSH
git pull
pip install -r requirements.txt

Uso

Implantar um ambiente

androsh setup production --distro debian --type stable

Iniciá-lo

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

Gerenciar ambientes

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

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 para ver todos os comandos e flags, incluindo controle de verbosidade (--verbose / --quiet) e formatação de timestamps (--time-style).

Casos de Uso

Aprendendo Linux

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

Pesquisa de segurança / teste 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 móvel

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

Segurança e Privacidade

• Limite de privilégios do Android: as operações do 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: somas de verificação SHA-256 validam cada download
• Sem telemetria: coleta zero de dados, tudo permanece local no seu dispositivo
• Código aberto: todos os componentes são auditáveis

Componentes e Fontes

Pipelines de build: PRoot builder · fontes do BusyBox NDK · núcleo do 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 quebrado

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

• 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 e pesquisas de segurança são bem-vindas. Áreas prioritárias atuais:

• Otimização de desempenho
• Ferramentas de implantação
• Endurecimento de segurança

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

Licença

GPLv3 - livre para uso comercial e de pesquisa.

Autor

Ahmed Al-Nassif

• GitHub: @ahmed-alnassif

Suporte

• Dê uma estrela no repositório se você o achar útil
• Abra uma issue para relatar bugs
• Sugira recursos ou compartilhe como você está usando o AndroSH