Docker-Android：集成 noVNC、MCP Server 与本地 AI Agent 的容器化安卓方案

Docker-Android 是一款专为安卓生态相关任务构建的 Docker 镜像。它可用于应用程序的开发与测试（包括原生 Native、Web 以及混合 Hybrid 应用）。

赞助商

Proxy-Seller 可为各种工作流提供可靠的代理基础设施：独享住宅代理、移动代理（4G/5G/LTE）、ISP 代理以及数据中心 IPv4/IPv6 代理，全线支持 HTTP(S) 和 SOCKS5 协议。可调取遍布 220 多个地区的 4700 万+ 住宅 IP，精准定位至国家、城市或 ISP，并享有 99.7% 的正常运行时间保障及 24/7 全天候支持。使用优惠码 BUDTMO 即可享受 15% 折扣。

本项目的优势

1. 提供多种设备配置文件和外观皮肤的模拟器，例如三星 Galaxy S6、LG Nexus 4、HTC Nexus One 等。
2. 支持 VNC，可直观查看 Docker 容器内的运行情况。
3. 支持日志共享功能，所有日志均可通过 Web 界面访问。
4. 支持通过外部 adb connect 直接控制容器内的模拟器。
5. 与其他云方案集成，例如 Genymotion Cloud。
6. 可用于构建安卓项目。
7. 可配合 Appium、Espresso 等不同测试框架运行单元测试和 UI 测试。
8. 支持（HTTP）MCP-Server（测试版）。
9. 支持 AI-Agent（测试版）——目前支持的本地大语言模型（LLM）服务端包括：Ollama、VLLM。

• | - | budtmo/docker-android:genymotion | budtmo/docker-android:genymotion_<release_version>
• | - | budtmo/docker-android:mcp | budtmo/docker-android:mcp_<release_version>

1. 系统中需已安装 Docker。

2. 如果主机使用的是 Ubuntu 操作系统，可以直接跳过此步。对于 OSX 和 Windows 操作系统 用户，需要使用支持虚拟化的虚拟机安装 Ubuntu 系统运行，因为该镜像仅支持在 Ubuntu 系统下运行。

3. 机器需支持硬件虚拟化。检查虚拟化是否已启用的命令如下：

   sudo apt install cpu-checker
   kvm-ok
   

4. 运行 Docker-Android 容器：

   docker run -d -p 6080:6080 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container budtmo/docker-android:emulator_11.0
   

5. 打开 http://localhost:6080 查看正在运行的容器内部界面。

6. 检查模拟器状态：

   docker exec -it android-container cat device_status
   

容器默认会在重启时销毁模拟设备。如果需要持久化数据，需要将卷挂载到 /home/androidusr：docker run -v data:/home/androidusr budtmo/docker-android:emulator_11.0

WSL2 硬件加速（仅限 Windows 11）

鸣谢 Guillaume - The Parallel Interface 博客

微软官方文档 - WSL 中的高级设置配置

1. 将当前用户添加到 kvm 用户组：

   sudo usermod -a -G kvm ${USER}
   

2. 在 /etc/wsl.conf 对应小节下添加必要标识：

   [boot]
   command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'
   

接下来，使用 PowerShell 通过记事本打开配置文件：notepad $env:USERPROFILE\.wslconfig。在文件中填入以下配置标识：

     [wsl2]
     nestedVirtualization=true

3. 通过 CMD 命令提示符或 PowerShell 重启 WSL2

command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm' 会在 WSL2 启动时将 /dev/kvm 归属于 kvm 用户组，而非默认的 root 用户组。

nestedVirtualization（嵌套虚拟化）标识仅在 Windows 11 上可用。

如果此配置不起作用，说明当前 WSL 版本较旧。此时可忽略 \.wslconfig，将所有配置直接填入 /etc/wsl.conf 中，包括 [wsl2] 标识小节。

使用场景与文档

1. 构建安卓项目
2. 使用 Appium 进行 UI 测试
3. 在宿主机上控制安卓模拟器
4. 短信模拟
5. Jenkins 集成
6. 部署至云端（Azure、AWS、GCP）

这份配置文件文档包含了用于开启特定功能（如日志共享等）的详细配置说明。

如果缺乏维护模拟器的资源、无预算采购机器，或需要不同设备配置文件，可以尝试使用 Genymotion SAAS。Docker-Android 已在多个云平台上与 Genymotion 实现集成，包括 Genymotion SAAS、AWS、GCP、阿里云等。详情请参考此文档。

模拟器外观皮肤提取自 Android Studio IDE 和 Samsung Developer Website。

Docker-Android-Pro

由于技术支持求助量极大，为了能够持续积极地维护本项目，作者推出了 docker-android-pro。Docker-Android-Pro 是一个基于赞助的项目，只有活跃赞助者才能拉取 Pro 版本的 Docker 镜像。

标准版与 Pro 版本的差异如下：

Pro 版本镜像列表：

• | - | AI-Agent | budtmo2/docker-android-pro:agent | budtmo2/docker-android-pro:agent_<release_version>
• | - | Selenium | budtmo2/docker-android-pro:selenium | budtmo2/docker-android-pro:selenium_<release_version>

