Docker-Android 上手指南：一条命令在容器里运行 Android 模拟器

Docker-Android 上手指南一条命令在容器里运行 Android 模拟器【免费下载链接】docker-androidAndroid in docker solution with noVNC supported, video recording and mcp server项目地址: https://gitcode.com/GitHub_Trending/do/docker-androidDocker-Android 是一个把 Android 模拟器装进 Docker 容器的开源项目一条命令即可拉起带 Web 界面的模拟器并提供 ADB 远程控制、日志查看与 Appium 测试能力。它适合移动应用开发者、测试工程师以及需要在 CI 或云端跑 Android 的 DevOps 人员。模拟器不该占满你的开发机本地跑一个 Android 模拟器往往要吃掉好几个核心和几十 GB 内存开发机风扇狂转还经常和 IDE 抢资源。到了 CI 环节更麻烦给流水线节点装 Android SDK、配模拟器、处理无头环境每一步都是坑机器用完还得清理。把模拟器搬进容器之后这三件事同时解决了环境隔离模拟器、设备配置、皮肤都在镜像里销毁容器即回收资源宿主机不留状态按需拉起docker run一条命令启动设备型号通过环境变量指定Galaxy S10、Nexus 5、Nexus 7 等十余种机型开箱即用可观测可控容器内的画面通过 noVNC 暴露到浏览器ADB 端口映射出来后可从宿主机直接adb connect日志也能走 Web 界面查看。一条命令拉起 Android 容器前置条件只有两个宿主机已安装 Docker且支持 KVM 硬件虚拟化可用kvm-ok命令检查。镜像基于 Ubuntu 构建macOS 或 Windows 宿主机需要通过虚拟机跑一个 Ubuntu 环境。最短可运行命令如下拉起的是一台 Android 11 的 Samsung Galaxy S10docker 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 直通时模拟器启动会失败或慢到不可用。打开浏览器访问http://localhost:6080就能看到容器内部画面模拟器是否就绪则查容器内的状态文件docker exec -it android-container cat device_status按场景拆解容器能力用 noVNC 在浏览器查看和操作模拟器 ️容器内 noVNC 服务监听 6080 端口。WEB_VNCtrue启用 Web 界面后可用 URL 参数控制行为?autoconnecttrue自动连上追加view_onlytrue只给只读查看权限passwordxxx则用密码保护。想用本地 VNC 客户端直连则映射 5900 端口并可通过VNC_PASSWORD设置密码端口也可用WEB_VNC_PORT改。从宿主机用 ADB 控制容器里的模拟器启动容器时把 5554、5555 两个端口映射出来-p 5554:5554 -p 5555:5555在宿主机执行adb connect 容器IP:5555连上之后安装 APK、截图、抓日志这些常规 ADB 操作都能对容器内模拟器生效配合仓库里的 模拟器控制用例文档 可以进一步调试。通过 Web 界面读取日志设置WEB_LOGtrue后容器内日志文件会通过一个 Web 界面暴露默认 9000 端口WEB_LOG_PORT可改。排查模拟器启动失败、应用崩溃时不用进容器翻文件浏览器里直接看。在容器内跑 Appium 自动化测试 开启 Appium 只需两个动作映射 4723 端口并传-e APPIUMtruedocker run -d -p 6080:6080 -p 4723:4723 \ -e EMULATOR_DEVICESamsung Galaxy S10 -e WEB_VNCtrue \ -e APPIUMtrue --device /dev/kvm \ budtmo/docker-android:emulator_11.0需要给 Appium Server 追加参数时用APPIUM_ADDITIONAL_ARGS传递容器内的 Appium 2.x 也可以直接接入 Selenium Grid 4.x。细节见 Appium 用例文档。接入 CI 与云端环境镜像本身可以作为构建环境把 Gradle 工程目录挂载进/home/androidusr/tmp用--entrypoint指定./gradlew build即可完成项目构建和单元测试。Jenkins 侧有配套的 VNC 预览插件让流水线界面也能实时看到模拟器画面见 Jenkins 集成文档。部署到云厂商时注意实例必须支持嵌套虚拟化Azure 选 Dv3/Ev3、AWS 用裸金属实例、GCP 开启 Nested Virtualization见 云端部署文档。Android 版本与镜像标签对照镜像按 Android 版本打标签选设备型号由EMULATOR_DEVICE环境变量决定可选机型包括 Galaxy S6/S7/S7 Edge/S8/S9/S10、Nexus One/S/4/5、Nexus 7、Pixel C 等。Android 版本API 级别镜像标签9.028budtmo/docker-android:emulator_9.010.029budtmo/docker-android:emulator_10.011.030budtmo/docker-android:emulator_11.012.032budtmo/docker-android:emulator_12.013.033budtmo/docker-android:emulator_13.014.034budtmo/docker-android:emulator_14.0固定版本时用emulator_11.0_release_version这种带具体发布号的标签便于 CI 环境可复现。进阶配置与容易踩的坑 ⚠️常用的环境变量EMULATOR_NAME改模拟器名称EMULATOR_DATA_PARTITION调数据分区大小默认 550mEMULATOR_NO_SKINtrue去掉设备皮肤省资源EMULATOR_ADDITIONAL_ARGS透传 Android 模拟器原生命令行参数EMULATOR_CONFIG_PATH配合-v挂载可覆盖整个配置文件。完整清单见 自定义配置说明。几个高频坑数据默认不持久化容器一删模拟器数据全丢。要保留在启动时给/home/androidusr挂一个命名卷docker run -v data:/home/androidusr budtmo/docker-android:emulator_11.0忘挂/dev/kvm容器起得来但模拟器起不来报错指向虚拟化时先查这里宿主机系统限制镜像只支持 Ubuntu 环境macOS/Windows 需要先准备 Ubuntu 虚拟机Windows 11 的 WSL2 需要开启nestedVirtualization并把/dev/kvm权限配好。需要代理配置、切换语言、root 权限、headless 无头模式、Selenium 4.x 统一接入或多模拟器共存时可以看赞助商可用的 Docker-Android Pro 版文档这些能力在 Pro 版镜像中提供。下一步如果你经常在 CI 里跑 Android 测试或想给团队一套干净的模拟器环境建议先从emulator_11.0标签 挂载 KVM 开始跑通浏览器查看和 ADB 连接两件事再按场景叠加 Appium、日志、持久化卷。【免费下载链接】docker-androidAndroid in docker solution with noVNC supported, video recording and mcp server项目地址: https://gitcode.com/GitHub_Trending/do/docker-android创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考