FIRERPA：Android 全栈设备控制平台

项目简介

FIRERPA（仓库名 lamda）是一个一体化的 Android 设备控制平台。服务端直接运行在 Android 设备上，不需要额外的运行时依赖，支持多代 Android 系统，有 root 或无 root 均可使用。PC 侧通过 Python 客户端库，用同一套服务和 API 串联 UI 自动化、远程操作、流量抓取、Hook 逆向、网络代理、分布式组网、AI Agent 与 MCP。

相比把 Appium、mitmproxy、frida-server、adb、uiautomator2 以及各种临时脚本拼在一起，FIRERPA 提供统一的能力来源、统一配置与连通的工作流，面向多设备、长时间运行的生产环境。

文档：英文文档 ｜ 中文文档

主要功能

远程桌面与实时推流

浏览器端即可查看并实时控制设备，无需安装专用 PC 客户端，支持局域网与跨网络访问。推流支持 MJPEG 与 H.264（软件/硬件编码），可调节帧率（最高 60fps）、分辨率缩放、码率与画质；支持 WebRTC 及可配置的 STUN/TURN，改善 NAT 穿透与端到端延迟。

• 多用户并发访问，适合协同调试、演示与培训
• 双向剪贴板、实时音频（Android 10+）、集成终端、拖拽上传、浏览器内文件浏览与下载
• 可视化布局检查：高亮元素、Tab 遍历、坐标与 RGB 取值、导出 XML 布局树
• 远程桌面与 RPC 支持端到端 TLS、服务证书访问控制与 WebUI 登录密码，可通过 WebSocket 嵌入自有 Web 应用（allow_origin 支持跨域）

UI 自动化

提供完整的 selector 自动化体系：text、resourceId、description、scrollable 等常见匹配，以及 child / sibling 链式查找；元素级支持截图、等待出现/消失、坐标、存在性判断、Unicode 输入、分段滑动、fling 滚动、滚动到底等。Android 8.0+ 可与其他无障碍服务共存。

• UI Watcher：实时监听界面变化，命中条件时执行点击、按键或计数，可用于自动关闭协议、更新提示与广告
• Virtual Display：在设备上创建隔离的后台显示，在其中运行应用与自动化而不影响主屏，API 与主设备 API 对应（d.xxx → vd.xxx），WebUI 支持多显示切换
• OCR：支持 paddleocr、easyocr 与自定义 HTTP 后端，集群中可集中识别并做 GPU 加速
• 图像匹配：在设备端运行（模板匹配或 SIFT），不占 PC 资源；SIFT 对旋转、缩放与光照更稳健
• 多点触控：支持录制、回放、程序化构造与二进制持久化

抓包与 MITM

一键 MITM：自动安装系统根 CA、设置代理、处理不同 Android 版本差异，退出时自动恢复网络。支持全局抓包、按包名抓包、实时编辑请求响应、共享 mitmweb、上游 HTTP 代理与 QUIC 降级；PC 与设备只共享一个 FIRERPA 端口时（如 ADB connect 或 frp 转发）同样可抓包。MITM 也完全 API 化，可与 UI 步骤、Frida Hook 一起嵌入自动化流水线。

网络、代理与连通性

• 设备侧代理：HTTP / HTTPS / SOCKS5 / Shadowsocks（多种加密），支持分应用代理、DNS 代理、UDP 代理、局域网绕过、与 OpenVPN 共存、启动自动连接；支持 IPv6 与 UDP
• tunnel2 设备 HTTP 桥代理：把 PC 或浏览器的 HTTP 代理指向手机，出口 IP 与手机一致，可选 Wi-Fi 或蜂窝（rmnet）出口
• 内置 OpenVPN 客户端（证书、用户名密码、混合认证）与对应 Docker 镜像、配置生成器
• 内置 frp 客户端，通过 fwd.* 将设备服务转发到公网服务器，支持加密与 TLS
• mDNS 发现：通过 {device_id}.local 访问远程桌面等服务

Frida 与逆向

内置最新 Frida，无需单独部署 frida-server，在远程桌面终端里直接用 frida 工具（无需 -U、-H）；内置隐藏补丁，连接使用 token 认证并走 FIRERPA 端口。持久化 Frida 脚本可在应用崩溃或退出后自动重注入，支持 YAML 离线持久化、目录监听与热重载；Frida RPC 可映射为 Python 方法以及 HTTP + JSON-RPC 2.0 远程调用。脚本 emit 的数据可输出到 HTTP / Redis / RabbitMQ（MQTT）。

ADB、SSH 与内置终端

内置独立 ADB（无需开启系统开发者选项的无线高权限 ADB）、内置 SSH 与 ssh.sh / scp.sh。终端预置 strace、ltrace、tcpdump、scapy、fsmon、frida-tools、MemDumper 以及 Crypto、cv2、unicorn、capstone、keystone 等 Python 栈；sqlite3 支持 wxsqlite / sqlcipher / sqlcrypto，可读取应用的加密数据库。

分布式与多设备管理

StarLink 平台（Hub + hub-bridge）提供本地与远程设备的集中接入、统一管理与 P2P 访问；hub v3 使用 SAPI 统一请求本地与远程设备。也支持 frp 转发与 OpenVPN mesh 作为自托管方案。自 9.0 起支持 P2P Bridge 与内置分布式任务系统，面向云手机池、设备农场与模拟器集群。

AI / MCP / Agent

内置 MCP server（/mcp/，streamable-http），支持工具调用、资源读取、prompts、进度通知与日志，兼容 Claude、Cursor 等 MCP 客户端，扩展位于 ~/modules/extension。内置 agent 命令可通过任意 OpenAI 兼容 API 以自然语言驱动设备（含 vision 模式），并提供 OpenAI 语义任务执行器，结合 crontab 可做定时 AI 任务。

系统控制与扩展

160+ Python API 覆盖应用操作、文件 I/O、命令执行、设备状态、WiFi、代理、OpenVPN、开关机重启、服务日志等；setprop 可写 ro.* 只读属性；支持 SELinux 域创建与细粒度策略；提供多开应用 API、静默授权/撤销权限、启动非导出 Activity、禁用应用；还有二进制补丁（十六进制通配符、glob 路径、dryrun）、运行时磁盘/电池/CPU/内存/网络 I/O 指标，以及设备端 tflite-runtime 边缘推理。

安装与使用

服务端直接运行在 Android 设备上，无需额外运行时依赖；PC 侧使用 Python 客户端库进行编排。具体安装与使用方式请参考 中文使用文档 与 英文文档。仓库中还提供 SKILLS 与 llms-full.txt 供参考。

注意事项

• 项目以 MIT 许可证开源。
• 抓包、Frida Hook、二进制补丁、SELinux 策略调整等能力涉及系统与安全层面，请在合法授权范围内使用。
• 部分能力对 Android 版本有要求（如实时音频需 Android 10+，与其他无障碍服务共存需 Android 8.0+），具体以文档说明为准。

---

本作品整理自 GitHub 开源项目 firerpa/lamda，原作者 @firerpa，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。