一条命令在 Docker 容器里跑起 Android 模拟器从本地启动到 CI 集成【免费下载链接】docker-androidAndroid in docker solution with noVNC supported, video recording and mcp server项目地址: https://gitcode.com/GitHub_Trending/do/docker-android想在 Docker 容器里运行 Android 模拟器做自动化测试吗Docker-Android 把完整的 Android 模拟器环境打包成容器镜像内置 noVNC 可视化、视频录制与 MCP server一条docker run命令就能拉起三星、Nexus 等机型的模拟器并支持 KVM 硬件加速。二、启动之前30 秒自检你的环境容器化的模拟器能否流畅运行取决于宿主机是否具备 KVM 硬件虚拟化。花 30 秒过一遍下面这份清单后面能少走很多弯路 ️检查项一条命令通过标准Docker 已安装docker --version输出版本号KVM 硬件虚拟化已启用sudo apt install cpu-checker kvm-ok提示可使用 KVM 加速KVM 模块已加载lsmod \| grep kvm出现kvm相关模块当前用户有 KVM 权限groups \| grep kvm用户在kvm组内提示macOS 和 Windows 用户无法直接运行该镜像需要先装一个支持虚拟化的 Ubuntu 虚拟机。三、一条命令启动 Android 11 容器环境就绪后启动一个三星 Galaxy S10 的 Android 11 模拟器只需要这一条命令docker run -d -p 6080:6080 \ -e EMULATOR_DEVICESamsung Galaxy S10 \ -e WEB_VNCtrue \ --device /dev/kvm \ --name android-container \ budtmo/docker-android:emulator_11.0关键点拆开看--device /dev/kvm把宿主机的 KVM 设备透传进容器模拟器才跑得快-e EMULATOR_DEVICE指定设备画像可选机型涵盖 Samsung Galaxy S6~S10、Nexus 4/5/7、Pixel C 等-e WEB_VNCtrue开启 Web 界面随时看容器里的屏幕启动后做两件事浏览器打开http://localhost:6080即可实时查看容器内模拟器的界面用下面的命令确认模拟器是否就绪docker exec -it android-container cat device_status镜像版本从 Android 9 到 14 都有对应 tag如emulator_11.0按需选择即可。四、容器里能干什么三个真实场景场景一Appium 自动化测试在容器内直接内嵌了 Appium 服务只需多开一个端口、多传一个环境变量测试框架就能对着模拟器跑用例docker run -d -p 6080:6080 -p 4723:4723 \ -e EMULATOR_DEVICESamsung Galaxy S10 \ -e WEB_VNCtrue -e APPIUMtrue \ --device /dev/kvm --name android-container \ budtmo/docker-android:emulator_11.0测试过程中想肉眼看模拟器在干什么通过 noVNC6080 端口打开网页即可Appium 服务需要额外参数时用APPIUM_ADDITIONAL_ARGS环境变量透传。详见 Appium 用例文档。场景二模拟短信验证应用的短信处理逻辑很多 App 依赖验证码短信做登录验证没有真机也能测。一条adb emu命令就能给容器内的模拟器发一条短信docker exec -it android-container adb emu sms send 12345678 测试消息发送后在 Web 界面里就能看到短信落在系统消息应用中完整流程见 SMS 模拟文档场景三接入 CI/CD 与云端部署模拟器的身体在容器里神经却可以伸到外面。只需在docker run时多映射 5554/5555 两个端口宿主机上的 ADB 就能像操作本地设备一样操作容器内的模拟器adb connect 容器IP:5555这样 Jenkins 流水线里就能直接编排启动容器 → adb 连入 → 执行测试 → 销毁容器的完整闭环见 Jenkins 集成文档。同样的玩法也适用于 AWS、Azure、GCP 等云平台按需弹性伸缩 Android 测试环境方案见 云端部署文档五、让模拟器数据活过容器重启默认行为是容器销毁数据陪葬重启容器后装过的 App、登录的状态全部清零。想让数据活下来挂载一个卷到/home/androidusr即可docker run -v android_data:/home/androidusr budtmo/docker-android:emulator_11.0从此容器怎么重启、重建设备数据都原样保留测试环境的状态可以长期积累。六、调优与排障速查现象容器起不来提示 KVM 不可用排查lsmod | grep kvm看模块、kvm-ok看硬件支持解法内核未加载kvm模块时先加载用户不在kvm组时执行sudo usermod -a -G kvm $USER后重新登录会话现象外部 ADB 连不进容器里的模拟器排查确认启动时是否映射了-p 5554:5554 -p 5555:5555解法补上端口映射重启容器再执行adb connect 容器IP:5555参考 远程控制文档现象模拟器卡顿、资源占用高排查看当前EMULATOR_DEVICE选的是什么画像、容器分到多少内存解法换成 Nexus 5 这类轻量机型画像用--cpus、-m限制资源不需要显示画面时可了解无头模式Pro 版特性现象想改设备名、数据分区大小、Appium 参数排查查环境变量支持列表解法EMULATOR_NAME改模拟器名EMULATOR_DATA_PARTITION调数据分区APPIUM_ADDITIONAL_ARGS传 Appium 参数完整清单见 自定义配置文档七、把 Android 测试环境变成即插即用Docker-Android 的核心价值一句话一条docker run换来一台带 KVM 加速、可随时远程操控的 Android 模拟器本地、CI、云端三处环境完全一致。如果本文对你有帮助可以直接把项目拉到本地体验git clone https://gitcode.com/GitHub_Trending/do/docker-android现在就挑一台机型跑通你的第一条命令吧 【免费下载链接】docker-androidAndroid in docker solution with noVNC supported, video recording and mcp server项目地址: https://gitcode.com/GitHub_Trending/do/docker-android创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考