budtmo/docker-android

这是什么？

核心功能

• 01在 Docker 容器中运行 Android 9.0 至 14.0 的模拟器。
• 02通过 noVNC 或 VNC 在浏览器中查看模拟器画面。
• 03提供多种手机和平板设备配置与外观皮肤。
• 04支持通过 adb connect 从容器外部控制模拟器。
• 05提供处于测试阶段的 HTTP MCP 服务和对接 Ollama、vLLM 的 AI Agent 模式。
• 06可与 Genymotion 以及 AWS、Azure、GCP 等云服务集成。

适用场景

• 在 CI 中对 Android 模拟器运行 Appium、Espresso 等 UI 测试。
• 在没有桌面 IDE 的 Linux 服务器上构建 Android 项目。
• 让 AI Agent 或 MCP 客户端控制一台 Android 设备。
• 在云主机上部署共享的模拟器集群。

快速上手

1. 1

   确认宿主机为 Ubuntu，或在 macOS/Windows 上使用 Ubuntu 虚拟机

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 是什么？

在 Docker 容器中运行 Android 模拟器的镜像，支持 noVNC 查看、视频录制、MCP 服务和 AI Agent。 Docker-Android 把 Android 模拟器打包成 Docker 镜像，可以在 Linux 主机上直接运行，无需在本机安装 Android Studio。用户可以通过 noVNC 或 VNC 在浏览器中观察模拟器画面，容器还提供带日志的 Web 界面。它面向原生、Web 和混合应用的开发与测试。

docker-android 可以免费使用吗？用的什么许可证？

docker-android 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

docker-android 还在维护吗？

活跃维护中。docker-android 最近一次提交是在 2026年10月23日。

docker-android 适合用来做什么？

在 CI 中对 Android 模拟器运行 Appium、Espresso 等 UI 测试。 在没有桌面 IDE 的 Linux 服务器上构建 Android 项目。 让 AI Agent 或 MCP 客户端控制一台 Android 设备。 在云主机上部署共享的模拟器集群。

docker-android 怎么安装和运行？

确认宿主机为 Ubuntu，或在 macOS/Windows 上使用 Ubuntu 虚拟机 运行 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