AndroSH - Ejecuta distribuciones de Linux en Android (Sin root, impulsado por ADB/Shizuku)

Tabla de Contenidos

• Inicio Rápido
• Características
• Distribuciones Compatibles
• Descripción General
• Capturas de Pantalla
• Arquitectura
• Instalación
• Actualización
• Uso
• Casos de Uso
• Seguridad y Privacidad
• Componentes y Fuentes
• Solución de Problemas
• Contribuir
• Licencia
• Autor
• Soporte

Inicio Rápido

[!Important] Antes de empezar: instala y ejecuta Shizuku primero. Si eres nuevo en AndroSH, lee la sección completa de Instalación a continuación - cubre la configuración de Shizuku y la solución de problemas.

# 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

Características

• Multi-distro: ejecuta varias distribuciones de Linux en paralelo (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
• Linux impulsado por ADB/Shizuku: ejecuta distribuciones completas de Linux a través de la capa Shell elevada de Android, con integración directa del sistema Android - sin necesidad de root
• Basado en SQLite: seguimiento rápido y confiable de tus entornos
• Aislado: cada entorno Linux se ejecuta a través de PRoot con aislamiento de sistema de archivos/procesos en espacio de usuario
• Soporte de GUI: funciona con Termux:X11 para un entorno de escritorio completo - guía de configuración

Distribuciones Compatibles

Cada distribución anterior proviene de una fuente rootfs verificada y se ejecuta en un entorno proot aislado - sin necesidad de root.

Descripción General

AndroSH te permite desplegar y gestionar múltiples distribuciones completas de Linux en Android ejecutando PRoot a través de la capa de ejecución ADB/Shizuku. Esto proporciona una ejecución elevada del lado de Android sin root, manteniendo la integración directa del sistema Android desde dentro de los entornos Linux.

Capacidad	AndroSH	Alternativas Típicas
Múltiples distros a la vez	Sí	Generalmente solo una distro
Gestión de entornos	SQLite + CLI	Manejo manual de archivos
Integración con el sistema Android	Ejecución ADB/Shizuku	Varía según la solución
Múltiples instancias aisladas	Sí	Instancia única
Requiere root	No (ADB/Shizuku)	A menudo requiere desbloqueo del bootloader

Capturas de Pantalla

Comando	Vista Previa	Qué muestra
androsh launch kali	Ver	Iniciando el entorno Kali NetHunter
androsh list	Ver	Todas las distribuciones disponibles
androsh lsd	Ver	Entornos que ya has instalado

Arquitectura

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

Desde dentro de cualquier distro, puedes acceder directamente al 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

Instalación

Requisitos

• Dispositivo Android con Shizuku instalado y en ejecución
• Python 3.8+
• Termux o un emulador de terminal compatible
• Al menos 2 GB de almacenamiento libre

Configuración

# 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] cuando ejecutas androsh setup, AndroSH verifica automáticamente si Shizuku está configurado correctamente y te guía para solucionarlo si no lo está.

Actualización

cd AndroSH
git pull
pip install -r requirements.txt

Uso

Desplegar un entorno

androsh setup production --distro debian --type stable

Iniciarlo

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

Gestionar entornos