sickcodes/dock-droid

Dock-Droid

!在Docker容器中运行Android x86和Android ARM

Docker Android - 在Docker中运行QEMU Android x86和Android ARM！支持X11转发！适用于Android的CI/CD！

镜像概述和主要用途

Dock-Droid是一个基于Docker的Android虚拟化解决方案，通过QEMU和KVM技术在容器中运行Android x86系统。该镜像旨在提供便捷的Android运行环境，支持硬件加速、外设转发和多种开发/测试工具集成，适用于安全研究、应用测试、CI/CD流程等场景。

核心功能和特性

• 跨架构安全研究：在x86平台上研究ARM应用
• ADB支持：默认开放5555端口，可通过ADB连接
• 系统增强工具：集成Magisk、riru、LSPosed（Android x86）
• 网络服务：SSH服务（localhost:50922）
• 屏幕控制：SCRCPY支持（localhost:5555）
• 外设转发：摄像头（/dev/video0）、音频（/dev/snd）转发
• GPU加速：支持GPU passthrough（/dev/dri）
• 图形输出：X11转发功能
• 虚拟化技术：基于QEMU + KVM运行，性能接近原生
• 镜像兼容性：支持BlissOS、自定义镜像、VDI文件及任何Android x86镜像
• 容器管理：可通过docker commit克隆容器状态

使用场景和适用范围

• Android安全研究：在隔离环境中分析***应用，测试漏洞利用
• 应用开发测试：跨架构（x86/ARM）应用兼容性测试
• CI/CD集成：自动化Android应用构建、测试流程
• 教学/演示：快速部署标准化Android环境
• 无头服务器运行：在服务器环境中运行Android服务（如通过VNC访问）

使用方法和配置说明

前置要求

• 硬件：至少4GB磁盘空间；BIOS需开启硬件虚拟化（VT-x/AMD-V）
• 软件：支持KVM的主机（非必需，但无KVM时性能较差）

初始设置

1. 开启硬件虚拟化

进入主机BIOS设置，启用硬件虚拟化功能（具体步骤因主板型号而异）。

2. 安装依赖

根据主机系统安装QEMU及相关依赖：

bash
# ARCH
sudo pacman -S qemu libvirt dnsmasq virt-manager bridge-utils flex bison iptables-nft edk2-ovmf

# UBUNTU/DEBIAN
sudo apt install qemu qemu-kvm libvirt-clients libvirt-daemon-system bridge-utils virt-manager

# CENTOS/RHEL/FEDORA
sudo yum install libvirt qemu-kvm

3. 启用服务和加载KVM模块

bash
sudo systemctl enable --now libvirtd
sudo systemctl enable --now virtlogd

echo 1 | sudo tee /sys/module/kvm/parameters/ignore_msrs

sudo modprobe kvm

快速启动

1. 带GUI的BlissOS x86镜像

bash
docker run -it \
    --device /dev/kvm \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -p 5555:5555 \
    sickcodes/dock-droid:latest

2. 无头模式（服务器或本地无GUI环境）

bash
docker run -it \
    --device /dev/kvm \
    -e EXTRA="-display none -vnc 0.0.0.0:99,password=on" \
    -p 5555:5555 \
    -p 5999:5999 \
    sickcodes/dock-droid:latest

VNC连接步骤：
在QEMU控制台输入change vnc password user设置密码，然后通过localhost:5999或服务器IP连接。

3. 无预安装镜像版本（:naked）

适用于自定义镜像：

bash
docker run -it \
    --device /dev/kvm \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -v "${PWD}/android.qcow2:/home/arch/dock-droid/android.qcow2" \
    -p 5555:5555 \
    sickcodes/dock-droid:naked

4. 无KVM模式（实验性）

性能较差，仅用于不支持KVM的环境：

bash
docker run -it \
    -e CPU=Penryn \
    -e ENABLE_KVM=' ' \
    -e KVM=' ' \
    -e CPUID_FLAGS=' ' \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -p 5555:5555 \
    sickcodes/dock-droid:latest

