lamda

# **FIRERPA Android** ｜ Автоматизация на базе ИИ

<img src="https://raw.githubusercontent.com/firerpa/lamda/HEAD/image/logo.svg" alt="FIRERPA" width="200" align="right" />

<p>
<img src="https://img.shields.io/badge/python-3.6+-blue.svg?logo=python&amp;labelColor=yellow" />
<img src="https://img.shields.io/badge/android-6.0+-blue.svg?logo=android&amp;labelColor=white" />
<img src="https://img.shields.io/badge/root/non--root--mode-green.svg?logo=android&amp;labelColor=black" />
<img src="https://img.shields.io/badge/Built--in%20MCP-000.svg?logo=anthropic&amp;labelColor=black" />
</p>

<h6>Универсальный фреймворк автоматизации Android, объединяющий службы на устройстве, ИИ-агентов и расширяемый вызов инструментов.</h6>

<p align="left"><a href="https://device-farm.com/docs/en/">Документация</a> | <a href="https://device-farm.com/docs/zh/">使用文档</a> | <a href="https://device-farm.com/contact#telegram">TELEGRAM</a> | <a href="https://device-farm.com/contact#QQ">QQ Group</a> | <a href="https://github.com/firerpa/skills">SKILLS</a> | <a href="https://device-farm.com/llms-full.txt">llms-full.txt</a> | <a href="https://github.com/firerpa/lamda/blob/10/README.zh.md">中文版本</a></p>

FIRERPA — это **универсальная платформа управления Android-устройствами**. Сервер работает непосредственно на устройстве **без дополнительных рантайм-зависимостей**; **поддерживаются несколько поколений Android**, работа возможна **с root и без root**. На стороне ПК клиентская библиотека Python управляет UI-автоматизацией, удалёнными операциями, захватом трафика, реверс-инжинирингом на основе Hook, сетевым проксированием, распределёнными сетями, ИИ-агентами и **MCP** через единый сервис и API. По сравнению со склеиванием Appium, mitmproxy, frida-server, adb, uiautomator2 и разрозненных скриптов и инструментов эксплуатации FIRERPA предлагает **единый источник возможностей, унифицированную конфигурацию, связанные рабочие процессы и стек, рассчитанный на многоустройственные, длительные, production-сценарии**.

## Удалённый рабочий стол и прямая трансляция

FIRERPA предоставляет браузерный удалённый рабочий стол: просматривайте устройство и управляйте им в реальном времени без установки отдельного ПК-клиента — по LAN или через сети. Трансляция поддерживает **MJPEG** и **H.264** с программным и аппаратным кодированием. Частоту кадров (до 60fps), масштаб разрешения, битрейт и качество можно настраивать под возможности устройства и состояние сети — это снижает расход трафика и повышает плавность на слабых каналах. Также поддерживается **WebRTC** с настраиваемыми STUN/TURN-серверами для лучшего прохождения NAT и меньшей сквозной задержки в публичных и межрегиональных конфигурациях.

Удалённый рабочий стол поддерживает **одновременный доступ нескольких пользователей** для совместной отладки, демонстраций и обучения. Включены **двунаправленный буфер обмена** и **аудио в реальном времени** (Android 10+), а также встроенный терминал, загрузка файлов перетаскиванием и просмотр и скачивание файлов через браузер — всё через один порт. Встроенная **визуальная инспекция макета** подсвечивает элементы, поддерживает обход с помощью Tab, показывает координаты и значения RGB и экспортирует XML-дерево макета, чтобы вы могли проверять селекторы и логику автоматизации в том же интерфейсе, сокращая путь от экрана до скрипта.

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/251d9eed35540aadebab75dec6f3a59aaeb7c4b5f93ee39e8f74dcb8b0cfa68d.gif" alt="demo" width="100%">
</p>

Удалённый рабочий стол и RPC поддерживают **сквозной TLS** и контроль доступа по сертификатам сервиса, с опциональными собственными паролями входа в WebUI для снижения рисков в публичных сетях. Возможности удалённого рабочего стола также можно встраивать в собственные веб-приложения через WebSocket (живое видео, касания, терминал, клавиши и т. д.) с параметром `allow_origin` для кросс-доменной интеграции — это подходит для создания продуктов на базе управления реальными устройствами.

