docker-android

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 1785 🐛 待处理 159 👀 关注 183
GitHub ↗
GitHub 星标 ★ 16095
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行部署

项目预览

docker-android 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队budtmo
定价模式🏷️完全免费
价格说明开源免费,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型ai-agent,android,android-emulator,aws,azure,cloud,docker,docker-android,emulator,gcp,genymotion,jenkins,kubernetes,mcp,mcp-server,mobile-app,novnc,ollama,selenium,vllm
GitHub 星标★ 16095
上线时间2016-12-22 00:00:00
代码更新2026-11-05
仓库体积238.3 MB
本站数据更新2026-11-06
维护状态活跃
收录时间2026-09-22
浏览次数1

项目介绍

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 命令即可启动,大幅降低模拟器部署与运维成本。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 16095

技术标签

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:入门 约 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 版本的最新发布版镜像,也可用 _<release_version> 指定具体版本。

    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;需要固定版本可加 _<release_version>。

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

上一篇:datasette-agent

下一篇:optio

同类项目推荐

dsh-ios 开源

让 AI 代理在对话里直接开模拟器、点 iPhone 验证界面

DeepSeek Harness (DSH) plugin: a live iOS Simulator — and a USB-connected iPhone —···

★ 360 2026-09-29
job-application-agent 开源

让 AI 帮你投简历,事实不编造、密码不泄露、提交前你点头

JobAppAgent: open-source AI job application agent (Agent Skill + CLI). Searches wide···

★ 173 2026-09-15
Browser4 开源

让 AI 智能体自己开浏览器,自动抓数据、跑流程

Browser4 — an AI-native browser engine for autonomous agents, intelligent extractio···

★ 1176 2026-10-08
ai-auto-work 开源

让 AI 自动跑完需求到开发评审,搞定中大型项目

Automatically completes the full workflow from requirement research → research revi···

★ 131 2026-08-09
livecontext-ce 开源

用聊天描述任务,自动生成可用的 AI 工作流和代理。

The AI automation platform, self-hosted. Describe the job in chat and LiveContext bu···

★ 782 2026-08-09
agent-tui 开源

让 AI 代理像人一样操作任何终端程序

TUI automation for AI agents. Control any terminal app from code.

★ 121 2026-08-09
pi-warden 开源

给 Pi 代理加护栏,写文件守规则,假完成和死循环当场抓出

Guardrails for Pi that steer instead of interrupt: enforces your project rules on ev···

★ 177 2026-09-26
BrowserSkill 开源

让 AI 直接操作你已登录的真实浏览器,不打断当前工作

Let AI agents use your real, logged-in browser without interrupting your work. CLI +···

★ 10119 2026-09-12
ff-ruyijs 开源

用 Python 直接跑真实 Firefox 引擎执行网页 JS

This is a lightweight, headless browser purpose-built for AI agents (such as Codex o···

★ 861 2026-11-05