在你的 Android 设备上运行和管理完整的 Linux 发行版 - 无需 root。
[!Important] 开始之前： 请先安装并运行 Shizuku。如果你是 AndroSH 新手，请阅读下方完整的 安装 部分 - 其中涵盖了 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
上述每个发行版均来自经过验证的 rootfs 源，并在隔离的 proot 环境中运行 - 无需 root。
AndroSH 让你能够通过 ADB/Shizuku 执行层运行 PRoot，从而在 Android 上部署和管理多个完整的 Linux 发行版。这提供了无需 root 的 Android 端高权限执行能力，同时保留从 Linux 环境内部直接集成 Android 系统的能力。
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
从任意发行版内部，你都可以直接访问 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
# 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] 当你运行
androsh setup时，AndroSH 会自动检查 Shizuku 是否配置正确，并在未正确配置时引导你完成修复。
cd AndroSH
git pull
pip install -r requirements.txt
androsh setup production --distro debian --type stable
androsh launch production
# You're now root inside the Debian environment
root@localhost:~# apt update && apt install python3 git
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
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
有关所有命令和标志的详细说明，请参阅 AndroSH_Help.md，包括详细程度控制（--verbose / --quiet）和时间戳格式（--time-style）。
学习 Linux
androsh setup classroom --distro ubuntu --type stable
apt install gcc python3-dev git curl wget
安全研究 / 渗透测试
androsh setup pentest --distro kali-nethunter --type full
apt install nmap metasploit-framework wireshark
轻量级开发环境
androsh setup devops --distro alpine --type alpine-minirootfs
apk add build-base git nodejs npm docker-cli
随身工作站
androsh setup field --distro debian --type stable
apt install vim tmux htop net-tools
同时运行多个环境
androsh setup frontend --distro ubuntu -t stable
androsh setup backend --distro debian -t stable
androsh setup security --distro kali-nethunter -t nano
androsh lsd
| 组件 | 来源 | 用途 |
|---|---|---|
| PRoot | ahmed-alnassif/proot | 静态链接、针对 Android 优化的自动化构建 |
| BusyBox NDK | Magisk-Modules-Repo/busybox-ndk | 适用于 Android 的核心 Unix 工具（tar、grep、awk 等） |
构建流水线：PRoot 构建器 · BusyBox NDK 源码 · AndroSH 核心
所有依赖项都可追溯到其上游来源，并与安全更新保持同步。
重置损坏的环境
androsh setup <distro> --distro debian -t stable --resetup
清理临时文件
androsh clean <distro>
重新安装全局 androsh 命令
cd AndroSH
python main.py install
Shizuku 问题
欢迎贡献和安全研究。当前优先领域：
设置开发环境：
git clone https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
GPLv3 - 可免费用于商业和研究用途。
Ahmed Al-Nassif
专业级 Linux 环境尽在你的口袋中 - 无需 Android root。
| 能力 | AndroSH | 典型替代方案 |
|---|
| 同时运行多个发行版 | 是 | 通常只支持一个发行版 |
| 环境管理 | SQLite + CLI | 手动处理文件 |
| Android 系统集成 | ADB/Shizuku 执行 | 因方案而异 |
| 多个隔离实例 | 是 | 单个实例 |
| Root 要求 | 否（ADB/Shizuku） | 通常需要解锁引导加载程序 |
| 命令 | 预览 | 说明 |
|---|
androsh launch kali | 查看 | 启动 Kali NetHunter 环境 |
androsh list | 查看 | 所有可用的发行版 |
androsh lsd | 查看 | 你已经安装的环境 |