## UI-автоматизация

FIRERPA предоставляет полноценную систему автоматизации на основе селекторов: text, resourceId, description, scrollable и другие распространённые матчеры, плюс цепочки **child / sibling** для дублирующихся элементов, глубоких иерархий или элементов управления без характерных атрибутов. На уровне элемента: скриншоты, ожидание появления/исчезновения, координаты углов/центра, проверки существования, ввод Unicode, ступенчатые свайпы, fling-прокрутка, прокрутка до конца и многое другое. Система может **сосуществовать с другими службами специальных возможностей** на Android 8.0+ и улучшает обнаружение узлов WebView в гибридных приложениях.

**UI Watcher** отслеживает изменения интерфейса в реальном времени и выполняет клики, события клавиш или счётчики при совпадении условий — это полезно для автоматического закрытия соглашений, предложений обновления, рекламы и других помех. Поддерживаются несколько условий-селекторов и включение/отключение для каждого события; можно подсчитывать временные экраны.

**Виртуальный дисплей** — ключевое отличие: можно создавать изолированные фоновые дисплеи на устройстве и запускать на них приложения и автоматизацию **не затрагивая основной экран** — например, автоответы на виртуальном дисплее, пока вы пользуетесь телефоном как обычно. API виртуального дисплея повторяет API основного устройства (`d.xxx` → `vd.xxx`); Watcher можно ограничить областью виртуального дисплея. WebUI поддерживает **просмотр и переключение нескольких дисплеев** в удалённом рабочем столе — идеально для фоновых задач, параллельной работы и сочетания «человек в контуре» с машинной автоматизацией.

Для сценариев без стандартного дерева представлений (игры, интерфейсы с собственной отрисовкой) FIRERPA предлагает **OCR** и **сопоставление изображений**. OCR поддерживает paddleocr, easyocr и пользовательские HTTP-бэкенды; в кластерах распознавание может выполняться централизованно вместо загрузки моделей на каждом ПК, с GPU-ускорением и гибким сопоставлением текста. Сопоставление изображений выполняется **на устройстве** (по шаблону или SIFT), не расходуя ресурсы ПК; SIFT устойчив к повороту, масштабу и освещению. **Мультитач** поддерживает запись, воспроизведение, программное построение и двоичное сохранение сложных жестов и силы нажатий.

Архитектурно FIRERPA использует модель «клиент/сервер» — она лучше подходит для **централизованного планирования, версионирования и управления парком устройств**, чем локальные исполнители скриптов вроде AutoJS; легче Appium; **стабильнее uiautomator2 в многоустройственных сценариях**. В документации он позиционируется как **функциональное надмножество** типовых стеков автоматизации Android — автоматизация, захват трафика, Hook и эксплуатация могут выстраиваться в цепочки в коде на одной платформе без смены инструментов.

## Захват пакетов и MITM

FIRERPA предлагает **захват MITM в один клик**: автоматическая установка системного корневого CA, настройка прокси, обработка различий версий Android и автоматическое восстановление сети при выходе — без ручного переключения сертификатов и прокси. Поддерживаются глобальный захват, захват для отдельных пакетов, редактирование запросов/ответов в реальном времени, общий mitmweb и вышестоящий HTTP-прокси для **международного трафика**. Встроенный **даунгрейд QUIC** снижает помехи от QUIC. Захват работает, даже когда ПК и устройство связывает только один порт FIRERPA (например, ADB connect или форвардинг frp).

Помимо скриптов в один клик, MITM полностью **управляется через API**: установка/удаление системных CA, совместимых с mitmproxy, Fiddler, Charles и др.; встраивание захвата в конвейеры автоматизации вместе с UI-шагами и Frida-хуками. Для Windows доступен **startmitm.exe** без установки Python.

## Сеть, прокси и подключения

На устройстве FIRERPA обеспечивает полную поддержку прокси: **HTTP / HTTPS / SOCKS5 / Shadowsocks** (несколько шифров), прокси для отдельных приложений (включая многопользовательские клоны), DNS-прокси, UDP-прокси, обход LAN, сосуществование с OpenVPN и **автоподключение** к настроенным прокси при запуске. Прокси поддерживают **IPv6 и UDP** для сложных сетей.

