Docker 运行 Android 模拟器是最轻量可复现的测试方案，依赖 budtmo/docker-android 镜像与 KVM 加速，需开启 CPU 虚拟化、安装 Docker 并配置权限，通过环境变量可快速启用 Web 界面、Appium、数据持久化及多设备并行。
直接用 Docker 运行 Android 模拟器是目前最轻量、可复现的测试环境方案之一。核心在于利用 docker-android 镜像，它已预装 Android 系统、ADB、VNC 服务和可选的 Appium，无需手动配 SDK 或 AVD。
确认硬件与基础环境
容器内运行 Android 模拟器依赖 KVM 加速，必须开启 CPU 虚拟化支持：
- Ubuntu/Debian 系统执行：
sudo apt install cpu-checker && kvm-ok，输出KVM acceleration can be used表示正常 - 如提示未启用，请进入 BIOS 开启 Intel VT-x 或 AMD-V，并确保 Linux 内核加载
kvm_intel或kvm_amd模块 - Docker 必须已安装且用户在
docker用户组中，避免每次加sudo
一键拉起带 Web 界面的模拟器
以 Android 11（API 30）+ Galaxy S10 为例，执行以下命令即可启动：
docker run -d \ -p 6080:6080 \ -e EMULATOR_DEVICE="Samsung Galaxy S10" \ -e WEB_VNC=true \ --device /dev/kvm \ --name android-s10 \ budtmo/docker-android:emulator_11.0
完成后打开浏览器访问 http://localhost:6080，就能看到完整 Android 桌面。首次启动可能需 1–2 分钟，后续重启秒级响应。
按需启用高级功能
根据使用场景，通过环境变量快速扩展能力：
- 接入自动化测试：加
-p 4723:4723 -e APPIUM=true，Appium 服务自动就绪，可直连http://localhost:4723/wd/hub - 持久化数据：加
-v android-data:/root，避免容器重启后 App 数据、设置丢失 - 多设备并行：改用不同端口和名称，例如再起一个 S7 容器映射到
6081，互不干扰 - 调试更方便：加
-p 5555:5555 -e ADB=true，主机可直接adb connect localhost:5555
常见问题与应对
遇到白屏、卡顿或连接失败时，优先检查这几项：
- 端口被占用？用
lsof -i :6080查看并释放 - 镜像拉取失败？尝试指定国内加速源，或换用更轻量的
emulator_9.0（Android 9）镜像 - 界面无响应？确认宿主机内存 ≥ 4GB，KVM 设备权限正常（
ls -l /dev/kvm应显示可读写） - 想换设备但不知型号？所有支持列表见项目
mixins/configs/devices/profiles/目录，如nexus_5、pixel_3
