dimasaryoprakoso/stf

定制化OpenSTF镜像

镜像概述

STF（Smartphone Test Farm）是一款开源Web应用，用于远程调试智能手机、智能手表及其他智能设备。本镜像为定制化版本，继承了STF的核心能力，支持开发者从浏览器远程控制设备，进行调试、测试等操作。

核心功能

• 远程设备控制：实时屏幕查看（最高30-40 FPS）、旋转支持、键盘输入、多点触控（含手势操作）；
• 应用与文件管理：拖拽安装APK、文件浏览器访问设备文件系统；
• 网络与调试：反向端口转发、ADB远程连接、Chrome远程调试工具支持、Shell命令执行；
• 设备管理：查看设备状态（在线/离线）、搜索筛选设备、监控电池健康、硬件规格展示；
• REST API：提供简单的API接口，方便集成到其他系统。

使用场景

• 移动应用开发者远程调试多台设备，验证跨设备兼容性；
• 设备实验室集中管理测试设备，提高资源利用率；
• 团队协作共享设备资源，减少物理设备依赖。

配置说明

依赖要求

• 主机需安装ADB并配置正确；
• 确保主机USB设备可被容器访问（需--privileged权限）；
• 推荐使用Linux系统以获得稳定的USB支持。

Docker部署示例

基本运行命令

bash
docker run -d \
  --name stf \
  --privileged \
  -p 7100:7100 \
  -v /dev/bus/usb:/dev/bus/usb \
  dimasaryoprakoso/stf stf local --public-ip 192.168.1.100

（替换<你的IP>为实际主机IP，访问http://<你的IP>:7100即可使用）

Docker Compose示例

yaml
version: '3'
services:
  stf:
    image: dimasaryoprakoso/stf
    container_name: stf
    privileged: true
    ports:
      - "7100:7100"
    volumes:
      - /dev/bus/usb:/dev/bus/usb
    command: stf local --public-ip 192.168.1.100