
docker-android
一条命令把安卓模拟器装进 Docker,浏览器直接操作
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 16095
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 已安装 Docker 的运行环境(本地无头服务器、CI/CD 或云主机均可)
- 浏览器,用于通过内置 VNC 查看和操作容器内模拟器界面
- 按目标 Android 版本选择对应镜像:9.0/10.0/11.0/12.0
安装与启动步骤
-
1确认 Docker 环境
先确认本机或 CI/云主机上已装好 Docker,docker-android 以 Docker 镜像方式分发。
docker --version -
2选择镜像版本
按 README 对照表选:Android 9.0→API 28、10.0→29、11.0→30、12.0→32。
-
3拉取镜像
拉取所选 Android 版本的最新发布版镜像,也可用 _<release_version> 指定具体版本。
docker pull budtmo/docker-android:emulator_12.0 -
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 —···
job-application-agent
开源
让 AI 帮你投简历,事实不编造、密码不泄露、提交前你点头
JobAppAgent: open-source AI job application agent (Agent Skill + CLI). Searches wide···
Browser4
开源
让 AI 智能体自己开浏览器,自动抓数据、跑流程
Browser4 — an AI-native browser engine for autonomous agents, intelligent extractio···
ai-auto-work
开源
让 AI 自动跑完需求到开发评审,搞定中大型项目
Automatically completes the full workflow from requirement research → research revi···
livecontext-ce
开源
用聊天描述任务,自动生成可用的 AI 工作流和代理。
The AI automation platform, self-hosted. Describe the job in chat and LiveContext bu···
agent-tui
开源
让 AI 代理像人一样操作任何终端程序
TUI automation for AI agents. Control any terminal app from code.
pi-warden
开源
给 Pi 代理加护栏,写文件守规则,假完成和死循环当场抓出
Guardrails for Pi that steer instead of interrupt: enforces your project rules on ev···
BrowserSkill
开源
让 AI 直接操作你已登录的真实浏览器,不打断当前工作
Let AI agents use your real, logged-in browser without interrupting your work. CLI +···
ff-ruyijs
开源
用 Python 直接跑真实 Firefox 引擎执行网页 JS
This is a lightweight, headless browser purpose-built for AI agents (such as Codex o···