docker-android

一条命令把安卓模拟器装进 Docker，浏览器直接操作

docker-android 是一个把 Android 模拟器完整封装进 Docker 容器的开源方案，解决在 CI/CD、云端或本地无头服务器上运行 Android 应用测试与环境搭建困难的问题。它内置 noVNC，可通过浏览器直接查看和操作模拟器界面，还支持视频录制，方便留存测试过程证据。项目提供 MCP Server 与 AI-Agent 能力，让自动化脚本或智能体能够像人一样点击、输入、截图并驱动 Android 设备，适用于移动端自动化测试、爬虫、RPA 和 AI 操作手机等场景。基于 Python 与 FastAPI 实现，兼容 Genymotion、AWS、Azure、GCP、Kubernetes、Jenkins 等环境，一条 docker run 命令即可启动，大幅降低模拟器部署与运维成本。

开源 free 自动化工作流
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 15877
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类自动化工作流
开发团队budtmo
所属国家
官网地址
GitHubhttps://github.com/budtmo/docker-android
定价模式free
价格说明开源免费，需自行部署
访问状态
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型ai-agent,android,android-emulator,aws,azure,cloud,docker,docker-android,emulator,fastapi,gcp,genymotion,jenkins,kubernetes,mcp,mcp-server,mobile-app,novnc,ollama,selenium
GitHub 星标★ 15877
30天Star增速
HF 下载量
上线时间2016-12-22 00:00:00
最近更新2026-09-21 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-09-22
浏览次数0

使用教程

难度：入门 约 10 分钟 部署方式：Docker 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

  • 已安装 Docker 的运行环境（本地无头服务器、CI/CD 或云主机均可）
  • 浏览器，用于通过内置 VNC 查看和操作容器内模拟器界面
  • 按目标 Android 版本选择对应镜像：9.0/10.0/11.0/12.0

安装与启动步骤

  1. 1确认 Docker 环境

    先确认本机或 CI/云主机上已装好 Docker，docker-android 以 Docker 镜像方式分发。

    docker --version

  2. 2选择镜像版本

    按 README 对照表选：Android 9.0→API 28、10.0→29、11.0→30、12.0→32。

  3. 3拉取镜像

    拉取所选 Android 版本的最新发布版镜像，也可用 _ 指定具体版本。

    docker pull budtmo/docker-android:emulator_12.0

  4. 4按官方说明启动

    本节选未给出 docker run 参数，请到项目 README 的 Usage 部分获取端口与挂载配置。

如何确认成功

容器启动后，通过 VNC 客户端或浏览器能看到模拟器画面、Web-UI 能查看共享日志，即视为成功。

常见问题

Q：README 里没给 docker run 命令怎么办？

A：本节选只提供了镜像列表，完整启动参数（端口、挂载、VNC 等）需查阅项目 README 的 Usage 章节或官方文档，不要自行臆测端口。

Q：应该拉取哪个镜像？

A：按 Android 版本选 tag，如 Android 12.0 对应 budtmo/docker-android:emulator_12.0；需要固定版本可加 _。

Q：能在容器外控制模拟器吗？

A：可以，README 说明支持通过 adb connect 从容器外部控制模拟器。

Q：能跑自动化 UI 测试吗？

A：可以，项目支持 Appium、Espresso 等测试框架运行单元测试与 UI 测试。

Q：AI-Agent 和 MCP 功能可用吗？

A：README 标注 mcp server 与 ai-agent 均为 beta 版本，可让脚本或智能体点击、输入、截图驱动设备。

注意事项

  • 本节选未提供 docker run 示例，启动容器前务必先查官方 README，避免凭空设定端口和参数。
  • 镜像 tag 分为最新发布版与指定 release 版本两种形式。
  • mcp server 与 ai-agent 为 beta 功能，生产使用需自行评估稳定性。

核心亮点

  • 内置 noVNC，浏览器即可实时查看和操作模拟器，无需本地图形界面
  • 支持视频录制，自动化测试过程可回放留证
  • 提供 MCP Server 与 AI-Agent 接口，方便接入大模型驱动手机操作

不足之处

  • 模拟器在容器内运行对宿主 CPU 虚拟化与内存要求较高，资源占用大
  • 不同 Android 版本与架构的镜像维护成本高，部分组合可能不稳定

适用场景

  • CI/CD 流水线中自动跑 Android UI 测试
  • 云端无头服务器上做移动端爬虫或 RPA
  • AI Agent 通过 MCP 远程操作真实 Android 应用

替代项目

Genymotion、Android Emulator Container Scripts

项目介绍

docker-android 是自动化工作流领域的开源项目，由 budtmo 开发，2016 年首次发布。

在全站 12,909 个收录项目中，它的 GitHub 星标数（15,877）位列前 3%，在自动化工作流分类的 499 个项目里位列前 8%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-21。开源免费，需自行部署。

它主要面向的使用场景是：CI/CD流水线中自动跑AndroidUI测试。同类可对比的替代方案包括 Genymotion、Android Emulator Container Scripts。

上一篇：datasette-agent

下一篇：optio

同类项目推荐

n8n 开源

拖拽搭建自动化流程，轻松接入 AI 与 400+ 应用，搞定重复工作。

Fair-code workflow automation platform with native AI capabilities. Combine visual b···

★ 205363 2026-08-10
feishu-docx 开源

让 AI 代理轻松读写飞书文档，双向转换 Markdown

Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exp···

★ 261 2026-08-09
robotcode 开源

让 Robot Framework 拥有现代 IDE 体验，调试、补全、运行一气呵成。

Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···

★ 300 2026-08-10
puppeteer 开源

用 JavaScript 轻松操控无头浏览器，搞定自动化测试与网页抓取。

JavaScript API for Chrome and Firefox

★ 95591 2026-08-10