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

Í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 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

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

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	Iniciando o ambiente Kali NetHunter
androsh list	Ver	Todas as distribuições disponíveis
androsh lsd	Ver	Ambientes que você já instalou

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 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

Instalação

Requisitos

• Dispositivo Android com 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 orienta você 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