Redroid 安装与使用

Redroid 是一个基于容器的 Android 运行环境，适合在 Linux 主机上快速跑 Android 应用、做兼容性测试、或在服务器上做轻量级 Android 实例。它和传统虚拟机相比更轻，启动也更快，最适合用 Docker 来部署。

本文整理一份比较实用的安装步骤，方便后续复用。

1. 环境要求#

Debian / Ubuntu / 其他主流 Linux 发行版
Docker 20.10+
具备较新的内核和基本虚拟化支持
可选：ADB（Android 调试桥）

如果主机还没有安装 Docker，可以直接按下面的步骤装好。

2. 安装 Docker#

以 Debian / Ubuntu 为例：

1
sudo apt-get update
2
sudo apt-get install -y ca-certificates curl gnupg lsb-release
3

4
sudo install -m 0755 -d /etc/apt/keyrings
5
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
6

7
echo \
8
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | \
9
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
10

11
sudo apt-get update
12
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
13
sudo systemctl enable --now docker
14
sudo usermod -aG docker $USER

重开一个 shell，会话后再继续操作，或直接执行：

1
newgrp docker

验证安装：

1
docker --version

3. 拉取并启动 Redroid#

最常用的方式就是直接用官方镜像启动：

1
docker run -d \
2
  --privileged \
3
  --name redroid \
4
  -p 5555:5555 \
5
  -v redroid_data:/data \
6
  redroid/redroid:latest

说明：

--privileged：Redroid 需要较高权限，容器内要访问 Android 相关设备节点
-p 5555:5555：把容器里的 ADB 端口映射到宿主机
-v redroid_data:/data：持久化数据目录

如果想指定某个版本，也可以写成：

1
docker run -d \
2
  --privileged \
3
  --name redroid \
4
  -p 5555:5555 \
5
  redroid/redroid:13.0.0

更稳定一点的做法是先查看日志，确认容器是否成功启动：

1
docker logs -f redroid

4. 连接 ADB#

Redroid 启动后，可以直接用 ADB 连到本机：

1
adb connect 127.0.0.1:5555
2
adb devices

如果 adb 没有安装，需要先装 Android Platform Tools：

1
sudo apt-get install -y android-tools-adb

连接成功后，可以直接在宿主机执行常规 Android 调试命令：

1
adb shell
2
adb install /path/to/app.apk
3
adb logcat

5. 常见命令#

查看容器状态：

1
docker ps

停止 Redroid：

1
docker stop redroid

重启 Redroid：

1
docker start redroid

删除容器：

1
docker rm -f redroid

如果想重新创建：

1
docker volume rm redroid_data

6. 常见问题#

1）adb 连接不上#

先确认容器正在运行：

1
docker ps

再检查端口是否暴露：

1
ss -lntp | grep 5555

如果没有监听，通常是容器未正常启动，继续看日志：

1
docker logs redroid

2）启动失败或容器退出#

通常是 Docker 权限、内核能力或宿主机兼容性问题。可先检查：

1
docker inspect redroid

如果日志里有相关错误，优先确认：

Docker 是否正常运行
内核是否支持容器所需能力
镜像版本是否适配当前系统

3）需要更高性能/更完整 Android 体验#

Redroid 适合轻量使用，但如果需要完整图形界面或更强的模拟器能力，配合 scrcpy、VNC 或更强的 Android 模拟器方案会更合适。

7. 一个比较稳妥的部署模板#

如果只是想快速部署一个 Android 容器，直接用下面这组命令即可：

1
docker run -d \
2
  --privileged \
3
  --name redroid \
4
  -p 5555:5555 \
5
  -v redroid_data:/data \
6
  redroid/redroid:latest
7

8
adb connect 127.0.0.1:5555
9
adb devices

这个方案最省事，适合日常测试、app 调试、自动化小规模 Android 环境。

8. 小结#

Redroid 的核心价值在于：不需要完整 Android 模拟器、启动速度快、部署方式简单、对 Linux 服务器非常友好。只要 Docker 正常安装好，通常几分钟内就能完成一套可用的 Android 容器环境。

如果需要长期稳定运维，建议把 Redroid 作为一个容器服务来管理，并通过 docker logs、docker restart、docker volume 这些命令做持久化和维护。