Piattaforma di controllo dispositivo Android full-stack: desktop remoto WebRTC/H.264, automazione UI/OCR/ricerca immagini, MITM con un clic, Frida integrato, rete proxy/VPN/frp/P2P, MCP/Agent, 160+ API, progettata per cluster multi-dispositivo e distribuzioni ingegnerizzate.
Documentazione | 使用文档 | TELEGRAM | QQ Group | SKILLS | llms-full.txt | 中文版本
FIRERPA è una piattaforma di controllo dispositivi Android tutto-in-uno. Il server viene eseguito direttamente sul dispositivo senza dipendenze runtime aggiuntive; supporta più generazioni di Android e funziona con o senza root. Lato PC, la libreria client Python orchestra automazione UI, operazioni remote, cattura del traffico, reverse engineering tramite Hook, proxy di rete, rete distribuita, agenti IA e MCP attraverso un unico servizio e API. Rispetto all'assemblaggio di Appium, mitmproxy, frida-server, adb, uiautomator2 e script e strumenti operativi ad-hoc, FIRERPA offre un'unica fonte di capacità, configurazione unificata, flussi di lavoro connessi e uno stack costruito per uso produttivo multi-dispositivo e a lunga esecuzione.
FIRERPA fornisce un desktop remoto basato su browser: visualizza e controlla il dispositivo in tempo reale senza installare un client PC dedicato, in LAN o attraverso reti. Lo streaming supporta sia MJPEG che H.264, con backend di codifica software e hardware. La frequenza dei fotogrammi (fino a 60fps), la scala di risoluzione, il bitrate e la qualità possono essere regolati in base alle capacità del dispositivo e alle condizioni di rete, riducendo la larghezza di banda e migliorando la scorrevolezza su collegamenti deboli. WebRTC è anche supportato, con server STUN/TURN configurabili per una migliore traversata NAT e latenza end-to-end ridotta in configurazioni pubbliche o cross-regione.
Il desktop remoto supporta l'accesso concorrente multi-utente per debug collaborativi, demo e formazione. Sono inclusi condivisione bidirezionale degli appunti e audio live (Android 10+), insieme a un terminale integrato, upload tramite trascinamento, navigazione e download di file basati su browser – tutto su una singola porta. L'ispezione visiva del layout integrata evidenzia gli elementi, supporta la navigazione tramite Tab, mostra coordinate e valori RGB ed esporta l'albero XML del layout in modo da poter validare selettori e logiche di automazione nella stessa interfaccia, accorciando il ciclo dallo schermo allo script.
Il desktop remoto e le RPC supportano TLS end-to-end e controllo degli accessi tramite certificato di servizio, con facoltativa password di login WebUI personalizzata per ridurre l'esposizione su reti pubbliche. Le capacità del desktop remoto possono anche essere integrate nelle tue applicazioni web tramite WebSocket (video live, tocco, terminale, tasti, ecc.), con allow_origin per l'integrazione cross-origin – adatto per rendere produttivo il controllo di dispositivi reali.
FIRERPA fornisce un sistema di automazione completo basato su selettori: testo, resourceId, descrizione, scorrevole e altri matcher comuni, oltre a concatenamento figlio / fratello per elementi duplicati, gerarchie profonde o controlli senza attributi distintivi. A livello di elemento: screenshot, attesa per apparizione/scomparsa, coordinate angolo/centro, controllo esistenza, input Unicode, swipe graduali, scorrimento a scatti, scroll-to-end e altro. Può coesistere con altri servizi di accessibilità su Android 8.0+ e migliora il rilevamento dei nodi WebView per app ibride.
Il UI Watcher ascolta le modifiche UI in tempo reale ed esegue click, eventi chiave o contatori quando le condizioni coincidono – utile per chiudere automaticamente accordi, promemoria di aggiornamento, pubblicità e altre interruzioni. Sono supportate condizioni di selettore multiplo e abilitazione/disabilitazione per evento; schermate transitorie possono essere contate.
Virtual Display è un elemento di differenziazione: crea display di sfondo isolati sul dispositivo ed esegui app e automazione lì senza influenzare lo schermo principale – ad esempio, risposte automatiche su un display virtuale mentre usi il telefono normalmente. L'API del display virtuale rispecchia l'API del dispositivo principale (d.xxx → vd.xxx); i Watcher possono essere limitati a un display virtuale. La WebUI supporta visualizzazione multi-display e commutazione nel desktop remoto – ideale per attività in background, lavoro parallelo e automazione human-in-the-loop più machine.
Per scene senza un albero di viste standard (giochi, UI disegnate su misura), FIRERPA offre OCR e corrispondenza immagini. L'OCR supporta paddleocr, easyocr e backend HTTP personalizzati; nei cluster, il riconoscimento può essere eseguito centralmente invece di caricare modelli su ogni PC, con accelerazione GPU e corrispondenza testo flessibile. La corrispondenza immagini viene eseguita sul dispositivo (template o SIFT), senza consumare risorse del PC; SIFT è robusto a rotazione, scala e illuminazione. Multi-touch supporta registrazione, riproduzione, costruzione programmatica e persistenza binaria per gesti complessi e pressione.
Architettonicamente, FIRERPA utilizza un modello client/server – migliore per pianificazione centralizzata, versioning e controllo flotta rispetto a esecutori di script sul dispositivo come AutoJS; più leggero di Appium; più stabile di uiautomator2 in scenari multi-dispositivo. La documentazione lo posiziona come un superset funzionale degli stack di automazione Android comuni – automazione, cattura, Hook e operazioni possono essere concatenate in codice su una piattaforma senza cambiare strumenti.
FIRERPA offre cattura MITM con un clic: installazione automatica del CA di sistema root, configurazione proxy, gestione delle differenze di versione Android e ripristino automatico della rete all'uscita – nessuna attivazione manuale di certificati o proxy. Sono supportati cattura globale, cattura per pacchetto, modifica live di richieste/risposte, mitmweb condiviso e proxy HTTP upstream per traffico internazionale. Il downgrade QUIC integrato riduce l'interferenza QUIC. La cattura funziona ancora quando PC e dispositivo condividono una singola porta FIRERPA (ad esempio connessione ADB o forwarding frp).
Oltre agli script con un clic, MITM è completamente guidato da API: installa/disinstalla CA di sistema compatibili con mitmproxy, Fiddler, Charles, ecc.; integra la cattura nelle pipeline di automazione insieme a passaggi UI e hook Frida. È disponibile un startmitm.exe per Windows senza installazione Python.
Sul dispositivo, FIRERPA fornisce pieno supporto proxy: HTTP / HTTPS / SOCKS5 / Shadowsocks (molteplici cifrari), proxy per app (incluse cloni multi-utente), proxy DNS, proxy UDP, bypass LAN, coesistenza con OpenVPN e connessione automatica ai proxy configurati all'avvio. I proxy supportano IPv6 e UDP per reti complesse.
Device HTTP bridge proxy (tunnel2) fornisce capacità di proxy inverso: punta il proxy HTTP del tuo PC o browser verso il telefono e il traffico viene inoltrato attraverso l'uscita di rete del telefono; l'IP in uscita corrisponde al telefono. Wi‑Fi o cellulare (rmnet) possono essere scelti come interfaccia di uscita – utile per debug congiunti, app internazionali e pool di IP multi-dispositivo.
Un client OpenVPN integrato supporta autenticazione con certificato, nome utente/password e mista, insieme al proxy di sistema; un'immagine Docker OpenVPN e generatori di configurazione producono codice lato dispositivo e impostazioni di avvio automatico. Un client frp integrato inoltra i servizi del dispositivo a un server pubblico tramite fwd.*, con crittografia e TLS.
mDNS discovery consente l'accesso {device_id}.local al desktop remoto e ad altri servizi, con metadati TXT opzionali (modello, ABI, ID dispositivo) per la scoperta della flotta in LAN.
FIRERPA include l'ultima versione di Frida – nessun frida-server separato. Utilizza gli strumenti frida dal terminale del desktop remoto senza -U, -H, ecc. Le patch di occultamento integrate (open-source più interne) sono mantenute contro il rilevamento; le connessioni utilizzano autenticazione tramite token sulla porta FIRERPA. Le patch di objection e gli helper java-bridge di Frida 17.x facilitano la migrazione.
Script Frida persistenti si reiniettano dopo il crash o la chiusura dell'app; persistenza YAML offline con watch di directory e hot reload. Le RPC Frida si mappano a metodi Python e chiamate remote HTTP + JSON-RPC 2.0 su thread JVM, UI main o JS puri. I dati emit dello script possono andare a HTTP / Redis / RabbitMQ (MQTT) con metadati dispositivo/app, compressione zlib, retry HTTP e TLS MQTT.
FIRERPA include un ADB integrato autonomo – ADB wireless ad alta privilegio senza abilitare le Opzioni Sviluppatore di sistema, utile quando le app rilevano la modalità sviluppatore. I moduli Magisk possono preinstallare adb_keys per l'autorizzazione predefinita. SSH integrato più ssh.sh / scp.sh per shell remota e trasferimento file.
Il terminale integrato include strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper e stack Python come Crypto, cv2, unicorn, capstone, keystone, redis e grpc. sqlite3 supporta wxsqlite / sqlcipher / sqlcrypto per leggere database crittografati da app come WeChat, WeCom e client della famiglia Alibaba. Un unico ambiente attraverso desktop remoto, SSH e ADB – analizza e controlla sul dispositivo con meno spostamenti sul PC.
FIRERPA StarLink Platform (Hub + hub-bridge) fornisce accesso multi-dispositivo centralizzato per dispositivi locali e remoti con gestione unificata e accesso P2P – ideale per "dispositivo a casa, operatore altrove" e collaborazione multi-dispositivo. hub v3 utilizza SAPI per richieste unificate a dispositivi locali e remoti. Oltre a Hub, sono supportati anche inoltro frp e rete mesh OpenVPN come opzioni self-hosted, con documentazione completa e supporto Docker.
Dalla versione 9.0, sono supportati la connettività peer P2P Bridge e un sistema di attività distribuite integrato; dalla versione 7.50, è disponibile un servizio di abbonamento di rete in modo da non dover auto-ospitare frp/OpenVPN. Progettato per pool di telefoni cloud, farm di dispositivi e cluster di emulatori – dispositivi batch, sempre accesi, senza sorveglianza.
FIRERPA include un server MCP (/mcp/) su streamable-http, con chiamate a strumenti, letture di risorse, prompt, notifiche di avanzamento e log – compatibile con Claude, Cursor e altri client MCP. Le estensioni MCP ufficiali risiedono in ~/modules/extension.
Il comando agent integrato guida il dispositivo in linguaggio naturale tramite qualsiasi API compatibile con OpenAI con chiamate a strumenti, incluso la modalità vision, più un esecutore di attività semantiche OpenAI. Combinalo con crontab per attività AI programmate su dispositivi reali.
160+ API Python coprono operazioni sulle app, I/O file, esecuzione comandi, stato dispositivo, WiFi, proxy, OpenVPN, spegnimento/riavvio, log di servizio e altro. setprop può scrivere proprietà di sola lettura ro.*; le API Impostazioni regolano luminosità, modalità sviluppatore, ecc.; dominio SELinux creazione, modalità permissiva e consentito/non consentito granulare. API complete per istanze multiple di app, concessione/revoca silenziosa di permessi, avvio di attività non esportate, disabilitazione di app per risparmiare risorse.
Patching binario (wildcard esadecimali, percorsi glob, dryrun) e metriche runtime per disco, batteria, CPU, memoria e I/O di rete. Riproduzione WAV e API di archiviazione interna. tflite-runtime sul dispositivo con calcolo accelerato hardware per inferenza edge.
Un ambiente Debian virtuale esegue Debian completo con apt – compila BPF, distribuisci OpenSSH, installa dipendenze Python arbitrarie oltre i limiti del terminale integrato.
Distribuisci tramite APP con un clic (root o Shizuku), avvio automatico modulo Magisk, estrazione manuale o integrazione nella ROM – progettato per funzionamento 24/7. L'APP può generare automaticamente certificati di servizio; gli zip Magisk possono includere proprietà, lamda.pem e adb_keys. Configurazione servizio INI centralizza porta, WebUI, certificati, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns, ecc.; La WebUI offre modifica visiva, testo grezzo e Ricarica Servizio, oltre a caricamento file di configurazione remota.
Identità root e shell; arm64, armeabi-v7a, x86, x86_64; dispositivi reali, emulatori (LDPlayer, Nox, ecc.), Redroid, WSA, AVD, telefoni cloud. Percorsi di disinstallazione puliti. Blocco esclusivo API previene la contesa tra client. Politica sulla privacy: nessuna raccolta di contatti, SMS, posizione, ecc.; licenze offline supportate.
Oltre sei anni di sviluppo continuo, con correzioni di compatibilità per Android 14–16 e lavoro in corso su desktop remoto multi-utente, API touch standardizzate, MCP, versioni Frida e furtività, proxy IPv6/UDP, P2P Bridge e attività distribuite.
Il punto di forza di FIRERPA non è una singola funzionalità, ma l'integrazione di desktop remoto (WebRTC/H.264/multi-utente), automazione UI (display virtuale, Watcher, OCR, corrispondenza immagini, multi-touch), cattura con un clic, Frida integrato, proxy full-stack e VPN/frp/P2P, ADB/SSH/terminale integrato, AI MCP/Agente, controllo a livello di sistema, Debian virtuale, KV persistente e crittografia degli script su un singolo dispositivo Android, un servizio e un client Python – così che test di sicurezza, analisi di conformità, recupero di protocolli, gestione della flotta e automazione siano eseguiti in un'unica pipeline invece che in molti strumenti incollati insieme.
