제공 기능

• Podman, Docker, LXC - 사전 설치되어 부팅 즉시 사용 가능
• 진짜 VM - QEMU를 통한 커스텀 커널의 Alpine Linux, 또는 지원되는 pKVM 기기에서 하드웨어 가속 AVF
• 앱 내 터미널 - 완전한 xterm-256color, 122가지 색상 테마, 13가지 글꼴, 실시간 크기 조정
• X11 데스크톱 - 터치, 키보드, 마우스, 오디오를 지원하는 내장 뷰어에서 GUI Linux 앱 실행
• USB 패스스루, SSH, 포트 포워딩 및 게스트-Android 브리지
• 컨테이너 백업, 실시간 VM/기기 상태 보기, 게스트와의 Downloads 폴더 공유
• 영어 및 中文, 루트 불필요, 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

# read this documentation with no network connection
podroid-forward add 9980 9980 tcp     # forward the docs port to the phone
podroid-docs                          # serves docs/guide at http://127.0.0.1:9980

설정, 두 가지 백엔드, 네트워킹, 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 버전, 간단한 재현 절차, 진단 로그(앱의 Settings → Export Diagnostic Log)를 포함하여 이슈를 열어 주세요.

관련 프로젝트

**RikkaHub Agent**는 네이티브 Android LLM 채팅 클라이언트인 RikkaHub의 포크로, 이를 실제 온디바이스 에이전트로 탈바꿈시킵니다: 80개 이상의 기기 도구, 예약 작업, AI 기반 브라우저, Linux 워크스페이스, SSH, 화면 자동화, 원격 Telegram 봇이 모두 선택적으로 활성화됩니다. 이 프로젝트의 SSH 도구는 실행 중인 Podroid VM(localhost:9922)에 로그인할 수 있어, 휴대폰의 에이전트가 명령을 직접 입력하지 않고도 컨테이너를 빌드하고 실행하고 검사할 수 있습니다.

크레딧

QEMU	머신 에뮬레이션
Termux	터미널 에뮬레이터 엔진
Alpine Linux	게스트 배포판

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

라이선스

GPLv2. Podroid가 유용하다면 스타를 눌러 다른 사람들이 이 프로젝트를 찾을 수 있도록 도와주세요.