Android Full-Stack-Gerätesteuerungsplattform: WebRTC/H.264-Remote-Desktop, UI/OCR/Bildabgleich-Automatisierung, Ein-Klick-MITM, integriertes Frida, Proxy/VPN/frp/P2P-Netzwerk, MCP/Agent, 160+ APIs, ausgelegt für Multi-Geräte-Cluster und technische Bereitstellungen.
Dokumentation | 使用文档 | TELEGRAM | QQ Group | SKILLS | llms-full.txt | 中文版本
FIRERPA ist eine All-in-One-Plattform zur Steuerung von Android-Geräten. Der Server läuft direkt auf dem Gerät, ohne zusätzliche Laufzeitabhängigkeiten; er unterstützt mehrere Android-Generationen und funktioniert mit oder ohne Root. Auf der PC-Seite orchestriert die Python-Client-Bibliothek UI-Automatisierung, Remote-Operationen, Traffic-Mitschnitt, Hook-basiertes Reverse Engineering, Netzwerk-Proxy, verteiltes Networking, KI-Agenten und MCP über einen einzigen Dienst und eine einzige API. Im Vergleich zum Zusammensetzen von Appium, mitmproxy, frida-server, adb, uiautomator2 und Ad-hoc-Skripten und Betriebswerkzeugen bietet FIRERPA eine Quelle an Fähigkeiten, einheitliche Konfiguration, verbundene Workflows und einen Stack, der für den Mehrgeräte-, Langzeit- und Produktionseinsatz ausgelegt ist.
FIRERPA bietet einen browserbasierten Remote-Desktop: Echtzeit-Ansicht und -Steuerung des Geräts ohne Installation eines dedizierten PC-Clients, über LAN oder über Netzwerke hinweg. Streaming unterstützt sowohl MJPEG als auch H.264, mit Software- und Hardware-Kodierungs-Backends. Bildrate (bis zu 60 fps), Auflösungsskalierung, Bitrate und Qualität können an die Gerätefähigkeiten und Netzwerkbedingungen angepasst werden – was die Bandbreite reduziert und die Laufruhe bei schwachen Verbindungen verbessert. WebRTC wird ebenfalls unterstützt, mit konfigurierbaren STUN/TURN-Servern für bessere NAT-Überwindung und geringere Ende-zu-Ende-Latenz in öffentlichen oder gebietsübergreifenden Konfigurationen.
Der Remote-Desktop unterstützt Mehrbenutzer-Gleichzeitzugriff für kollaboratives Debugging, Demos und Schulungen. Bidirektionale Zwischenablage und Live-Audio (Android 10+) sind enthalten, zusammen mit integrierter Terminal-, Drag-and-Drop-Upload- und browserbasierter Dateiansicht und -Download – alles über einen einzigen Port. Die integrierte visuelle Layout-Inspektion hebt Elemente hervor, unterstützt Tab-Navigation, zeigt Koordinaten und RGB-Werte an und exportiert den XML-Layoutbaum, sodass Sie Selektoren und Automatisierungslogik in derselben Benutzeroberfläche validieren können, was den Zyklus von Bildschirm zu Skript verkürzt.
Remote-Desktop und RPC unterstützen Ende-zu-Ende-TLS und dienstzertifikatsbasierte Zugriffskontrolle, mit optionalen benutzerdefinierten WebUI-Login-Passwörtern, um die Exposition in öffentlichen Netzwerken zu reduzieren. Remote-Desktop-Funktionen können auch über WebSocket (Live-Video, Touch, Terminal, Tasten usw.) in Ihre eigenen Web-Apps eingebettet werden, mit allow_origin für Cross-Origin-Integration – geeignet für die Produktisierung der Echtgerätesteuerung.
FIRERPA bietet ein vollständiges selektorbasiertes Automatisierungssystem: Text, resourceId, Beschreibung, scrollbar und andere gängige Matcher, plus Kind-/Geschwister-Verkettung für doppelte Elemente, tiefe Hierarchien oder Steuerelemente ohne eindeutige Attribute. Auf Elementebene: Screenshots, Warten auf Erscheinen/Verschwinden, Eck-/Mittelkoordinaten, Existenzprüfung, Unicode-Eingabe, gestufte Wischbewegungen, Fling-Scrolling, Scrollen bis zum Ende und mehr. Es kann mit anderen Barrierefreiheitsdiensten auf Android 8.0+ koexistieren und verbessert die WebView-Knotenerkennung für hybride Apps.
Der UI Watcher überwacht UI-Änderungen in Echtzeit und führt Klicks, Tasteneingaben oder Zähler aus, wenn Bedingungen zutreffen – nützlich zum automatischen Schließen von Zustimmungen, Update-Aufforderungen, Werbung und anderen Unterbrechungen. Mehrere Selektorbedingungen und Aktivieren/Deaktivieren pro Ereignis werden unterstützt; vorübergehende Bildschirme können gezählt werden.
Virtual Display ist ein Alleinstellungsmerkmal: Erstellen Sie isolierte Hintergrunddisplays auf dem Gerät und führen Sie dort Apps und Automatisierung aus, ohne den Hauptbildschirm zu beeinträchtigen – z. B. automatische Antwort auf einem virtuellen Display, während Sie das Telefon normal nutzen. Die Virtual-Display-API spiegelt die Hauptgeräte-API wider (d.xxx → vd.xxx); Watcher können auf ein virtuelles Display beschränkt werden. Das WebUI unterstützt Mehrdisplay-Ansicht und -Umschaltung im Remote-Desktop – ideal für Hintergrundaufgaben, parallele Arbeit und Mensch-in-der-Schleife plus Maschinenautomatisierung.
Für Szenen ohne Standard-View-Tree (Spiele, benutzerdefinierte UI) bietet FIRERPA OCR und Bildabgleich. OCR unterstützt paddleocr, easyocr und benutzerdefinierte HTTP-Backends; in Clustern kann die Erkennung zentral laufen, anstatt Modelle auf jedem PC zu laden, mit GPU-Beschleunigung und flexiblem Textabgleich. Der Bildabgleich läuft auf dem Gerät (Template oder SIFT), ohne PC-Ressourcen zu verbrauchen; SIFT ist robust gegenüber Rotation, Skalierung und Beleuchtung. Multi-Touch unterstützt Aufnahme, Wiedergabe, programmatischen Aufbau und binäre Persistenz für komplexe Gesten und Druck.
Architektonisch verwendet FIRERPA ein Client/Server-Modell – besser für zentralisierte Planung, Versionierung und Flottensteuerung als On-Device-Script-Runner wie AutoJS; leichter als Appium; stabiler als uiautomator2 in Mehrgeräteszenarien. Die Dokumentation positioniert es als funktionales Superset gängiger Android-Automatisierungsstacks – Automatisierung, Mitschnitt, Hook und Betrieb können in einem Code auf einer Plattform verknüpft werden, ohne Werkzeuge wechseln zu müssen.
FIRERPA bietet Ein-Klick-MITM-Mitschnitt: automatische Systemstammzertifikatsinstallation, Proxy-Einrichtung, Handhabung von Android-Versionsunterschieden und automatische Netzwerkwiederherstellung beim Beenden – kein manuelles Zertifikat oder Proxy-Umschalten. Globaler Mitschnitt, paketweiser Mitschnitt, Live-Anforderungs-/Antwortbearbeitung, gemeinsames mitmweb und vorgeschalteter HTTP-Proxy für internationalen Verkehr werden unterstützt. Der eingebaute QUIC-Downgrade reduziert QUIC-Interferenzen. Der Mitschnitt funktioniert auch dann, wenn PC und Gerät nur einen einzigen FIRERPA-Port gemeinsam nutzen (z. B. ADB-Connect oder frp-Weiterleitung).
Neben Ein-Klick-Skripten ist MITM vollständig API-gesteuert: Installieren/Deinstallieren von System-CAs, kompatibel mit mitmproxy, Fiddler, Charles usw.; Einbetten von Mitschnitt in Automatisierungspipelines zusammen mit UI-Schritten und Frida-Hooks. Ein Windows startmitm.exe ist ohne Python-Installation verfügbar.
Auf dem Gerät bietet FIRERPA vollständige Proxy-Unterstützung: HTTP / HTTPS / SOCKS5 / Shadowsocks (mehrere Chiffren), App-spezifischer Proxy (auch für Mehrbenutzer-Klone), DNS-Proxy, UDP-Proxy, LAN-Umgehung, Koexistenz mit OpenVPN und automatische Verbindung zu konfigurierten Proxys beim Start. Proxys unterstützen IPv6 und UDP für komplexe Netzwerke.
Device HTTP Bridge Proxy (tunnel2) bietet Reverse-Proxy-Funktionalität: Richten Sie Ihren PC- oder Browser-HTTP-Proxy auf das Telefon, und der Datenverkehr wird über das Netzwerkausgang des Telefons weitergeleitet; die ausgehende IP stimmt mit dem Telefon überein. Wi‑Fi oder Mobilfunk (rmnet) können als Ausgangsschnittstelle gewählt werden – nützlich für gemeinsames Debugging, internationale Apps und Mehrgeräte-IP-Pools.
Ein eingebauter OpenVPN-Client unterstützt Zertifikats-, Benutzername/Passwort- und gemischte Authentifizierung, zusammen mit System-Proxy; ein OpenVPN-Docker-Image und Konfigurationsgeneratoren erstellen geräteseitigen Code und Autostart-Einstellungen. Ein eingebauter frp-Client leitet Gerätedienste über fwd.* an einen öffentlichen Server weiter, mit Verschlüsselung und TLS.
mDNS-Erkennung ermöglicht den Zugriff auf Remote-Desktop und andere Dienste unter {device_id}.local, mit optionalen TXT-Metadaten (Modell, ABI, Geräte-ID) für die LAN-Flottenentdeckung.
FIRERPA bündelt die neueste Frida – kein separates frida-server notwendig. Verwenden Sie Frida-Tools aus dem Remote-Desktop-Terminal ohne -U, -H usw. Eingebaute Versteck-Patches (Open-Source plus eigene) werden gegen Erkennung gewartet; Verbindungen verwenden Token-Authentifizierung über den FIRERPA-Port. objection-Patches und Frida 17.x java-bridge-Hilfen erleichtern die Migration.
Persistente Frida-Skripte werden nach einem App-Absturz oder -Beenden erneut injiziert; YAML-Offline-Persistenz mit Überwachung des Verzeichnisses und Hot-Reload. Frida RPC wird auf Python-Methoden und HTTP + JSON-RPC 2.0 Remote-Aufrufe auf JVM-, UI-Main- oder reinen JS-Threads abgebildet. Skript-emit-Daten können an HTTP / Redis / RabbitMQ (MQTT) mit Geräte-/App-Metadaten, zlib-Kompression, HTTP-Wiederholungen und MQTT-TLS gesendet werden.
FIRERPA enthält ein eigenständiges eingebautes ADB – drahtloses ADB mit hohen Berechtigungen ohne Aktivieren der System-Entwickleroptionen, nützlich, wenn Apps den Entwicklermodus erkennen. Magisk-Module können adb_keys für die Standardautorisierung vorinstallieren. Eingebautes SSH plus ssh.sh / scp.sh für entfernte Shell und Dateiübertragung.
Das eingebaute Terminal wird mit strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper und Python-Stacks wie Crypto, cv2, unicorn, capstone, keystone, redis und grpc ausgeliefert. sqlite3 unterstützt wxsqlite / sqlcipher / sqlcrypto zum Lesen verschlüsselter Datenbanken von Apps wie WeChat, WeCom und Alibaba-Familien-Clients. Eine Umgebung über Remote-Desktop, SSH und ADB hinweg – analysieren und steuern Sie auf dem Gerät mit weniger PC-Wechseln.
FIRERPA StarLink Platform (Hub + hub-bridge) bietet zentralen Mehrgerätezugriff für lokale und entfernte Geräte mit einheitlichem Management und P2P-Zugriff – ideal für „Gerät zu Hause, Bediener woanders“ und Mehrgeräte-Kollaboration. Hub v3 verwendet SAPI für einheitliche Anfragen an lokale und entfernte Geräte. Neben Hub werden auch frp-Weiterleitung und OpenVPN-Mesh als selbstgehostete Optionen unterstützt, mit vollständiger Dokumentation und Docker-Unterstützung.
Seit 9.0 werden P2P Bridge Peer-Konnektivität und ein eingebautes verteiltes Aufgabensystem unterstützt; seit 7.50 ist ein Netzwerkabonnementdienst verfügbar, sodass Sie kein frp/OpenVPN selbst hosten müssen. Entwickelt für Cloud-Telefonpools, Gerätefarmen und Emulator-Cluster – Batch-Geräte, dauerhaft, unbeaufsichtigt.
FIRERPA enthält einen MCP-Server (/mcp/) auf streamable-http, mit Tool-Aufrufen, Ressourcen-Lesevorgängen, Aufforderungen, Fortschrittsbenachrichtigungen und Protokollen – kompatibel mit Claude, Cursor und anderen MCP-Clients. Offizielle MCP-Erweiterungen befinden sich unter ~/modules/extension.
Der eingebaute agent-Befehl steuert das Gerät in natürlicher Sprache über eine beliebige OpenAI-kompatible API mit Tool-Aufrufen, einschließlich Vision-Modus, plus einem OpenAI semantischen Aufgabenausführer. Kombinieren Sie es mit crontab für geplante KI-Aufgaben auf echten Geräten.
160+ Python-APIs decken App-Operationen, Datei-I/O, Befehlsausführung, Gerätestatus, WLAN, Proxy, OpenVPN, Herunterfahren/Neustart, Dienstprotokolle und mehr ab. setprop kann ro.*-Schreibgeschützte Eigenschaften schreiben; Settings-APIs passen Helligkeit, Entwicklermodus usw. an; SELinux-Domain-Erstellung, permissiver Modus und fein abgestufte Erlauben/Verbieten. Vollständige Multi-Instanz-App-APIs, stilles Erteilen/Widerrufen von Berechtigungen, Starten nicht exportierter Aktivitäten, Deaktivieren von Apps zur Ressourcenschonung.
Binary-Patching (Hex-Wildcards, Glob-Pfade, Trockenlauf) und Laufzeitmetriken für Festplatte, Akku, CPU, Speicher und Netzwerk-I/O. WAV-Wiedergabe und interne Speicher-APIs. On-Device tflite-runtime mit hardwarebeschleunigter Berechnung für Edge-Inferenz.
Eine virtuelle Debian-Umgebung führt vollwertiges Debian mit apt aus – kompilieren Sie BPF, stellen Sie OpenSSH bereit, installieren Sie beliebige Python-Abhängigkeiten über die Grenzen des eingebauten Terminals hinaus.
Bereitstellung per Ein-Klick-APP (Root oder Shizuku), Magisk-Modul-Autostart, manuelles Extrahieren oder ROM-Integration – ausgelegt für 24/7-Betrieb. Die APP kann automatisch Dienstzertifikate generieren; Magisk-Zips können Eigenschaften, lamda.pem und adb_keys mitliefern. INI-Dienstkonfiguration zentralisiert Port, WebUI, Zertifikate, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns usw.; WebUI bietet visuelle Bearbeitung, Rohtext und Dienstneustart, plus Remote-Konfigurationsdatei-Laden.
Root- und Shell-Identitäten; arm64, armeabi-v7a, x86, x86_64; echte Geräte, Emulatoren (LDPlayer, Nox usw.), Redroid, WSA, AVD, Cloud-Telefone. Saubere Deinstallationspfade. API-exklusive Sperre verhindert Client-Konflikte. Datenschutzrichtlinie: keine Erfassung von Kontakten, SMS, Standort usw.; Offline-Lizenzierung unterstützt.
Sechs Jahre und mehr kontinuierliche Entwicklung, mit Android 14–16-Kompatibilitätskorrekturen und laufender Arbeit an Mehrbenutzer-Remote-Desktop, standardisierten Touch-APIs, MCP, Frida-Versionen und -Tarnung, Proxy-IPv6/UDP, P2P Bridge und verteilten Aufgaben.
FIRERPAs Stärke ist nicht eine einzelne Funktion, sondern die Integration von Remote Desktop (WebRTC/H.264/Mehrbenutzer), UI-Automatisierung (Virtual Display, Watcher, OCR, Bildabgleich, Multi-Touch), Ein-Klick-Mitschnitt, eingebautem Frida, Full-Stack-Proxy und VPN/frp/P2P, ADB/SSH/eingebautem Terminal, KI MCP/Agent, Systemsteuerung, virtuellem Debian, persistentem KV und Skriptverschlüsselung auf einem einzigen Android-Gerät, einem Dienst und einem Python-Client – sodass Sicherheitstests, Compliance-Analysen, Protokollwiederherstellung, Flottenmanagement und Automatisierung in einer Pipeline statt in vielen zusammengeklebten Werkzeugen laufen.
