shmayro/dockerify-android

Dockerify Android

![许可证：MIT]([***]

Dockerify Android 是一款Docker化的Android模拟器，支持多种CPU架构（x86及即将支持的arm64），具备原生性能和无缝ADB与Web访问能力。它允许开发者在Docker容器中高效运行Android虚拟设备（AVDs），促进可扩展的测试和开发环境构建。

🔥 核心功能：Web界面访问 🌐

通过集成的https://github.com/Shmayro/ws-scrcpy-docker%E7%95%8C%E9%9D%A2%EF%BC%8C%E5%8F%AF%E7%9B%B4%E6%8E%A5%E5%9C%A8Web%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%AD%E8%AE%BF%E9%97%AE%E5%92%8C%E6%8E%A7%E5%88%B6Android%E6%A8%A1%E6%8B%9F%E5%99%A8%EF%BC%81%E6%97%A0%E9%9C%80%E5%AE%89%E8%A3%85%E9%A2%9D%E5%A4%96%E8%BD%AF%E4%BB%B6%E2%80%94%E2%80%94%E5%8F%AA%E9%9C%80%E6%89%93%E5%BC%80%E6%B5%8F%E8%A7%88%E5%99%A8%E5%8D%B3%E5%8F%AF%E5%BC%80%E5%A7%8B%E4%BD%BF%E7%94%A8Android%E3%80%82

Web界面优势：

• 无需安装额外软件
• 可从任何具备Web浏览器的计算机访问
• 完整支持触摸屏和键盘操作
• 非常适合远程工作或与团队成员共享模拟器

🏠 主页

📜 目录

• 功能特性
• 前提条件
• 安装步骤
• 使用方法
  • Web界面访问
  • ADB连接
  • 桌面scrcpy使用
• 首次启动过程
• 容器日志
• 开发路线
• 故障排除
• 贡献指南
• 许可证
• 联系方式

🔧 功能特性

• 🌐 Web界面： 通过集成的https://github.com/Shmayro/ws-scrcpy-docker%E7%95%8C%E9%9D%A2%E7%9B%B4%E6%8E%A5%E4%BB%8E%E6%B5%8F%E8%A7%88%E5%99%A8%E8%AE%BF%E9%97%AE%E6%A8%A1%E6%8B%9F%E5%99%A8%E3%80%82
• 预装Root和Magisk： 提供Root权限和预装的Magisk，支持高级系统修改。
• 预装PICO GAPPS： 包含PICO GAPPS，提供必要的Google服务。
• 无缝ADB访问： 可从主机和其他网络设备通过ADB连接到模拟器。
• scrcpy支持： 使用scrcpy镜像模拟器屏幕，提供流畅的用户体验。
• 优化性能： 利用原生CPU能力实现高效模拟。
• 多架构支持： 原生运行于x86和arm64 CPU架构。
• Docker集成： 轻松在Docker容器中部署Android模拟器。
• 简易设置： 通过简单的Docker命令构建和运行模拟器。
• Supervisor管理： 使用Supervisor管理模拟器进程，确保可靠性。
• 统一容器日志： 所有模拟器和启动日志均重定向到Docker标准日志系统。

🛠️ 前提条件

开始前，请确保满足以下要求：

• Docker： 已在系统上安装。安装指南
• Docker Compose： 用于管理多容器设置。安装指南
• KVM支持： 确保系统支持KVM（基于内核的虚拟机）以实现硬件加速。

  • 检查KVM支持：

    bash
    egrep -c '(vmx|svm)' /proc/cpuinfo
    

    非零输出表示支持KVM。

🚀 安装步骤

为简化设置过程，可使用提供的https://github.com/Shmayro/dockerify-android/blob/main/docker-compose.yml%E6%96%87%E4%BB%B6%E3%80%82

1. 克隆仓库：

   bash
   git clone https://github.com/shmayro/dockerify-android.git
   cd dockerify-android
   

2. 运行Docker Compose：

   bash
   docker compose up -d
   

   注意： 此命令启动Android模拟器和Web界面。首次启动需要一些时间进行初始化。准备就绪后，可通过 http://localhost:8000 在Web界面中查看设备。

📡 使用方法

🌐 通过Web界面访问模拟器

与Android模拟器交互的最快最简单方式是通过Web浏览器：

1. 打开浏览器并访问 http://localhost:8000
2. 设备应自动显示为“dockerify-android:5555”并已连接
3. 选择可用的流式传输选项：
   • H264 Converter（推荐，总体体验最佳）
   • Tiny H264（适用于低带宽连接）
   • Broadway.js（备用选项）

!https://raw.githubusercontent.com/Shmayro/dockerify-android/main/doc/scrcpy-web-preview.png

注意： 首次启动时，Android模拟器需要完全初始化，可能需要一些时间。一切就绪后，设备将如上图所示出现在Web界面中。

通过ADB连接

如需直接ADB访问模拟器：

bash
adb connect localhost:5555
adb devices

预期输出：

connected to localhost:5555
List of devices attached
localhost:5555	device

使用scrcpy镜像模拟器屏幕

如需原生桌面体验，可使用scrcpy：

bash
scrcpy -s localhost:5555

注意： 确保主机已安装scrcpy。https://github.com/Genymobile/scrcpy#installation

🔄 首次启动过程

首次启动容器时，将执行全面的设置过程，包括：

1. AVD创建： 创建运行Android 30（Android 11）的新Android虚拟设备
2. 安装PICO GAPPS： 添加必要的Google服务到模拟器
3. 设备Root： 执行多次重启以：
   • 禁用AVB验证
   • 将系统重新挂载为可写
   • 通过rootAVD脚本安装Root权限
   • 安装PICO GAPPS组件
   • 配置最佳设备设置

重要： 首次启动可能需要10-15分钟才能完成。当看到以下日志输出时，表示过程已完成：

Broadcast completed: result=0
Sucess !!
2025-04-22 13:45:18,724 INFO exited: first-boot (exit status 0; expected)

注意： 若Android模拟器因任何原因重启，建议重启Docker容器以重新应用优化：

bash
docker compose restart

这将确保应用以下优化：

• 禁用动画以提高性能
• 屏幕超时设置为15秒
• 禁用旋转
• 自定义DNS设置
• 启用飞行模式（WiFi仍保持活动）
• 禁用数据连接

首次启动完成后，将创建文件标记，防止后续启动时再次运行初始化过程。

📋 容器日志

所有模拟器和启动过程的日志均重定向到Docker标准日志系统。查看所有容器日志：

bash
docker logs -f dockerify-android

包括：

• Supervisor日志
• Android模拟器标准输出/错误
• 首次启动过程日志

🚧 开发路线

• 支持更多Android版本
• 与CI/CD流水线集成
• 支持ARM64 CPU架构
• 预装PICO GAPPS
• 支持Magisk
• 添加scrcpy的Web界面 (https://github.com/Shmayro/ws-scrcpy-docker)
• 将所有日志重定向到容器标准输出/错误

🐞 故障排除

• ADB连接被拒绝：

  • 确保ADB服务器正在运行：

    bash
    adb start-server -a
    

  • 验证防火墙设置： 确保服务器上的端口5555已打开。

  • 检查模拟器状态： 通过查看日志确保模拟器已完全启动。

    bash
    docker logs dockerify-android
    

• 首次启动时间过长：

  • 这是正常现象，首次启动过程需要执行多项操作，包括：
    • 安装GAPPS
    • 设备Root
    • 配置系统设置
  • 根据系统性能，该过程可能需要10-15分钟
  • 可通过docker logs -f dockerify-android监控进度

• 模拟器无法启动：

  • 检查容器日志：

    bash
    docker logs dockerify-android
    

🤝 贡献指南

欢迎贡献！贡献步骤：

1. ** Fork 仓库**

2. 创建功能分支：

   bash
   git checkout -b feature/YourFeature
   

3. 提交更改：

   bash
   git commit -m "Add Your Feature"
   

4. 推送到分支：

   bash
   git push origin feature/YourFeature
   

5. 打开Pull Request

请确保您的贡献符合项目编码标准并包含相关测试。

📄 许可证

本项目采用MIT许可证。

📫 联系方式

• Haroun EL ALAMI
• ***： ***
• GitHub： https://github.com/shmayro
• ***： @HarounDev