**Мостовой HTTP-прокси устройства (tunnel2)** обеспечивает возможность обратного прокси: укажите HTTP-прокси ПК или браузера на телефон, и трафик будет перенаправляться через точку выхода в сеть телефона; исходящий IP совпадает с IP телефона. В качестве исходящего интерфейса можно выбрать Wi‑Fi или сотовую сеть (rmnet) — это удобно для совместной отладки, международных приложений и пулов IP для нескольких устройств.

Встроенный **OpenVPN-клиент** поддерживает сертификаты, имя пользователя/пароль и смешанную аутентификацию наряду с системным прокси; **Docker-образ OpenVPN** и генераторы конфигураций создают код для устройства и настройки автозапуска. Встроенный **frp-клиент** перенаправляет сервисы устройства на публичный сервер через `fwd.*`, с шифрованием и TLS.

**Обнаружение mDNS** обеспечивает доступ к удалённому рабочему столу и другим сервисам через `{device_id}.local`, с опциональными TXT-метаданными (модель, ABI, ID устройства) для обнаружения парка устройств в локальной сети.

## Frida и реверс-инжиниринг

FIRERPA **поставляется с последней версией Frida** — отдельный frida-server не нужен. Используйте инструментарий frida из терминала удалённого рабочего стола без `-U`, `-H` и т. д. Встроенные патчи скрытия (на базе open-source и собственных наработок) постоянно обновляются для защиты от детектирования; подключения используют токен-аутентификацию через порт FIRERPA. Патчи objection и помощники java-bridge для Frida 17.x упрощают миграцию.

**Постоянные Frida-скрипты** повторно внедряются после краха или закрытия приложения; офлайн-сохранение в YAML с отслеживанием каталога и горячей перезагрузкой. Frida RPC сопоставляется с **методами Python** и удалёнными вызовами **HTTP + JSON-RPC 2.0** в потоках JVM, главном потоке UI или чистых JS-потоках. Данные скрипта, отправляемые через `emit`, могут поступать в **HTTP / Redis / RabbitMQ (MQTT)** с метаданными устройства/приложения, сжатием zlib, повторами HTTP-запросов и TLS для MQTT.

## ADB, SSH и встроенный терминал

FIRERPA включает **автономный встроенный ADB** — беспроводной ADB с высокими привилегиями **без включения системных параметров разработчика**, что полезно, когда приложения детектируют режим разработчика. Модули Magisk могут предустанавливать `adb_keys` для авторизации по умолчанию. Встроенный **SSH**, а также `ssh.sh` / `scp.sh` для удалённой оболочки и передачи файлов.

В состав **встроенного терминала** входят strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper и стеки Python, такие как Crypto, cv2, unicorn, capstone, keystone, redis и grpc. sqlite3 поддерживает **wxsqlite / sqlcipher / sqlcrypto** для чтения зашифрованных баз данных из таких приложений, как WeChat, WeCom и клиенты семейства Alibaba. Единая среда для удалённого рабочего стола, SSH и ADB — анализируйте и управляйте прямо на устройстве, реже переключаясь на ПК.

## Распределённое и многоустройственное управление

**Платформа FIRERPA StarLink (Hub + hub-bridge)** обеспечивает централизованный доступ к нескольким устройствам — локальным и удалённым — с единым управлением и **P2P**-доступом. Идеально подходит для сценария «устройство дома, оператор в другом месте» и многоустройственного взаимодействия. hub v3 использует **SAPI** для унифицированных запросов к локальным и удалённым устройствам. Помимо Hub, в качестве self-hosted вариантов поддерживаются **форвардинг frp** и **mesh-сеть OpenVPN** — с полной документацией и поддержкой Docker.

Начиная с версии 9.0 поддерживаются прямое пиринговое соединение **P2P Bridge** и **встроенная система распределённых задач**; начиная с 7.50 доступна подписочная сетевая служба, так что вам не нужно самостоятельно размещать frp/OpenVPN. Спроектировано для пулов облачных телефонов, ферм устройств и кластеров эмуляторов — **пакетная работа с устройствами, круглосуточно, без участия человека**.

