介绍

redroid（Remote an Droid）是一个 GPU 加速的 AIC（Android In Cloud）解决方案。Docker您可以在 Linux 主机（ 、podman等）中启动多个实例k8s。redroid支持arm64和amd64架构。 redroid适用于云游戏、虚拟化电话、自动化测试等。

目前支持：
安卓 14 (
redroid/redroid:14.0.0-latest)
仅适用于 Android 14 64 位 (
redroid/redroid:14.0.0_64only-latest)
安卓 13 (
redroid/redroid:13.0.0-latest)
仅适用于 Android 13 64 位 (
redroid/redroid:13.0.0_64only-latest)
安卓 12 (
redroid/redroid:12.0.0-latest)
仅适用于 Android 12 64 位 (
redroid/redroid:12.0.0_64only-latest)
安卓 11 (
redroid/redroid:11.0.0-latest)
安卓 10 (
redroid/redroid:10.0.0-latest)
安卓 9 (
redroid/redroid:9.0.0-latest)
安卓 8.1 (
redroid/redroid:8.1.0-latest)

入门

redroid 应该能够在任何 Linux 上运行（启用一些内核功能）。

这里以使用阿里云的X86服务器进行演示，具体如下：

安装Docker

## 安装 docker https://docs.docker.com/engine/install/#server
# 根据 Docker 官方文档安装Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
#或者从仓库下载
sudo apt update
sudo apt-get install -y docker.io
systemctl start docker
systemctl enable docker

安装内核扩展模块

根据不同的系统，有不一样的安装方法，具体如下

# 拉取内核模块源码
git clone https://github.com/remote-android/redroid-modules
cd ./redroid-modules

# Ubuntu 16.04 / 18.04 / 20.04
sudo apt-get install -y git kmod make gcc linux-headers-`uname -r`
sudo make # build kernel modules
sudo make install # build and install *unsigned* kernel modules

# Ubuntu 20.04+ (kernel 5.0+)
sudo modprobe ashmem_linux
sudo modprobe binder_linux devices=binder,hwbinder,vndbinder

# AmazonLinux2
git checkout origin/amazonlinux2
sudo yum install git kmod make "kernel-devel-uname-r == `uname -r`"
sudo make # build kernel modules
sudo make install # build and install *unsigned* kernel modules

# Alibaba Cloud Linux 2
git checkout origin/alibabalinux2
sudo yum install git kmod make "kernel-devel-uname-r == `uname -r`"
sudo make # build kernel modules
sudo make install # build and install *unsigned* kernel modules

# Alibaba Cloud Linux 3
git checkout origin/alibabalinux3
sudo yum install git kmod make "kernel-devel-uname-r == `uname -r`"
sudo make # build kernel modules
sudo make install # build and install *unsigned* kernel modules

# openEuler 20.03 / kernel 4.19
git checkout origin/openeuler2003
sudo yum install gcc kernel-devel
sudo KDIR=/usr/src/kernels/<VER> make install

# 检查模块状态
lsmod | grep -e ashmem_linux -e binder_linux
# example output:
# binder_linux          147456  79
# ashmem_linux           16384  23

# 也可以这样验证
grep binder /proc/filesystems # output should like: nodev    binder
grep ashmem /proc/misc # output should like: 56 ashmem

这边因为是ubuntu 22.04，便使用 modprobe 安装

如果不想换系统，可以尝试升级内核到5.0以上，默认就自带相关模块了

启动容器

创建Docker-compose文件

docker-compose.yml

version: "3"
services:
  redroid:
    image: redroid/redroid:11.0.0-latest
    stdin_open: true
    tty: true
    privileged: true
    ports:
      - "20055:5555"
    volumes:
    # 資料存放在目前目錄下
      - ./redroid-11-data:/data
    command:
    # 設定libndk相關
      - ro.product.cpu.abilist0=x86_64,arm64-v8a,x86,armeabi-v7a,armeabi
      - ro.product.cpu.abilist64=x86_64,arm64-v8a
      - ro.product.cpu.abilist32=x86,armeabi-v7a,armeabi
      - ro.dalvik.vm.isa.arm=x86
      - ro.dalvik.vm.isa.arm64=x86_64
      - ro.enable.native.bridge.exec=1
      - ro.dalvik.vm.native.bridge=libndk_translation.so
      - ro.ndk_translation.version=0.2.2
      - ro.secure=0
    cap_add:
      - CAP_SYS_MODULE

启动容器

#确保安装了docker-compose
apt install docker-compose


# 进入储存docker-compose.yml的目录
cd /data/redroid-1
docker-compose up -d

如果使用 22.04可能出现如下异常

解决方案

pip install 'urllib3<2'

链接

根据 Scrcpy 官方文档下载安卓投屏软件源码包到客户机，解压使用

adb connect ip:5555
# adb devices 可查看连接设备列表
scrcpy --serial ip:5555

高级设置

一些额外参数

样例

docker run -itd --rm --privileged \
    --pull always \
    -v ~/data:/data \
    --cap-add CAP_SYS_MODULE \
    -p 5555:5555 \
    redroid/redroid:11.0.0-latest \
    androidboot.redroid_width=1080 \
    androidboot.redroid_height=1920 \
    androidboot.redroid_dpi=480 \