docker 中无法直接运行官方 android 模拟器，因其依赖 kvm、gpu 加速和 x11；可行方案有两种：一是用 android-container（android-x86 + qemu + vnc），轻量稳定，适合 ci/cd；二是手动配置官方 emulator 镜像，挂载 /dev/kvm 和 x11 socket，仅限 linux 宿主机。
直接用 Docker 运行标准 Android 模拟器（如官方 Android Emulator）在常规 Linux 容器中不可行，因为模拟器严重依赖 KVM、GPU 加速、X11 显示和 /dev/kvm 设备直通——而这些在默认 Docker 容器里被隔离或缺失。但“可行的替代方案”确实存在：不是硬塞原生 emulator 进容器，而是用专为容器优化的轻量级 Android 运行时，比如 Android-x86 + QEMU + VNC 或更成熟的开源项目 AnLinux / AnLinux-ARM / Genymobile’s scrcpy + headless emulator。下面讲真正能落地、已验证的两种主流实战路径。
方案一：用 android-container（基于 Android-x86 + QEMU）跑轻量 Android 系统
这是目前最稳定、资源占用低、适合 CI/CD 和自动化测试的方案。核心是将 Android-x86 镜像打包为可启动的 QEMU 虚拟机，并通过 VNC 暴露界面，Docker 仅作运行和网络封装。
- 拉取预构建镜像：docker pull budtmo/docker-android-x86-9.0（支持 Android 9，含 adb、VNC server）
- 启动容器并映射关键端口：
docker run -d --privileged -p 6080:6080 -p 5554:5554 -p 5555:5555 -e DEVICE="Samsung Galaxy S6" budtmo/docker-android-x86-9.0 - 访问 http://localhost:6080 即可看到图形化 Android 界面（基于 noVNC）；adb 可连 adb connect localhost:5555
- 注意：必须加 --privileged（启用设备访问），且宿主机需支持 KVM（kvm-ok 命令验证）
方案二：用官方 emulator + Docker（仅限 Linux 宿主机 + 手动配置）
若坚持用 Google 官方 Android Emulator（例如用于兼容性测试），可绕过容器限制，在 Docker 中启动“半容器化”进程：容器提供环境与工具链，但 emulator 实际以 host PID namespace 运行，并挂载宿主机的 /dev/kvm 和 X11 socket。
- 基础镜像需包含：android-sdk、emulator、platform-tools、x11-utils 和 libgl1-mesa-glx
- 启动命令示例（需提前创建 AVD）：
docker run -it --rm --device /dev/kvm --network host -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=host.docker.internal:0 your-emulator-image emulator -avd test_avd -no-audio -no-window -gpu swiftshader_indirect - 关键点：--device /dev/kvm 启用硬件加速；-v /tmp/.X11-unix 共享显示；-gpu swiftshader_indirect 是无 GPU 驱动时的兜底渲染方案
- 不推荐用于 macOS/Windows 宿主 —— Docker Desktop 的 VM 层会二次虚拟化，KVM 不可用，性能极差甚至启动失败
实用技巧与避坑指南
- AVD 创建必须在容器外完成：先在宿主机用 sdkmanager 和 avdmanager 创建好 AVD，再挂载 ~/.android/avd 到容器内
- adb 调试要打通网络：容器内启动的 emulator 默认监听 127.0.0.1:5555，外部 adb 无法直连；建议用 -port 5554 并配合 -tcpdump 或 adb -H host.docker.internal -P 5037 管理
- 内存与 CPU 限制慎用：emulator 对内存敏感，-m 2048 是底线；Docker 的 --memory 若设太小会导致 emulator 直接 OOM crash
- 日志调试优先看 stderr：启动失败时，加上 -logcat *:S -logcat ActivityManager:I 可快速定位黑屏或 bootloop 原因
不复杂但容易忽略：Docker 本身不是虚拟机，它不解决硬件虚拟化问题。所谓“Docker 运行 Android 模拟器”，本质是用容器封装一个能调用宿主机虚拟化能力的 Android 启动环境。选对底层技术栈（QEMU/x86 vs 官方 emulator）、匹配宿主机能力（KVM/Vulkan/X11）、并合理绕过容器限制，才是实战落地的关键。
