Podroid

Android 휴대폰에서 Linux 컨테이너와 전체 Linux 데스크톱을 실행하세요. 루트 불필요.

자체 커널을 가진 진짜 Alpine Linux VM - chroot나 proot 트릭이 아님 - 따라서 Podman, Docker, LXC가 서버에서처럼 정확히 동작합니다.

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

제공 기능

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

빠른 시작

1. APK를 다운로드하여 설치합니다.
2. 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 버전, 간단한 재현 절차, 진단 로그(앱의 설정 → 진단 로그 내보내기)를 포함해 이슈를 열어 주세요.

크레딧

전체 목록은 CREDITS.md에 있습니다.

라이선스

GPLv2. Podroid가 유용하게 쓰였다면, 스타 하나가 다른 사람들이 이 프로젝트를 찾는 데 도움이 됩니다.