Платформа полного цикла управления Android-устройствами: удалённый рабочий стол на WebRTC/H.264, автоматизация UI/OCR/сопоставления изображений, MITM в один клик, встроенный Frida, сеть через proxy/VPN/frp/P2P, MCP/Agent, 160+ API, разработана для кластеров из нескольких устройств и инженерных развёртываний.
Документация | 使用文档 | TELEGRAM | QQ Group | SKILLS | llms-full.txt | 中文版本
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-дерево макета, чтобы вы могли проверять селекторы и логику автоматизации в том же интерфейсе, сокращая путь от экрана до скрипта.
Удалённый рабочий стол и RPC поддерживают сквозной TLS и контроль доступа по сертификатам сервиса, с опциональными собственными паролями входа в WebUI для снижения рисков в публичных сетях. Возможности удалённого рабочего стола также можно встраивать в собственные веб-приложения через WebSocket (живое видео, касания, терминал, клавиши и т. д.) с параметром allow_origin для кросс-доменной интеграции — это подходит для создания продуктов на базе управления реальными устройствами.
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 и эксплуатация могут выстраиваться в цепочки в коде на одной платформе без смены инструментов.
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 устройства) для обнаружения парка устройств в локальной сети.
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.
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. Спроектировано для пулов облачных телефонов, ферм устройств и кластеров эмуляторов — пакетная работа с устройствами, круглосуточно, без участия человека.
FIRERPA включает MCP-сервер (/mcp/) на streamable-http с вызовами инструментов, чтением ресурсов, промптами, уведомлениями о прогрессе и журналами — совместим с Claude, Cursor и другими MCP-клиентами. Официальные MCP-расширения находятся в ~/modules/extension.
Встроенная команда agent управляет устройством на естественном языке через любой OpenAI-совместимый API с вызовами инструментов, включая режим vision, а также семантический исполнитель задач OpenAI. Комбинируйте с crontab для запланированных ИИ-задач на реальных устройствах.
Более 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-клиенте — поэтому тестирование безопасности, комплаенс-анализ, восстановление протоколов, управление парком устройств и автоматизация работают в едином конвейере, а не через множество склеенных инструментов.
