由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名
redroid 5分钟快速开始指南
在Linux上通过Docker快速启动一个带GPU加速的云端安卓实例。
环境要求
支持的操作系统
运行环境
所需工具
用于连接和调试安卓容器
操作步骤
启动redroid容器
使用Docker命令启动一个默认配置的redroid容器。
docker run -itd --rm --privileged --pull always -v ~/data:/data -p 5555:5555 redroid/redroid:12.0.0-latest预期结果：：Docker打印出一长串容器ID，表示容器在后台成功启动。
此命令会自动拉取镜像。确保宿主机已正确安装内核模块（如binder, ashmem）。
连接ADB
使用ADB连接到刚刚启动的安卓容器。
adb connect localhost:5555adb devices预期结果：：在`adb devices`输出中，应看到`localhost:5555 device`，状态为`device`表示连接成功。
如果连接失败，请等待几秒后重试，容器内的安卓系统启动需要一点时间。
获取安卓Shell
进入容器的安卓系统Shell，进行简单验证。
adb -s localhost:5555 shellgetprop ro.build.version.release预期结果：：在shell中，执行`getprop`命令后，应输出`12`（对应Android 12版本）。
在shell中，可以执行各种安卓命令。输入`exit`可退出shell。
验证安卓实例运行成功
通过ADB确认设备连接正常并能获取系统信息。
快速提示
要指定安卓版本，只需更改Docker镜像标签，如`redroid/redroid:11.0.0-latest`。
要自定义分辨率等参数，需在`docker run`命令后添加`-e`环境变量，如`-e 'androidboot.redroidwidth=1080'`。
容器运行后，可以用`docker logs <container_id>`查看安卓系统的启动日志。
常见问题
容器启动后立刻退出（docker ps看不到）。
检查宿主机内核是否启用了必要的模块。运行`dmesg -T`查看错误日志，通常需要`binder_linux`和`ashmem_linux`模块。
ADB连接后设备状态为offline或无法连接。
1. 等待更长时间，安卓启动较慢。 2. 尝试重启容器：`docker restart <container_id>`。 3. 检查容器日志：`docker exec -it <container_id> logcat`。
需要图形界面（GPU加速）但显示异常。
确保宿主机正确安装了GPU驱动（如NVIDIA）。在`docker run`命令中添加`--gpus all`和`-e 'androidboot.redroidgpumode=host'`。
下一步
安装应用
使用`adb install <path_to_apk>`命令向安卓实例安装应用。
查看配置参数
查阅项目README中的Configuration部分，调整显示、网络等高级设置。
使用WebRTC访问
探索项目中提到的WebRTC方案，通过浏览器访问安卓图形界面。
相关项目推荐
obra/superpowers
Claude Code 超级能力：核心技能库
mattpocock/skills
我的个人技能目录，直接源自我的 .claude 知识库
ohmyzsh/ohmyzsh
🙃 社区驱动的卓越框架（拥有2400多名贡献者），用于管理zsh配置。包含300多个可选插件（rails、git、macOS、hub、docker、homebrew、node、php、python等）、140多种主题焕新每日体验，以及可轻松同步社区最新更新的自动更新工具
msitarzewski/agency-agents
触手可及的完整AI代理体系——从前端魔法师到Reddit社区忍者，从奇思妙想注入者到现实核查员。
d3/d3
使用SVG、Canvas和HTML让数据跃然呈现
nvm-sh/nvm
Node 版本管理器 - 符合 POSIX 标准的 bash 脚本，用于管理多个活跃的 node.js 版本