一、项目介绍

做移动端自动化、APK 测试、或云手机场景时，最麻烦的是“搞一台安卓设备”：真机要采购、要维护，传统模拟器吃资源、难编排。CI 里想跑 UI 测试，往往卡在环境搭建。你要的是一台随起随用、能在容器里跑、还能被脚本和 AI 控制的安卓。
docker-android 把 Android 模拟器塞进 Docker 镜像：支持 noVNC 网页访问、视频录制、MCP 服务器与 AI Agent 控制，还能通过 --device /dev/kvm 用上宿主机虚拟化加速。一条 docker run 就能起一台带指定机型（如 Samsung Galaxy S10）的安卓，配合 Web VNC 直接在浏览器里看屏幕、点操作。

二、项目基本信息

信息项详情
项目名称docker-android
GitHub地址https://github.com/budtmo/docker-android
项目描述Android in docker solution with noVNC supported, video recording, mcp server and AI-agent
作者budtmo
开源协议Apache-2.0
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-28

三、核心优势

  • 容器化安卓：docker run 即起一台模拟器
  • 网页可视：noVNC 浏览器内直接看屏操作
  • 可录制：内置视频录制，便于回放与取证
  • AI 可控：带 MCP 服务器，智能体可远程操控
  • 机型可选：通过环境变量指定设备型号

四、适用场景

适合做安卓 UI 自动化、移动测试、云手机或让 AI 智能体操作真机界面的团队：希望用容器快速获得可脚本化、可远程控制的安卓环境。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 起一台带 Web VNC 的安卓（需宿主机支持 KVM）
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

常见报错：依赖缺失时先升级运行环境（Node、Python、Go 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# 浏览器打开 http://localhost:6080 即可看到安卓桌面
# 查看设备状态
docker exec -it android-container cat device_status
# 没有 KVM 的机器先确认：sudo apt install cpu-checker && kvm-ok

七、常见问题

问：必须有 KVM 吗？答：有 KVM 才能跑模拟器加速；无 KVM 的云主机需选支持嵌套虚拟化的规格。问：能录屏吗？答：支持，便于自动化回放与调试。

八、总结

docker-android 用一个清晰的设计，把把通用能力做成可自托管的服务这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。