通过 ADB/Shizuku 集成在 Android 设备上进行专业级 Linux 发行版管理
[!Important] 请确保 Shizuku 已安装并正在运行。
新用户应遵循 📥 详细安装 指南。
该项目包含故障排查帮助和 Shizuku 设置说明（如有需要）。
apt update; apt install -y python git # Termux
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
所有列出的发行版均通过经过验证的 rootfs 源获得全面支持，并在隔离的 proot 环境中运行，无需 Root 权限。
AndroSH 是一个部署平台，通过先进的 proot 虚拟化和通过 ADB/Shizuku 实现的 Android 系统集成，可在 Android 设备上无缝运行多个 Linux 发行版。该解决方案提供专业级的 Linux 环境管理，同时不损害设备安全性。
AndroSH 通过 ADB 和 Shizuku 提供前所未有的 Android-Linux 集成能力：
# Execute Android system commands from Linux environment
pm list packages -f
# Access kernel-level information
cat /proc/version
# System property management
getprop | grep version
# Network configuration access
ip route show
--time-style--verbose/--quiet）# Environment deployment
androsh setup development --distro ubuntu --type stable
# Multi-instance management
androsh list
# Resource optimization
androsh clean development
# Global accessibility
cd AndroSH
python main.py install
❯ androsh list
# Shows beautiful distribution table with sizes and types
❯ androsh lsd
# Displays installed environments with ASCII art header
Android Device → ADB/Shizuku API → Elevated Permissions → Proot Virtualization → Multi-Distribution Linux Environment
graph TD
A[Android Device] --> B[ADB/Shizuku API]
B --> C[Elevated Permissions]
C --> D[PROOT Virtualization Layer]
D --> E[Alpine Linux]
D --> F[Debian Stable]
D --> G[Ubuntu LTS]
D --> H[Kali NetHunter]
E --> I[Android System Integration]
F --> I
G --> I
H --> I
I --> K[Android Command Execution]
I --> L[File System Access]
I --> M[Network Configuration]
style D fill:#FF6B00,color:white
style I fill:#4CAF50,color:white
apt update
apt install -y python git
# Repository acquisition
git clone --depth 1 https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
# Dependency installation
pip install -r requirements.txt
# Global accessibility configuration
python main.py install
cd AndroSH
git pull
pip install -r requirements.txt
[!Tip] 输入此命令后，项目会检查 Shizuku，并在需要时为您提供正确设置它的说明。
androsh setup production --distro debian --type stable
androsh launch production
# Root access in Debian environment
root@localhost:~# apt update && apt install python3 git
# Environment inventory
androsh list
# Maintenance operations
androsh clean production
# Environment removal
androsh remove production --force
# Deploy learning environment
androsh setup classroom --distro ubuntu --type stable
# Educational package installation
apt install gcc python3-dev git curl wget
# Kali NetHunter deployment
androsh setup pentest --distro kali-nethunter --type full
# Security toolkit installation
apt install nmap metasploit-framework wireshark
# Development workspace
androsh setup devops --distro alpine --type alpine-minirootfs
# Development stack deployment
apk add build-base git nodejs npm docker-cli
# Portable development environment
androsh setup field --distro debian --type stable
# Essential tools
apt install vim tmux htop net-tools
# Development environments
androsh setup frontend --distro ubuntu -t stable
androsh setup backend --distro debian -t stable
androsh setup security --distro kali-nethunter -t nano
# Environment management
androsh lsd
# Available distributions
androsh distro list
# Distribution information
androsh distro info ubuntu
# Download management
androsh distro download alpine --type alpine-minirootfs --file alpine-edge.tar.gz
# Download specific distribution without setup
androsh download alpine --type alpine-minirootfs
# Distribution management suite
androsh distro info ubuntu # Get detailed distribution info
# Clean management
androsh clean kali-nethunter # Remove temporary files
AndroSH 集成了成熟的开源组件，以确保在各种 Android 环境中的兼容性和性能。
| 组件 | 源项目 | 用途 |
|---|---|---|
| 增强版 PRoot | Xed-Editor/Karbon-PackagesX | 兼容 Shizuku 的虚拟化 |
| BusyBox NDK | Magisk-Modules-Repo/busybox-ndk |
增强版 PRoot：Shizuku 集成和 Android 权限委派所必需（Termux PRoot 不兼容）
BusyBox NDK：在各种碎片化的 Android 版本中提供一致的命令可用性（tar、grep、awk）
# Environment recovery
androsh setup <distro> --distro debian -t stable --resetup
# System cleanup
androsh clean <distro>
# Global accessibility
cd AndroSH
python main.py install
我们欢迎贡献者和安全研究人员来增强该平台。
git clone https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
# Development environment setup
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
GPLv3 许可证——适用于商业和研究用途的开源许可。
由 Ahmed Al-Nassif 设计并开发
💻 将您的 Android 设备转变为专业级 Linux 工作站
# Initialize your Professional-Grade environment today
git clone --depth 1 https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH && androsh setup enterprise --distro debian --type stable
"口袋中的专业 Linux 环境——无需牺牲安全性"
AndroSH 理念
| 能力 | AndroSH | 传统方案 |
|---|
| 多发行版架构 | ✅ Archlinux、Fedora、Alpine、Debian、Ubuntu、Kali NetHunter、Void Linux、Manjaro、OpenSUSE 和 Chimera Linux | ❌ 单一发行版 |
| 管理 | ✅ SQLite 数据库 + 专业 CLI | ❌ 手动文件管理 |
| Android 系统集成 | ✅ 通过 ADB/Shizuku 执行完整系统命令 | ❌ 仅限隔离容器 |
| 可扩展环境 | ✅ 多个隔离实例 | ❌ 单实例限制 |
| 性能优化 | ✅ 初始化速度快 40% | ❌ 启动过程缓慢 |
| 安全合规 | ✅ 无需 Root + ADB/Shizuku API | ❌ 需要解锁 Bootloader |
| 命令 | 截图 | 描述 |
|---|
androsh launch kali |  | 启动 Kali NetHunter 环境 |
androsh list |  | 查看所有可用发行版 |
androsh lsd |  | 列出已安装的环境 |
| Android 必备的 Unix 工具集 |