
New releaseJul 29, 2026
Podroid v1.2.7
루트리스 Android 앱으로 Alpine Linux를 부팅: 컨테이너(Podman/Docker/LXC) 및 GUI 데스크톱 앱을 실행합니다.
Podroid
Android 휴대폰에서 Linux 컨테이너와 전체 Linux 데스크톱을 실행하세요. 루트 불필요.
자체 커널을 가진 진짜 Alpine Linux VM - chroot나 proot 트릭이 아님 - 따라서 Podman, Docker, LXC가 서버에서처럼 정확히 동작합니다.
![]() 홈 | ![]() 실행 중 | ![]() 터미널 | ![]() 테마 및 글꼴 |
제공 기능
- Podman, Docker, LXC - 부팅 즉시 사용할 수 있도록 사전 설치됨
- 진짜 VM - QEMU를 통한 커스텀 커널의 Alpine Linux, 또는 지원되는 pKVM 기기에서는 하드웨어 가속 AVF
- 앱 내장 터미널 - 완전한 xterm-256color, 122가지 컬러 테마, 13가지 글꼴, 실시간 크기 조절
- X11 데스크톱 - 내장 뷰어에서 터치, 키보드, 마우스, 오디오와 함께 GUI Linux 앱 실행
- USB 패스스루, SSH, 포트 포워딩 및 게스트-Android 브리지
- 컨테이너 백업, 실시간 VM/기기 상태 보기, 게스트와의 다운로드 폴더 공유
- 영어 및 中文, 루트 불필요, Android 8+의 모든 arm64 기기
빠른 시작
- APK를 다운로드하여 설치합니다.
- Start VM을 누르고 **Ready!**가 표시될 때까지 기다린 다음 터미널을 엽니다.
# rootless containers, straight away
podman run --rm alpine echo "hello from a container"
docker run -d -p 8080:80 nginx
# expose that container to your phone and LAN, right from the VM shell
podroid-forward add 8080 8080 tcp # TCP or UDP, on both the QEMU and AVF backends
curl http://<phone-ip>:8080
podroid-forward clean # remove every rule you added, in one go
# SSH in from your laptop (enable SSH in the setup wizard or Settings)
ssh root@<phone-ip> -p 9922 # password: podroid
설정, 두 백엔드, 네트워킹, X11 뷰어, 문제 해결에 대한 모든 내용은 **문서**에 있습니다.
빌드
git clone https://github.com/ExTV/Podroid.git
cd Podroid
./build-all.sh all # kernel, rootfs, QEMU and APK (needs Docker + Android SDK/NDK)
구성 요소별 빌드 및 툴체인 세부 사항: CONTRIBUTING.md.
기여
버그 리포트, 커널 구성 조정, 새 테마, UI 다듬기, X11 입력 수정 등 모든 규모의 기여를 환영합니다.
- 풀 리퀘스트: 먼저 CONTRIBUTING.md를 읽어 주세요. 변경 범위를 좁게 유지하고, 푸시 전에
./build-all.sh test를 실행한 다음 PR 설명에 이유를 설명해 주세요. - 버그 리포트: 기기와 Android 버전, 간단한 재현 절차, 진단 로그(앱의 설정 → 진단 로그 내보내기)를 포함해 이슈를 열어 주세요.
크레딧
| QEMU | 머신 에뮬레이션 |
| Termux | 터미널 에뮬레이터 엔진 |
| Alpine Linux | 게스트 배포판 |
전체 목록은 CREDITS.md에 있습니다.
라이선스
GPLv2. Podroid가 유용하게 쓰였다면, 스타 하나가 다른 사람들이 이 프로젝트를 찾는 데 도움이 됩니다.