## ИИ / MCP / Агент

FIRERPA включает **MCP-сервер** (`/mcp/`) на **streamable-http** с вызовами инструментов, чтением ресурсов, промптами, уведомлениями о прогрессе и журналами — совместим с **Claude, Cursor** и другими MCP-клиентами. Официальные MCP-расширения находятся в `~/modules/extension`.

Встроенная **команда `agent`** управляет устройством на **естественном языке** через любой OpenAI-совместимый API с вызовами инструментов, включая режим **vision**, а также **семантический исполнитель задач OpenAI**. Комбинируйте с **crontab** для запланированных ИИ-задач на реальных устройствах.

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/92639519cee4c07efbe1da1030a4107808841995e15962977a1364f22df70248.gif" alt="MCP" width="100%">
</p>

## Управление системой и расширения

**Более 160 Python API** охватывают операции с приложениями, ввод/вывод файлов, выполнение команд, состояние устройства, WiFi, прокси, OpenVPN, выключение/перезагрузку, журналы сервисов и многое другое. `setprop` может записывать свойства **`ro.*`**, доступные только для чтения; Settings API регулируют яркость, режим разработчика и т. д.; **SELinux** — создание доменов, permissive-режим и детальные разрешения/запреты. Полный набор API для нескольких экземпляров приложений, тихое предоставление/отзыв разрешений, запуск неэкспортируемых активностей, отключение приложений для экономии ресурсов.

**Бинарное патчирование** (hex-шаблоны, glob-пути, dryrun) и метрики времени выполнения для диска, батареи, CPU, памяти и сетевого ввода/вывода. Воспроизведение WAV и API внутреннего хранилища. **tflite-runtime** на устройстве с аппаратно-ускоренными вычислениями для инференса на периферии.

**Виртуальная среда Debian** запускает полноценный Debian с apt — компилируйте BPF, разворачивайте OpenSSH, устанавливайте произвольные Python-зависимости, выходя за пределы возможностей встроенного терминала.

## Развёртывание, безопасность и управление

Развёртывание через **приложение в один клик** (root или Shizuku), **автозапуск модуля Magisk**, ручное извлечение или **интеграцию в прошивку** — всё рассчитано на работу **24/7**. Приложение может **автоматически генерировать сертификаты сервиса**; zip-архивы Magisk могут содержать properties, lamda.pem и adb_keys. **INI-конфигурация сервиса** централизует порт, WebUI, сертификаты, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns и т. д.; WebUI предлагает визуальное редактирование, исходный текст и Reload Service, а также загрузку удалённых файлов конфигурации.

Идентичности root и shell; arm64, armeabi-v7a, x86, x86_64; реальные устройства, эмуляторы (LDPlayer, Nox и др.), Redroid, WSA, AVD, облачные телефоны. Чистые сценарии удаления. **Эксклюзивная блокировка API** предотвращает конфликты между клиентами. Политика конфиденциальности: никакого сбора контактов, SMS, геолокации и т. д.; поддерживается **офлайн-лицензирование**.

## Инструментарий и развитие

**Более шести лет** непрерывной разработки: исправления совместимости с Android 14–16 и постоянная работа над многопользовательским удалённым рабочим столом, стандартизированными touch-API, MCP, версиями Frida и скрытием, прокси IPv6/UDP, P2P Bridge и распределёнными задачами.

Сила FIRERPA не в какой-то одной функции, а в интеграции **удалённого рабочего стола (WebRTC/H.264/многопользовательский режим), UI-автоматизации (виртуальный дисплей, Watcher, OCR, сопоставление изображений, мультитач), захвата в один клик, встроенной Frida, полностекового прокси и VPN/frp/P2P, ADB/SSH/встроенного терминала, ИИ MCP/Agent, системного управления, виртуального Debian, постоянного KV-хранилища и шифрования скриптов** на одном Android-устройстве, одном сервисе и одном Python-клиенте — поэтому тестирование безопасности, комплаенс-анализ, восстановление протоколов, управление парком устройств и автоматизация работают в **едином конвейере**, а не через множество склеенных инструментов.