Plateforme de contrôle de périphériques Android Full-Stack : bureau à distance WebRTC/H.264, automatisation UI/OCR/reconnaissance d'images, MITM en un clic, Frida intégré, proxy/VPN/frp/réseau P2P, MCP/Agent, plus de 160 API, conçu pour clusters multi-appareils et déploiements techniques.
Documentation | 使用文档 | TELEGRAM | Groupe QQ | SKILLS | llms-full.txt | Version chinoise
FIRERPA est une plateforme de contrôle d'appareils Android tout-en-un. Le serveur s'exécute directement sur l'appareil sans dépendances d'exécution supplémentaires ; il prend en charge plusieurs générations d'Android et fonctionne avec ou sans root. Du côté PC, la bibliothèque cliente Python orchestre l'automatisation de l'interface utilisateur, les opérations à distance, la capture de trafic, le reverse engineering basé sur Hook, le proxy réseau, la mise en réseau distribuée, les agents IA et MCP via un seul service et une seule API. Par rapport à l'assemblage d'Appium, mitmproxy, frida-server, adb, uiautomator2 et de scripts et outils opérationnels ad hoc, FIRERPA offre une source de capacités, une configuration unifiée, des flux de travail connectés et une pile conçue pour une utilisation multi-appareils, longue durée et en production.
FIRERPA fournit un bureau à distance basé sur navigateur : visualisez et contrôlez l'appareil en temps réel sans installer de client PC dédié, via LAN ou à travers les réseaux. Le streaming prend en charge MJPEG et H.264, avec des backends de codage logiciel et matériel. La fréquence d'images (jusqu'à 60 ips), l'échelle de résolution, le débit binaire et la qualité peuvent être ajustés en fonction de la capacité de l'appareil et des conditions du réseau, réduisant la bande passante et améliorant la fluidité sur les liaisons faibles. WebRTC est également pris en charge, avec des serveurs STUN/TURN configurables pour une meilleure traversée NAT et une latence de bout en bout plus faible dans les configurations publiques ou interrégionales.
Le bureau à distance prend en charge l'accès concurrent multi-utilisateurs pour le débogage collaboratif, les démos et la formation. Le partage de presse-papiers bidirectionnel et l'audio en direct (Android 10+) sont inclus, ainsi qu'un terminal intégré, des téléchargements par glisser-déposer et la navigation et le téléchargement de fichiers via navigateur, le tout sur un seul port. L'inspection visuelle de la disposition intégrée met en évidence les éléments, prend en charge la navigation par Tab, affiche les coordonnées et les valeurs RVB et exporte l'arborescence XML de la disposition afin que vous puissiez valider les sélecteurs et la logique d'automatisation dans la même interface utilisateur, raccourcissant ainsi le cycle de l'écran au script.
Le bureau à distance et le RPC prennent en charge le TLS de bout en bout et le contrôle d'accès par certificat de service, avec des mots de passe de connexion WebUI personnalisés facultatifs pour réduire l'exposition sur les réseaux publics. Les capacités du bureau à distance peuvent également être intégrées dans vos propres applications web via WebSocket (vidéo en direct, tactile, terminal, touches, etc.), avec allow_origin pour l'intégration inter-origines, ce qui convient à la commercialisation du contrôle d'appareils réels.
FIRERPA fournit un système d'automatisation complet basé sur des sélecteurs : texte, resourceId, description, scrollable et autres correspondants courants, plus l'enchaînement enfant / frère pour les éléments en double, les hiérarchies profondes ou les contrôles sans attributs distinctifs. Au niveau de l'élément : captures d'écran, attente d'apparition/disparition, coordonnées de coin/centre, vérification d'existence, saisie Unicode, balayages progressifs, défilement par balayage, défilement jusqu'à la fin, etc. Il peut coexister avec d'autres services d'accessibilité sur Android 8.0+ et améliore la découverte de nœuds WebView pour les applications hybrides.
Le UI Watcher écoute les modifications de l'interface utilisateur en temps réel et exécute des clics, des événements clavier ou des compteurs lorsque les conditions correspondent, utile pour fermer automatiquement les accords, les invites de mise à jour, les publicités et autres interruptions. Plusieurs conditions de sélecteur et l'activation/désactivation par événement sont prises en charge ; les écrans transitoires peuvent être comptés.
Virtual Display est un différentiateur : créez des affichages d'arrière-plan isolés sur l'appareil et exécutez des applications et de l'automatisation sans affecter l'écran principal – par exemple, une réponse automatique sur un affichage virtuel pendant que vous utilisez le téléphone normalement. L'API d'affichage virtuel reflète l'API de l'appareil principal (d.xxx → vd.xxx) ; les Watchers peuvent être limités à un affichage virtuel. Le WebUI prend en charge la visualisation et le changement de plusieurs affichages dans le bureau à distance, idéal pour les tâches d'arrière-plan, le travail parallèle et l'automatisation humaine et machine.
Pour les scènes sans arborescence de vue standard (jeux, interface utilisateur personnalisée), FIRERPA propose l'OCR et la correspondance d'images. L'OCR prend en charge paddleocr, easyocr et des backends HTTP personnalisés ; dans les clusters, la reconnaissance peut être centralisée au lieu de charger des modèles sur chaque PC, avec accélération GPU et correspondance de texte flexible. La correspondance d'images s'exécute sur l'appareil (template ou SIFT), sans consommer de ressources PC ; SIFT est robuste à la rotation, à l'échelle et à l'éclairage. Le multi-tactile prend en charge l'enregistrement, la relecture, la construction programmatique et la persistance binaire pour les gestes complexes et la pression.
Sur le plan architectural, FIRERPA utilise un modèle client/serveur – meilleur pour la planification centralisée, le versionnage et le contrôle de flotte que les exécuteurs de scripts sur l'appareil comme AutoJS ; plus léger qu'Appium ; plus stable que uiautomator2 dans les scénarios multi-appareils. La documentation le positionne comme un sur-ensemble fonctionnel des piles d'automatisation Android courantes – l'automatisation, la capture, le Hook et les opérations peuvent être enchaînés dans le code sur une seule plateforme sans changer d'outils.
FIRERPA propose une capture MITM en un clic : installation automatique du CA racine système, configuration du proxy, gestion des différences de version Android et restauration automatique du réseau à la sortie – pas de basculement manuel du certificat ou du proxy. Capture globale, capture par paquet, édition en direct des requêtes/réponses, mitmweb partagé et proxy HTTP amont pour le trafic international sont pris en charge. La dégradation QUIC intégrée réduit les interférences QUIC. La capture fonctionne toujours lorsque le PC et l'appareil ne partagent qu'un seul port FIRERPA (par exemple, connexion ADB ou transfert frp).
Au-delà des scripts en un clic, MITM est entièrement piloté par API : installer/désinstaller les CA système compatibles avec mitmproxy, Fiddler, Charles, etc. ; intégrer la capture dans les pipelines d'automatisation aux côtés des étapes UI et des hooks Frida. Un startmitm.exe Windows est disponible sans installation Python.
Sur l'appareil, FIRERPA offre une prise en charge complète du proxy : HTTP / HTTPS / SOCKS5 / Shadowsocks (plusieurs chiffrements), proxy par application (y compris les clones multi-utilisateurs), proxy DNS, proxy UDP, contournement LAN, coexistence avec OpenVPN et connexion automatique aux proxys configurés au démarrage. Les proxys prennent en charge IPv6 et UDP pour les réseaux complexes.
Le proxy tunnel HTTP de l'appareil (tunnel2) fournit une capacité de proxy inverse : pointez votre proxy HTTP PC ou navigateur vers le téléphone et le trafic est transféré via la sortie réseau du téléphone ; l'IP sortante correspond au téléphone. L'interface Wi‑Fi ou cellulaire (rmnet) peut être choisie comme interface de sortie – utile pour le débogage conjoint, les applications internationales et les pools d'adresses IP multi-appareils.
Un client OpenVPN intégré prend en charge le certificat, le nom d'utilisateur/mot de passe et l'authentification mixte, aux côtés du proxy système ; une image Docker OpenVPN et des générateurs de configuration produisent du code côté appareil et des paramètres de démarrage automatique. Un client frp intégré transfère les services de l'appareil vers un serveur public via fwd.*, avec chiffrement et TLS.
La découverte mDNS permet l'accès {device_id}.local au bureau à distance et à d'autres services, avec des métadonnées TXT facultatives (modèle, ABI, ID d'appareil) pour la découverte de flotte LAN.
FIRERPA intègre la dernière version de Frida – pas de frida-server séparé. Utilisez les outils frida depuis le terminal du bureau à distance sans -U, -H, etc. Les correctifs de masquage intégrés (open source et internes) sont maintenus contre la détection ; les connexions utilisent l'authentification par jeton sur le port FIRERPA. Les correctifs objection et les assistants java-bridge Frida 17.x facilitent la migration.
Les scripts Frida persistants se réinjectent après un crash ou une sortie d'application ; persistance YAML hors ligne avec surveillance de répertoire et rechargement à chaud. Le RPC Frida mappe vers des méthodes Python et des appels distants HTTP + JSON-RPC 2.0 sur les threads JVM, UI principal ou JS pur. Les données emit du script peuvent aller vers HTTP / Redis / RabbitMQ (MQTT) avec des métadonnées d'appareil/application, une compression zlib, des tentatives HTTP et TLS MQTT.
FIRERPA inclut un ADB intégré autonome – ADB sans fil à privilège élevé sans activer les Options Développeur système, utile lorsque les applications détectent le mode développeur. Les modules Magisk peuvent préinstaller adb_keys pour l'autorisation par défaut. SSH intégré plus ssh.sh / scp.sh pour un shell à distance et un transfert de fichiers.
Le terminal intégré est livré avec strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper et des piles Python telles que Crypto, cv2, unicorn, capstone, keystone, redis et grpc. sqlite3 prend en charge wxsqlite / sqlcipher / sqlcrypto pour lire les bases de données chiffrées d'applications telles que WeChat, WeCom et les clients de la famille Alibaba. Un seul environnement sur le bureau à distance, SSH et ADB – analysez et contrôlez sur l'appareil avec moins de va-et-vient PC.
FIRERPA StarLink Platform (Hub + hub-bridge) fournit un accès multi-appareils centralisé pour les appareils locaux et distants avec une gestion unifiée et un accès P2P – idéal pour « appareil à la maison, opérateur ailleurs » et la collaboration multi-appareils. hub v3 utilise SAPI pour des requêtes unifiées vers les appareils locaux et distants. Outre Hub, le transfert frp et le maillage OpenVPN sont également pris en charge comme options auto-hébergées, avec une documentation complète et un support Docker.
Depuis la version 9.0, la connectivité P2P Bridge entre pairs et un système de tâches distribué intégré sont pris en charge ; depuis la version 7.50, un service d'abonnement réseau est disponible afin que vous n'ayez pas à auto-héberger frp/OpenVPN. Conçu pour les pools de téléphones cloud, les fermes d'appareils et les clusters d'émulateurs – appareils par lots, toujours allumés, sans surveillance fonctionnement.
FIRERPA inclut un serveur MCP (/mcp/) sur streamable-http, avec appels d'outils, lectures de ressources, invites, notifications de progression et journaux – compatible avec Claude, Cursor et d'autres clients MCP. Les extensions MCP officielles se trouvent sous ~/modules/extension.
La commande intégrée agent pilote l'appareil en langage naturel via toute API compatible OpenAI avec appels d'outils, y compris le mode vision, plus un exécuteur de tâches sémantiques OpenAI. Combinez avec crontab pour des tâches IA planifiées sur des appareils réels.
160+ APIs Python couvrent les opérations d'applications, les entrées/sorties de fichiers, l'exécution de commandes, l'état de l'appareil, le WiFi, le proxy, OpenVPN, l'arrêt/redémarrage, les journaux de service, etc. setprop peut écrire les propriétés en lecture seule ro.* ; les API de réglages ajustent la luminosité, le mode développeur, etc. ; création de domaine SELinux, mode permissif et autorisation/interdiction fine. API complètes pour les instances multiples d'applications, octroi/révocation silencieuse des autorisations, lancement d'activités non exportées, désactivation d'applications pour économiser les ressources.
Correction binaire (wildcards hexadécimaux, chemins glob, dryrun) et métriques d'exécution pour le disque, la batterie, le CPU, la mémoire et les E/S réseau. Lecture WAV et API de stockage interne. tflite-runtime sur l'appareil avec calcul accéléré matériellement pour l'inférence en périphérie.
Un environnement Debian virtuel exécute un Debian complet avec apt – compilez BPF, déployez OpenSSH, installez des dépendances Python arbitraires au-delà des limites du terminal intégré.
Déployez via application en un clic (root ou Shizuku), démarrage automatique du module Magisk, extraction manuelle ou intégration ROM – conçu pour un fonctionnement 24h/24 et 7j/7. L'application peut générer automatiquement des certificats de service ; les zips Magisk peuvent transporter des propriétés, lamda.pem et adb_keys. Configuration de service INI centralise le port, le WebUI, les certificats, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns, etc. ; le WebUI offre une édition visuelle, du texte brut et un rechargement de service, plus un chargement de fichier de configuration à distance.
Identités root et shell ; arm64, armeabi-v7a, x86, x86_64 ; appareils réels, émulateurs (LDPlayer, Nox, etc.), Redroid, WSA, AVD, téléphones cloud. Chemins de désinstallation propres. Verrouillage exclusif de l'API empêche la contention des clients. Politique de confidentialité : aucune collecte de contacts, SMS, localisation, etc. ; licence hors ligne prise en charge.
Plus de six ans de développement continu, avec des correctifs de compatibilité Android 14–16 et un travail en cours sur le bureau à distance multi-utilisateurs, les API tactiles standardisées, MCP, les versions Frida et la furtivité, le proxy IPv6/UDP, le P2P Bridge et les tâches distribuées.
La force de FIRERPA n'est pas une seule fonctionnalité mais l'intégration du bureau à distance (WebRTC/H.264/multi-utilisateur), de l'automatisation UI (affichage virtuel, Watcher, OCR, correspondance d'images, multi-tactile), de la capture en un clic, de Frida intégré, du proxy complet et VPN/frp/P2P, d'ADB/SSH/terminal intégré, de l'IA MCP/Agent, du contrôle au niveau système, du Debian virtuel, du KV persistant et du chiffrement de script sur un seul appareil Android, un seul service et un seul client Python – afin que les tests de sécurité, l'analyse de conformité, la récupération de protocole, la gestion de flotte et l'automatisation s'exécutent en un seul pipeline au lieu de nombreux outils collés ensemble.