有关如何使用 docker-android-pro 的详细说明，请参阅此文档。

详见许可证（License）

Docker-Android is a docker image built to be used for everything related to Android. It can be used for Application development and testing (native, web and hybrid-app).

Sponsors

Proxy-Seller gives you reliable proxy infrastructure for any workflow: private residential, mobile (4G/5G/LTE), ISP, and datacenter IPv4/IPv6 proxies, all with HTTP(S) and SOCKS5 support. Tap into 47M+ residential IPs across 220+ locations, target exactly the country, city, or ISP you need, and count on 99.7% uptime backed by 24/7 support. Get 15% off with promo code BUDTMO.

Advantages of using this project

1. Emulator with different device profile and skins, such as Samsung Galaxy S6, LG Nexus 4, HTC Nexus One and more.
2. Support vnc to be able to see what happen inside docker container
3. Support log sharing feature where all logs can be accessed from web-UI
4. Ability to control emulator from outside container by using adb connect
5. Integrated with other cloud solutions, e.g. Genymotion Cloud
6. It can be used to build Android project
7. It can be used to run unit and UI-Test with different test-frameworks, e.g. Appium, Espresso, etc.
8. It support (http) MCP-Server (beta-version)
9. It support AI-Agent (beta-version) - supported local-LLM server: Ollama, VLLM

• | - | budtmo/docker-android:genymotion | budtmo/docker-android:genymotion_<release_version>

• | - | budtmo/docker-android:mcp | budtmo/docker-android:mcp_<release_version>
  Type | Device Name
  ---|---
  Phone | Samsung Galaxy S10
  Phone | Samsung Galaxy S9
  Phone | Samsung Galaxy S8
  Phone | Samsung Galaxy S7 Edge
  Phone | Samsung Galaxy S7
  Phone | Samsung Galaxy S6
  Phone | Nexus 4
  Phone | Nexus 5
  Phone | Nexus One
  Phone | Nexus S
  Tablet | Nexus 7
  Tablet | Pixel C

  1. Docker is installed on your system.

  2. If you use Ubuntu OS on your host machine, you can skip this step. For OSX and Windows OS user, you need to use Virtual Machine that support Virtualization with Ubuntu OS because the image can be run under Ubuntu OS only.

  3. Your machine should support virtualization. To check if the virtualization is enabled is:

     sudo apt install cpu-checker
     kvm-ok
     

  4. Run Docker-Android container

     docker run -d -p 6080:6080 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container budtmo/docker-android:emulator_11.0
     

  5. Open http://localhost:6080 to see inside running container.

  6. To check the status of the emulator

     docker exec -it android-container cat device_status
     

The default behaviour is to destroy the emulated device on container restart. To persist data, you need to mount a volume at /home/androidusr: docker run -v data:/home/androidusr budtmo/docker-android:emulator_11.0

WSL2 Hardware acceleration (Windows 11 only)

Credit goes to Guillaume - The Parallel Interface blog

Microsoft - Advanced settings configuration in WSL

1. Add yourself to the kvm usergroup.

   sudo usermod -a -G kvm ${USER}
   

2. Add necessary flags to /etc/wsl.conf to their respective sections.

   [boot]
   command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'
   

Then, using PowerShell, open a notepad on notepad $env:USERPROFILE\.wslconfig. Inside, put these other flags:

     [wsl2]
     nestedVirtualization=true

3. Restart WSL2 via CMD prompt or Powershell

command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm' sets /dev/kvm to kvm usergroup rather than the default root usergroup on WSL2 startup.

nestedVirtualization flag is only available to Windows 11.

If this setup does not work, you may have an old WSL version. In that case, ignore \.wslconfig and put everything on /etc/wsl.conf, including the [wsl2] flag.

1. Build Android project
2. UI-Test with Appium
3. Control Android emulator on host machine
4. SMS Simulation
5. Jenkins
6. Deploying on cloud (Azure, AWS, GCP)

This document contains information about configurations that can be used to enable some features, e.g. log-sharing, etc.

For you who do not have ressources to maintain the simulator or to buy machines or need different device profiles, you can give a try by using Genymotion SAAS. Docker-Android is integrated with Genymotion on different cloud services, e.g. Genymotion SAAS, AWS, GCP, Alibaba Cloud. Please follow this document for more detail.

The Emulator skins are taken from Android Studio IDE and Samsung Developer Website

Due to high requests for help and to be able to actively maintain the projects, the creator has decided to create docker-android-pro. Docker-Android-Pro is a sponsor based project which mean that the docker image of pro-version can be pulled only by active sponsor.

The differences between normal version and pro version are:

List pro-version images:

• | - | AI-Agent | budtmo2/docker-android-pro:agent | budtmo2/docker-android-pro:agent_<release_version>
• | - | Selenium | budtmo2/docker-android-pro:selenium | budtmo2/docker-android-pro:selenium_<release_version>

This document contains detail information about how to use docker-android-pro.

See License