budtmo/docker-android

어떤 프로젝트인가요?

핵심 기능

• 01Docker 컨테이너 안에서 Android 9.0부터 14.0까지의 에뮬레이터를 실행합니다.
• 02noVNC 또는 VNC를 통해 브라우저에서 에뮬레이터를 확인할 수 있습니다.
• 03여러 휴대전화 및 태블릿 기기 프로필과 스킨을 제공합니다.
• 04adb connect를 통해 컨테이너 외부에서 에뮬레이터를 제어할 수 있습니다.
• 05Ollama 및 vLLM을 위한 실험적인 HTTP MCP 서버와 AI 에이전트 모드를 제공합니다.
• 06Genymotion 및 AWS, Azure, GCP 같은 클라우드 제공업체와 연동됩니다.

활용 사례

• CI에서 Android 에뮬레이터를 대상으로 Appium, Espresso 또는 기타 UI 테스트를 실행합니다.
• 데스크톱 IDE 없이 Linux 서버에서 Android 프로젝트를 빌드합니다.
• AI 에이전트나 MCP 클라이언트에 제어 가능한 Android 기기를 제공합니다.
• 클라우드 VM에 공유 에뮬레이터 팜을 배포합니다.

빠른 시작

1. 1

   호스트 OS가 Ubuntu인지 확인하거나 macOS 또는 Windows에서 Ubuntu VM을 사용하세요

2. 2

   Docker-Android 컨테이너를 실행하세요

   docker run -d -p 6080:6080 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container budtmo/docker-android:emulator_11.0
3. 3

   브라우저에서 http://localhost:6080 을 열어 에뮬레이터를 확인하세요

4. 4

   에뮬레이터 상태를 확인하세요

   docker exec -it android-container cat device_status

사용 전 알아둘 점

• !이미지는 Ubuntu에서만 실행되므로 macOS 및 Windows 사용자는 Ubuntu 가상 머신이 필요합니다.
• !하드웨어 가상화 지원과 /dev/kvm 액세스가 필요합니다.
• !README에는 명확한 오픈소스 라이선스가 명시되어 있지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

docker-android은(는) 무엇인가요?

noVNC로 확인할 수 있고 동영상 녹화, MCP 서버 및 AI 에이전트를 지원하는 컨테이너용 Android 에뮬레이터 Docker 이미지입니다. Docker-Android는 Android 에뮬레이터를 Docker 이미지로 패키징해 로컬에 Android Studio를 설치하지 않고도 Linux 호스트에서 실행할 수 있게 합니다. noVNC 또는 VNC를 통해 브라우저에서 에뮬레이터를 확인할 수 있으며, 컨테이너는 로그를 볼 수 있는 웹 UI도 제공합니다. 네이티브, 웹 및 하이브리드 앱의 개발과 테스트를 위한 프로젝트입니다.

docker-android은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

docker-android은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

docker-android은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. docker-android의 마지막 커밋은 2026년 10월 23일입니다.

docker-android은(는) 어디에 사용할 수 있나요?

CI에서 Android 에뮬레이터를 대상으로 Appium, Espresso 또는 기타 UI 테스트를 실행합니다. 데스크톱 IDE 없이 Linux 서버에서 Android 프로젝트를 빌드합니다. AI 에이전트나 MCP 클라이언트에 제어 가능한 Android 기기를 제공합니다. 클라우드 VM에 공유 에뮬레이터 팜을 배포합니다.

docker-android는 어떻게 설치하나요?

호스트 OS가 Ubuntu인지 확인하거나 macOS 또는 Windows에서 Ubuntu VM을 사용하세요 Docker-Android 컨테이너를 실행하세요: docker run -d -p 6080:6080 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container budtmo/docker-android:emulator_11.0 브라우저에서 http://localhost:6080 을 열어 에뮬레이터를 확인하세요 에뮬레이터 상태를 확인하세요: docker exec -it android-container cat device_status

docker-android은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/budtmo/docker-android