5. 调整内存大小

添加-e RAM=10参数分配10GB内存：

bash
docker run -it \
    --device /dev/kvm \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e RAM=10 \
    -p 5555:5555 \
    sickcodes/dock-droid:latest

高级配置

摄像头转发

USB直通模式

1. 查看摄像头设备信息：

   bash
   lsusb  # 示例输出：Bus 003 Device 003: ID 13d3:56a2 IMC Networks USB2.0 HD UVC WebCam
   

2. 使用hostbus和hostaddr参数转发：

   bash
   docker run -it \
       --device /dev/kvm \
       -v /tmp/.X11-unix:/tmp/.X11-unix \
       -e "DISPLAY=${DISPLAY:-:0.0}" \
       -p 5555:5555 \
       -e EXTRA='-device usb-host,hostbus=3,hostaddr=3' \
       sickcodes/dock-droid:latest
   

网络重定向模式

1. 在主机启动usbredirserver：

   bash
   sudo usbredirserver -p 7700 13d3:56a2  # 13d3:56a2为摄像头的Vendor ID:Product ID
   

2. 启动容器并连接：

   bash
   docker run -it \
       --device /dev/kvm \
       -v /tmp/.X11-unix:/tmp/.X11-unix \
       -e "DISPLAY=${DISPLAY:-:0.0}" \
       -p 5555:5555 \
       -e EXTRA="-chardev socket,id=usbredirchardev1,port=7700,host=172.17.0.1 -device usb-redir,chardev=usbredirchardev1,id=usbredirdev1,bus=ehci.0,debug=4" \
       sickcodes/dock-droid:latest
   

GPU加速（实验性）

bash
docker run -it \
    --privileged \
    --device /dev/kvm \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -p 5555:5555 \
    -p 50922:10022 \
    --device=/dev/dri \
    --group-add video \
    -e EXTRA='-display sdl,gl=on' \
    sickcodes/dock-droid:latest

UEFI启动

添加-e EXTRA='-bios /usr/share/OVMF/x64/OVMF.fd'参数：

bash
docker run -it \
    --device /dev/kvm \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -p 5555:5555 \
    -e EXTRA='-bios /usr/share/OVMF/x64/OVMF.fd' \
    sickcodes/dock-droid:latest

自定义镜像

运行时挂载本地镜像

bash
docker run -it \
    -v "${PWD}/android.qcow2:/home/arch/dock-droid/android.qcow2" \
    --privileged \
    --device /dev/kvm \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -p 5555:5555 \
    sickcodes/dock-droid:latest

构建自定义镜像

bash
CDROM_IMAGE_URL='https://sourceforge.net/projects/blissos-x86/files/Official/bleeding_edge/Generic%20builds%20-%20Pie/11.13/Bliss-v11.13--OFFICIAL-20201113-1525_x86_64_k-k4.19.122-ax86-ga-rmi_m-20.1.0-llvm90_dgc-t3_gms_intelhd.iso'

docker build \
    -t dock-droid-custom \
    --build-arg CDROM_IMAGE_URL="${CDROM_IMAGE_URL}" .

ADB连接配置

1. 在Android终端模拟器中执行：

   bash
   su
   start adbd
   

2. 从主机连接：

   bash
   adb connect localhost:5555
   adb -s localhost:5555 root
   adb -s localhost:5555 shell
   

维护者

该项目由@sickcodes（Sick.Codes）维护。更多贡献者信息请参见https://github.com/sickcodes/dock-droid/blob/master/CREDITS.md%E3%80%82

特别感谢https://github.com/BlissRoms%E6%8F%90%E4%BE%9BAndroid x86镜像，以及https://github.com/zhouziyang%E7%BB%B4%E6%8A%A4%E7%9A%84https://github.com/remote-android/redroid-doc%E9%A1%B9%E7%9B%AE%E3%80%82

许可证

Dock-Droid基于GPL v3+许可证开源。

免责声明

本项目仅用于Android安全研究和技术学习。产品名称、商标等均为其各自所有者的财产，与本项目无关联。