
AndroSH No-Root Multi-Distro Linux on Android via Shizuku/ADB - 전체 시스템 통합, proot 격리, Termux:X11 GUI를 갖춘 Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, OpenSUSE, Chimera 실행
[!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 환경에서 실행됩니다.
AndroSH는 고급 proot 가상화 및 ADB/Shizuku를 통한 안드로이드 시스템 통합을 통해 안드로이드 장치에서 여러 Linux 배포판을 원활하게 실행할 수 있는 배포 플랫폼입니다. 이 솔루션은 장치 보안을 손상시키지 않으면서 전문가 수준의 Linux 환경 관리를 제공합니다.
AndroSH는 ADB와 Shizuku를 통해 전례 없는 Android-Linux 통합 기능을 제공합니다:
# Linux 환경에서 안드로이드 시스템 명령 실행
pm list packages -f
# 커널 수준 정보 접근
cat /proc/version
# 시스템 속성 관리
getprop | grep version
# 네트워크 구성 접근
ip route show
--time-style--verbose/--quiet)# 환경 배포
androsh setup development --distro ubuntu --type stable
# 다중 인스턴스 관리
androsh list
# 리소스 최적화
androsh clean development
# 전역 접근성
cd AndroSH
python main.py install
❯ androsh list
# 아름다운 배포판 테이블(크기, 유형 포함)을 표시합니다
❯ androsh lsd
# ASCII 아트 헤더와 함께 설치된 환경을 보여줍니다
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
# 저장소 가져오기
git clone --depth 1 https://github.com/ahmed-alnassif/AndroSH.git
cd AndroSH
# 의존성 설치
pip install -r requirements.txt
# 전역 접근성 설정
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
# Debian 환경에서 루트 접근
root@localhost:~# apt update && apt install python3 git
# 환경 목록
androsh list
# 유지보수 작업
androsh clean production
# 환경 제거
androsh remove production --force
# 학습 환경 배포
androsh setup classroom --distro ubuntu --type stable
# 교육용 패키지 설치
apt install gcc python3-dev git curl wget
# Kali NetHunter 배포
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
# 사용 가능한 배포판
androsh distro list
# 배포판 정보
androsh distro info ubuntu
# 다운로드 관리
androsh distro download alpine --type alpine-minirootfs --file alpine-edge.tar.gz
# 설정 없이 특정 배포판 다운로드
androsh download alpine --type alpine-minirootfs
# 배포판 관리 제품군
androsh distro info ubuntu # 상세 배포판 정보 보기
# 정리 관리
androsh clean kali-nethunter # 임시 파일 제거
AndroSH는 안드로이드 환경에서의 호환성과 성능을 보장하기 위해 기존의 오픈소스 구성 요소를 통합합니다.
| 구성 요소 | 원본 프로젝트 | 목적 |
|---|---|---|
| Enhanced PRoot | Xed-Editor/Karbon-PackagesX | Shizuku 호환 가상화 |
| BusyBox NDK | Magisk-Modules-Repo/busybox-ndk |
Enhanced PRoot: Shizuku 통합 및 안드로이드 권한 위임에 필요 (Termux PRoot과 호환되지 않음)
BusyBox NDK: 파편화된 Android 버전에서 일관된 명령어(tar, grep, awk)를 제공합니다
# 환경 복구
androsh setup <distro> --distro debian -t stable --resetup
# 시스템 정리
androsh clean <distro>
# 전역 접근성
cd AndroSH
python main.py install
플랫폼 개선을 위한 기여자와 보안 연구자를 환영합니다.
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 워크스테이션으로 변환하세요
# 지금 전문가 환경을 초기화하세요
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 | ❌ 수동 파일 관리 |
| 안드로이드 시스템 통합 | ✅ ADB/Shizuku를 통한 전체 시스템 명령 실행 | ❌ 격리된 컨테이너만 |
| 확장 가능한 환경 | ✅ 여러 개의 격리된 인스턴스 | ❌ 단일 인스턴스 제한 |
| 성능 최적화 | ✅ 40% 더 빠른 초기화 | ❌ 느린 시작 프로세스 |
| 보안 규정 준수 | ✅ 루트 불필요 + ADB/Shizuku API | ❌ 부트로더 잠금 해제 필요 |
| 명령어 | 스크린샷 | 설명 |
|---|
androsh launch kali | ![]() | Kali NetHunter 환경 실행 |
androsh list | ![]() | 사용 가능한 모든 배포판 보기 |
androsh lsd | ![]() | 설치된 환경 나열 |
| 안드로이드용 필수 Unix 유틸리티 |