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

Ejecuta y gestiona distribuciones completas de Linux en tu dispositivo Android - sin necesidad de root.

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.

Capturas de Pantalla

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

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

Gestionar distribuciones directamente

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

Referencia completa de comandos

Consulta AndroSH_Help.md para ver todos los comandos y opciones, incluyendo el control de verbosidad (--verbose / --quiet) y el formato de marca de tiempo (--time-style).

Casos de Uso

Aprender Linux

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

Investigación de seguridad / pruebas de penetración

androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark

Entornos de desarrollo ligeros

androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli

Estación de trabajo portátil

androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools

Ejecutar varios entornos a la vez

androsh setup frontend --distro ubuntu -t stable
androsh setup backend --distro debian -t stable
androsh setup security --distro kali-nethunter -t nano
androsh lsd

Seguridad y Privacidad

• Límite de privilegios de Android: las operaciones del lado de Android se ejecutan dentro de los permisos disponibles para el contexto de ejecución ADB/Shizuku; no se requiere root de Android.
• Aislamiento de procesos: cada entorno se ejecuta en sandbox a través de proot
• Verificaciones de integridad: las sumas de verificación SHA-256 validan cada descarga
• Sin telemetría: cero recopilación de datos, todo permanece local en tu dispositivo
• Código abierto: cada componente es auditable

Componentes y Fuentes

Pipelines de compilación: PRoot builder · BusyBox NDK sources · AndroSH core

Todas las dependencias son rastreables hasta sus fuentes originales y se mantienen sincronizadas con las actualizaciones de seguridad.

Solución de Problemas

Restablecer un entorno dañado

androsh setup <distro> --distro debian -t stable --resetup

Limpiar archivos temporales

androsh clean <distro>

Reinstalar el comando global androsh

cd AndroSH
python main.py install

Problemas con Shizuku

• Confirma que Shizuku está en ejecución y que AndroSH está autorizado en él
• Si los problemas persisten, reinicia el dispositivo para restaurar el servicio Shizuku

Contribuir

Todo tipo de contribuciones son bienvenidas - código, documentación, informes de errores, ideas de funcionalidades, traducciones, pruebas o simplemente compartir comentarios. Ya sea que estés corrigiendo un error tipográfico o añadiendo soporte para una nueva distro, cada contribución ayuda.

Formas de participar:

• Código: corrige errores, añade funcionalidades, mejora el rendimiento
• Documentación: mejora el README, escribe guías, añade ejemplos
• Pruebas: prueba AndroSH en diferentes dispositivos/versiones de Android y reporta lo que encuentres
• Informes de errores: abre un issue con pasos claros para reproducir
• Solicitudes de funcionalidades: sugiere ideas o flujos de trabajo que te gustaría ver soportados
• Soporte comunitario: ayuda a responder preguntas en issues/discussions

Ninguna contribución es demasiado pequeña - si no estás seguro de por dónde empezar, abre un issue y pregunta.

Configura un entorno de desarrollo:

git clone https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Colaboradores

Licencia

GPLv3 - gratuita para uso comercial y de investigación.

Autor

Ahmed Al-Nassif

• GitHub: @ahmed-alnassif

Soporte

• Dale una estrella al repositorio si te resulta útil - ayuda a que otros descubran el proyecto
• Compártelo con amigos, comunidades o en redes sociales si AndroSH te ha sido útil
• Abre un issue para reportar errores
• Inicia una discusión para sugerir funcionalidades o hacer preguntas
• Comparte tu caso de uso - cuéntanos cómo usas AndroSH, ayuda a dar forma al desarrollo futuro
• Corre la voz escribiendo sobre ello, haciendo un vídeo o recomendándolo donde sea que se reúnan los entusiastas de Android/Linux

Cada muestra de apoyo, grande o pequeña, ayuda a que el proyecto siga creciendo.