Podroid

안드로이드 폰에서 Linux 컨테이너와 완전한 Linux 데스크탑을 실행하세요. 루트가 필요 없습니다.

자체 커널을 가진 실제 Alpine Linux VM – chroot나 proot 트릭이 아닙니다. 따라서 Podman, Docker 및 LXC가 서버에서와 똑같이 동작합니다.

Android 8+

웹사이트 · 문서 · APK 다운로드

제공되는 기능

Podman, Docker 및 LXC – 부팅과 동시에 바로 사용할 수 있도록 사전 설치됨
실제 VM – QEMU를 통한 커스텀 커널 기반 Alpine Linux, 또는 지원되는 pKVM 기기에서 하드웨어 가속 AVF
앱 내 터미널 – 완전한 xterm-256color, 122가지 컬러 테마, 13가지 글꼴, 실시간 크기 조절
X11 데스크탑 – 터치, 키보드, 마우스, 오디오 지원과 함께 내장 뷰어에서 Linux GUI 앱 실행
USB 패스스루, SSH, 포트 포워딩 및 게스트-안드로이드 브리지
컨테이너 백업, VM/기기 상태 실시간 보기 및 게스트와 다운로드 폴더 공유
영어 및 中文, 루트 불필요, Android 8+ 이상의 모든 arm64 기기

빠른 시작

APK를 다운로드하여 설치합니다.
Start VM을 누르고 Ready! 가 나타날 때까지 기다린 후 터미널을 엽니다.

# rootless 컨테이너, 바로 사용 가능
podman run --rm alpine echo "hello from a container"
docker run -d -p 8080:80 nginx

# 해당 컨테이너를 휴대폰과 LAN에 노출, VM 셸에서 바로 실행
podroid-forward add 8080 8080 tcp     # TCP 또는 UDP, QEMU 및 AVF 백엔드 모두 지원
curl http://<phone-ip>:8080

# 노트북에서 SSH 접속 (설정 마법사 또는 설정에서 SSH 활성화)
ssh root@<phone-ip> -p 9922        # 비밀번호: podroid

설정, 두 가지 백엔드, 네트워킹, X11 뷰어 및 문제 해결에 대한 자세한 내용은 문서 에서 확인할 수 있습니다.

빌드

git clone https://github.com/ExTV/Podroid.git
cd Podroid
./build-all.sh all     # 커널, rootfs, QEMU 및 APK (Docker + Android SDK/NDK 필요)

구성 요소별 빌드 및 툴체인 세부 사항: CONTRIBUTING.md

기여하기

모든 규모의 기여를 환영합니다: 버그 리포트, 커널 설정 조정, 새로운 테마, UI 개선, X11 입력 수정 등 무엇이든 좋습니다.

풀 리퀘스트: 먼저 CONTRIBUTING.md를 읽어주세요. 변경 범위를 좁히고, 푸시 전에 ./build-all.sh test를 실행하며, PR 설명에 이유를 명시하세요.
버그 리포트: 이슈를 열어 기기 및 Android 버전, 간단한 재현 단계, 진단 로그(앱 내 설정 → 진단 로그 내보내기)를 함께 제출해주세요.