AndroSH - 안드로이드에서 Linux 배포판 실행 (루트 불필요, ADB/Shizuku 기반)

안드로이드 기기에서 루트 없이 완전한 Linux 배포판을 실행하고 관리하세요.

빠른 시작

[!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

기능

멀티 배포판: 여러 Linux 배포판을 동시에 실행 (Arch, Fedora, Alpine, Debian, Ubuntu, Kali, Void, Manjaro, Chimera, openSUSE)
ADB/Shizuku 기반 Linux: 안드로이드의 권한 상승된 Shell 레이어를 통해 완전한 Linux 배포판을 실행하며, 안드로이드 시스템과 직접 통합 - 루트 불필요
SQLite 기반: 환경을 빠르고 안정적으로 추적
격리됨: 각 Linux 환경은 PRoot를 통해 사용자 공간 파일시스템/프로세스 격리로 실행
GUI 지원: 전체 데스크톱 환경을 위해 Termux:X11과 함께 작동 - 설정 가이드

지원 배포판

위의 모든 배포판은 검증된 rootfs 소스에서 제공되며 격리된 proot 환경에서 실행됩니다 - 루트 불필요.

개요

AndroSH는 ADB/Shizuku 실행 레이어를 통해 PRoot를 실행함으로써 안드로이드에서 여러 개의 완전한 Linux 배포판을 배포하고 관리할 수 있게 해줍니다. 이를 통해 루트 없이 안드로이드 측의 권한 상승된 실행을 제공하면서도 Linux 환경 내부에서 안드로이드 시스템과 직접 통합을 유지합니다.

기능	AndroSH	일반적인 대안
동시에 여러 배포판	예	보통 하나의 배포판만
환경 관리	SQLite + CLI	수동 파일 처리
안드로이드 시스템 통합	ADB/Shizuku 실행	솔루션마다 다름
여러 개의 격리된 인스턴스	예	단일 인스턴스
루트 필요	아니오 (ADB/Shizuku)	종종 부트로더 언락 필요

스크린샷

명령어	미리보기	보여주는 내용
`androsh launch kali`	보기	Kali NetHunter 환경 실행
`androsh list`	보기	사용 가능한 모든 배포판
`androsh lsd`	보기	이미 설치한 환경

아키텍처

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

어떤 배포판 내부에서든 안드로이드 시스템에 직접 접근할 수 있습니다:

# List installed Android packages
pm list packages -f

# Kernel info
cat /proc/version

# Android system properties
getprop | grep version

# Network routes
ip route show

설치

요구 사항

Shizuku가 설치되어 실행 중인 안드로이드 기기
Python 3.8+
Termux 또는 호환되는 터미널 에뮬레이터
최소 2 GB의 여유 저장 공간

설정

# 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

보안 및 개인정보 보호

안드로이드 권한 경계: 안드로이드 측 작업은 ADB/Shizuku 실행 컨텍스트에서 사용 가능한 권한 내에서 실행되며, 안드로이드 루트는 필요하지 않습니다.
프로세스 격리: 각 환경은 proot를 통해 샌드박스로 실행됩니다
무결성 검사: SHA-256 체크섬으로 모든 다운로드를 검증합니다
텔레메트리 없음: 데이터 수집이 전혀 없으며 모든 것이 기기에 로컬로 유지됩니다
오픈 소스: 모든 구성 요소를 감사할 수 있습니다

구성 요소 및 소스

구성 요소	소스	목적
PRoot	ahmed-alnassif/proot	정적 링크된, 안드로이드 최적화 자동 빌드
BusyBox NDK	Magisk-Modules-Repo/busybox-ndk	안드로이드용 핵심 Unix 유틸리티 (tar, grep, awk 등)

빌드 파이프라인: PRoot builder · BusyBox NDK sources · AndroSH core

모든 의존성은 업스트림 소스로 추적 가능하며 보안 업데이트와 동기화 상태를 유지합니다.

문제 해결

손상된 환경 초기화

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

임시 파일 정리

androsh clean <distro>

전역 androsh 명령어 재설치

cd AndroSH
python main.py install

Shizuku 문제

Shizuku가 실행 중이고 AndroSH가 Shizuku에서 승인되었는지 확인하세요
문제가 지속되면 기기를 재부팅하여 Shizuku 서비스를 복원하세요

기여

모든 종류의 기여를 환영합니다 - 코드, 문서, 버그 보고, 기능 아이디어, 번역, 테스트, 또는 단순한 피드백 공유까지. 오타를 수정하든 새로운 배포판 지원을 추가하든, 모든 기여가 도움이 됩니다.

참여 방법:

코드: 버그 수정, 기능 추가, 성능 개선
문서: README 개선, 가이드 작성, 예제 추가
테스트: 다양한 기기/안드로이드 버전에서 AndroSH를 시험하고 발견한 내용을 보고
버그 보고: 명확한 재현 단계와 함께 이슈를 열어주세요
기능 요청: 지원되었으면 하는 아이디어나 워크플로를 제안하세요
커뮤니티 지원: 이슈/토론에서 질문에 답변해 주세요

너무 작은 기여는 없습니다 - 어디서 시작해야 할지 모르겠다면 이슈를 열고 물어보세요.

개발 환경 설정:

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

GitHub: @ahmed-alnassif

지원

저장소에 스타를 눌러주세요 - 유용하다고 생각되면 다른 사람들이 프로젝트를 발견하는 데 도움이 됩니다
공유해 주세요 - AndroSH가 유용했다면 친구, 커뮤니티, 소셜 미디어에 알려주세요
이슈를 열어주세요 - 버그를 보고해 주세요
토론을 시작해 주세요 - 기능을 제안하거나 질문을 해주세요
사용 사례를 공유해 주세요 - AndroSH를 어떻게 사용하는지 알려주시면 향후 개발 방향을 정하는 데 도움이 됩니다
널리 알려주세요 - 글을 쓰거나, 영상을 만들거나, 안드로이드/Linux 애호가들이 모이는 곳에서 추천해 주세요

크든 작든 모든 지원이 프로젝트의 성장에 도움이 됩니다.

안드로이드 루트 없이, 주머니 속의 전문가용 Linux 환경.

AndroSH v26.08.23

카테고리