Android Full-Stack Device Control Platform: WebRTC/H.264 remote desktop, UI/OCR/image-matching automation, one-click MITM, built-in Frida, proxy/VPN/frp/P2P networking, MCP/Agent, 160+ APIs, designed for multi-device clusters and engineered deployments.
Documentação | 使用文档 | TELEGRAM | Grupo QQ | SKILLS | llms-full.txt | 中文版本
FIRERPA é uma plataforma de controle de dispositivos Android tudo-em-um. O servidor é executado diretamente no dispositivo sem dependências extras de tempo de execução; suporta várias gerações de Android e funciona com ou sem root. No lado do PC, a biblioteca cliente Python orquestra automação de UI, operações remotas, captura de tráfego, engenharia reversa baseada em Hook, proxy de rede, rede distribuída, agentes de IA e MCP através de um único serviço e API. Comparado com juntar Appium, mitmproxy, frida-server, adb, uiautomator2 e scripts e ferramentas de operação ad-hoc, o FIRERPA oferece uma única fonte de capacidades, configuração unificada, fluxos de trabalho conectados e uma pilha construída para uso em múltiplos dispositivos, de longa duração e em produção.
A FIRERPA fornece uma área de trabalho remota baseada em navegador: visualize e controle o dispositivo em tempo real sem instalar um cliente dedicado no PC, em LAN ou através de redes. A transmissão suporta tanto MJPEG quanto H.264, com backends de codificação por software e hardware. A taxa de quadros (até 60fps), escala de resolução, bitrate e qualidade podem ser ajustados de acordo com a capacidade do dispositivo e as condições da rede — reduzindo a largura de banda e melhorando a suavidade em links fracos. WebRTC também é suportado, com servidores STUN/TURN configuráveis para melhor travessia NAT e menor latência ponta a ponta em configurações públicas ou entre regiões.
A área de trabalho remota suporta acesso simultâneo de múltiplos usuários para depuração colaborativa, demonstrações e treinamento. Compartilhamento de área de transferência bidirecional e áudio ao vivo (Android 10+) estão incluídos, junto com um terminal integrado, uploads por arrastar e soltar e navegação e downloads de arquivos baseados no navegador — tudo em uma única porta. A inspeção visual de layout integrada destaca elementos, suporta navegação por Tab, mostra coordenadas e valores RGB e exporta a árvore de layout XML, para que você possa validar seletores e lógica de automação na mesma UI, encurtando o ciclo da tela ao script.
A área de trabalho remota e RPC suportam TLS ponta a ponta e controle de acesso por certificado de serviço, com senhas de login opcionais personalizadas no WebUI para reduzir a exposição em redes públicas. As capacidades da área de trabalho remota também podem ser incorporadas em seus próprios aplicativos web via WebSocket (vídeo ao vivo, toque, terminal, teclas, etc.), com allow_origin para integração entre origens — adequado para comercializar o controle de dispositivos reais.
O FIRERPA fornece um sistema de automação completo baseado em seletores: texto, resourceId, descrição, scrollable e outros correspondentes comuns, além de encadeamento filho/irmão para elementos duplicados, hierarquias profundas ou controles sem atributos distintivos. No nível do elemento: capturas de tela, aguardar aparecimento/desaparecimento, coordenadas de canto/centro, verificações de existência, entrada Unicode, deslizes graduais, rolagem por fling, rolar até o fim e mais. Ele pode coexistir com outros serviços de acessibilidade no Android 8.0+ e melhora a descoberta de nós WebView para aplicativos híbridos.
O UI Watcher escuta mudanças na UI em tempo real e executa cliques, eventos de tecla ou contadores quando as condições correspondem — útil para dispensar automaticamente acordos, prompts de atualização, anúncios e outras interrupções. Várias condições de seletor e habilitação/desabilitação por evento são suportadas; telas transitórias podem ser contadas.
Virtual Display é um diferencial: crie telas de fundo isoladas no dispositivo e execute aplicativos e automação ali sem afetar a tela principal — por exemplo, resposta automática em uma tela virtual enquanto você usa o telefone normalmente. A API de tela virtual espelha a API principal do dispositivo (d.xxx → vd.xxx); Watchers podem ser limitados a uma tela virtual. O WebUI suporta visualização e troca de múltiplas telas na área de trabalho remota — ideal para tarefas em segundo plano, trabalho paralelo e automação com supervisão humana mais máquina.
Para cenários sem uma árvore de visualização padrão (jogos, UI desenhada personalizada), o FIRERPA oferece OCR e correspondência de imagem. O OCR suporta paddleocr, easyocr e backends HTTP personalizados; em clusters, o reconhecimento pode ser executado centralmente em vez de carregar modelos em cada PC, com aceleração GPU e correspondência de texto flexível. A correspondência de imagem é executada no dispositivo (template ou SIFT), sem consumir recursos do PC; SIFT é robusto a rotação, escala e iluminação. Multi-touch suporta gravação, repetição, construção programática e persistência binária para gestos complexos e pressão.
Arquiteturalmente, o FIRERPA usa um modelo cliente/servidor — melhor para agendamento centralizado, versionamento e controle de frota do que executores de script no dispositivo como AutoJS; mais leve que Appium; mais estável que uiautomator2 em cenários com múltiplos dispositivos. A documentação o posiciona como um superconjunto funcional das pilhas comuns de automação Android — automação, captura, Hook e operações podem ser encadeadas em código em uma plataforma sem trocar de ferramentas.
O FIRERPA oferece captura MITM com um clique: instalação automática do CA raiz do sistema, configuração de proxy, tratamento de diferenças de versão do Android e restauração automática da rede ao sair — sem alternância manual de certificado ou proxy. Captura global, captura por pacote, edição ao vivo de requisição/resposta, mitmweb compartilhado e proxy HTTP upstream para tráfego internacional são suportados. O downgrade QUIC integrado reduz a interferência do QUIC. A captura ainda funciona quando PC e dispositivo compartilham apenas uma única porta FIRERPA (por exemplo, conexão ADB ou encaminhamento frp).
Além de scripts com um clique, o MITM é totalmente orientado por API: instalar/desinstalar CAs de sistema compatíveis com mitmproxy, Fiddler, Charles, etc.; incorporar captura em pipelines de automação junto com etapas de UI e hooks Frida. Um startmitm.exe para Windows está disponível sem instalação do Python.
No dispositivo, o FIRERPA fornece suporte completo a proxy: HTTP / HTTPS / SOCKS5 / Shadowsocks (várias cifras), proxy por aplicativo (incluindo clones de múltiplos usuários), proxy DNS, proxy UDP, desvio de LAN, coexistência com OpenVPN e conexão automática a proxies configurados na inicialização. Os proxies suportam IPv6 e UDP para redes complexas.
Proxy de ponte HTTP do dispositivo (tunnel2) fornece capacidade de proxy reverso: aponte o proxy HTTP do seu PC ou navegador para o telefone e o tráfego é encaminhado através da saída de rede do telefone; o IP de saída corresponde ao telefone. Wi‑Fi ou celular (rmnet) podem ser escolhidos como interface de saída — útil para depuração conjunta, aplicativos internacionais e pools de IP de múltiplos dispositivos.
Um cliente OpenVPN integrado suporta certificado, nome de usuário/senha e autenticação mista, juntamente com proxy do sistema; uma imagem Docker OpenVPN e geradores de configuração produzem código do lado do dispositivo e configurações de inicialização automática. Um cliente frp integrado encaminha serviços do dispositivo para um servidor público via fwd.*, com criptografia e TLS.
Descoberta mDNS permite acesso {device_id}.local à área de trabalho remota e outros serviços, com metadados TXT opcionais (modelo, ABI, ID do dispositivo) para descoberta de frota em LAN.
O FIRERPA inclui a versão mais recente do Frida — sem necessidade de frida-server separado. Use as ferramentas do Frida a partir do terminal da área de trabalho remota sem -U, -H, etc. Patches de ocultação integrados (open-source e próprios) são mantidos contra detecção; as conexões usam autenticação por token através da porta FIRERPA. Patches do objection e auxiliares java-bridge do Frida 17.x facilitam a migração.
Scripts Frida persistentes reinjetam após falha ou saída do aplicativo; persistência YAML offline com monitoramento de diretório e recarga a quente. Frida RPC mapeia para métodos Python e chamadas remotas HTTP + JSON-RPC 2.0 em threads JVM, UI principal ou JS puro. Dados emit do script podem ir para HTTP / Redis / RabbitMQ (MQTT) com metadados do dispositivo/aplicativo, compressão zlib, retentativas HTTP e TLS MQTT.
O FIRERPA inclui um ADB integrado autônomo — ADB sem fio de alto privilégio sem ativar as Opções do Desenvolvedor do sistema, útil quando aplicativos detectam o modo desenvolvedor. Módulos Magisk podem pré-instalar adb_keys para autorização padrão. SSH integrado mais ssh.sh / scp.sh para shell remoto e transferência de arquivos.
O terminal integrado vem com strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper e pilhas Python como Crypto, cv2, unicorn, capstone, keystone, redis e grpc. sqlite3 suporta wxsqlite / sqlcipher / sqlcrypto para ler bancos de dados criptografados de aplicativos como WeChat, WeCom e clientes da família Alibaba. Um ambiente em toda a área de trabalho remota, SSH e ADB — analise e controle no dispositivo com menos deslocamento para o PC.
Plataforma FIRERPA StarLink (Hub + hub-bridge) fornece acesso centralizado a múltiplos dispositivos para dispositivos locais e remotos com gerenciamento unificado e acesso P2P — ideal para “dispositivo em casa, operador em outro lugar” e colaboração entre vários dispositivos. hub v3 usa SAPI para requisições unificadas a dispositivos locais e remotos. Além do Hub, encaminhamento frp e malha OpenVPN também são suportados como opções auto-hospedadas, com documentação completa e suporte a Docker.
Desde a versão 9.0, conectividade P2P Bridge entre pares e um sistema de tarefas distribuídas integrado são suportados; desde a 7.50, um serviço de assinatura de rede está disponível para que você não precise auto-hospedar frp/OpenVPN. Projetado para pools de telefones em nuvem, fazendas de dispositivos e clusters de emuladores — operação em lote, sempre ligada, sem supervisão.
O FIRERPA inclui um servidor MCP (/mcp/) em streamable-http, com chamadas de ferramenta, leituras de recursos, prompts, notificações de progresso e logs — compatível com Claude, Cursor e outros clientes MCP. As extensões MCP oficiais ficam em ~/modules/extension.
O comando agent integrado comanda o dispositivo em linguagem natural através de qualquer API compatível com OpenAI com chamadas de ferramenta, incluindo modo visão, além de um executor de tarefas semânticas OpenAI. Combine com crontab para tarefas de IA agendadas em dispositivos reais.
Mais de 160 APIs Python cobrem operações de aplicativos, E/S de arquivos, execução de comandos, status do dispositivo, WiFi, proxy, OpenVPN, desligamento/reinicialização, logs de serviço e mais. setprop pode escrever propriedades somente leitura ro.*; APIs de Configurações ajustam brilho, modo desenvolvedor, etc.; SELinux criação de domínio, modo permissivo e permitir/negar granular. APIs completas de múltiplas instâncias de aplicativos, conceder/revogar permissões silenciosamente, iniciar atividades não exportadas, desabilitar aplicativos para economizar recursos.
Correção binária (curingas hex, caminhos glob, dryrun) e métricas de tempo de execução para disco, bateria, CPU, memória e E/S de rede. Reprodução de WAV e APIs de armazenamento interno. tflite-runtime no dispositivo com computação acelerada por hardware para inferência na borda.
Um ambiente Debian virtual executa Debian completo com apt — compile BPF, implante OpenSSH, instale dependências Python arbitrárias além dos limites do terminal integrado.
Implante via APP com um clique (root ou Shizuku), inicialização automática do módulo Magisk, extração manual ou integração ROM — projetado para operação 24/7. O APP pode gerar automaticamente certificados de serviço; zips Magisk podem incluir propriedades, lamda.pem e adb_keys. Configuração de serviço INI centraliza porta, WebUI, certificados, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns, etc.; WebUI oferece edição visual, texto bruto e Recarregar Serviço, além de carregamento remoto de arquivos de configuração.
Identidades root e shell; arm64, armeabi-v7a, x86, x86_64; dispositivos reais, emuladores (LDPlayer, Nox, etc.), Redroid, WSA, AVD, telefones em nuvem. Caminhos de desinstalação limpos. Bloqueio exclusivo de API evita contenção de clientes. Política de privacidade: nenhuma coleta de contatos, SMS, localização, etc.; licenciamento offline suportado.
Mais de seis anos de desenvolvimento contínuo, com correções de compatibilidade para Android 14–16 e trabalho contínuo em área de trabalho remota para múltiplos usuários, APIs de toque padronizadas, MCP, versões e ocultação do Frida, proxy IPv6/UDP, P2P Bridge e tarefas distribuídas.
A força do FIRERPA não é nenhum recurso isolado, mas integrar área de trabalho remota (WebRTC/H.264/múltiplos usuários), automação de UI (tela virtual, Watcher, OCR, correspondência de imagem, multi-toque), captura com um clique, Frida integrado, proxy completo e VPN/frp/P2P, ADB/SSH/terminal integrado, IA MCP/Agente, controle em nível de sistema, Debian virtual, KV persistente e criptografia de scripts em um único dispositivo Android, um serviço e um cliente Python — para que testes de segurança, análise de conformidade, recuperação de protocolo, gerenciamento de frota e automação sejam executados em um pipeline em vez de muitas ferramentas coladas.
