Android 풀스택 기기 제어 플랫폼: WebRTC/H.264 원격 데스크톱, UI/OCR/이미지 매칭 자동화, 원클릭 MITM, 내장 Frida, 프록시/VPN/frp/P2P 네트워킹, MCP/Agent, 160개 이상의 API, 멀티 디바이스 클러스터 및 엔지니어링 배포용으로 설계됨.
문서 | 使用文档 | TELEGRAM | QQ 그룹 | SKILLS | llms-full.txt | 中文版本
FIRERPA는 올인원 Android 기기 제어 플랫폼입니다. 서버가 기기에서 직접 실행되며 추가 런타임 의존성이 필요 없습니다. 여러 세대의 Android를 지원하고 루트 유무와 관계없이 동작합니다. PC 측에서는 Python 클라이언트 라이브러리가 단일 서비스와 API를 통해 UI 자동화, 원격 작업, 트래픽 캡처, Hook 기반 리버스 엔지니어링, 네트워크 프록시, 분산 네트워킹, AI 에이전트, MCP를 오케스트레이션합니다. Appium, mitmproxy, frida-server, adb, uiautomator2를 임시 스크립트 및 운영 도구와 이어 붙이는 방식과 비교할 때, FIRERPA는 단일 기능 소스, 통합 구성, 연결된 워크플로우, 그리고 다중 기기·장기 실행·프로덕션 사용을 위해 구축된 스택을 제공합니다.
FIRERPA는 브라우저 기반 원격 데스크톱을 제공합니다. 전용 PC 클라이언트를 설치하지 않고 LAN 또는 원거리 네트워크를 통해 기기를 실시간으로 보고 제어할 수 있습니다. 스트리밍은 MJPEG과 H.264를 모두 지원하며 소프트웨어 및 하드웨어 인코딩 백엔드를 제공합니다. 프레임 레이트(최대 60fps), 해상도 배율, 비트레이트, 품질을 기기 성능과 네트워크 상태에 맞게 조정할 수 있어 대역폭을 줄이고 약한 링크에서도 부드러움을 개선합니다. WebRTC도 지원하며, 공용 네트워크나 크로스 리전 환경에서 NAT 트래버설을 개선하고 종단 간 지연 시간을 낮추도록 STUN/TURN 서버를 구성할 수 있습니다.
원격 데스크톱은 공동 디버깅, 데모, 교육을 위한 다중 사용자 동시 접속을 지원합니다. 양방향 클립보드 공유와 실시간 오디오(Android 10+)가 포함되며, 통합 터미널, 드래그 앤 드롭 업로드, 브라우저 기반 파일 탐색 및 다운로드까지 모두 단일 포트로 제공됩니다. 내장 시각적 레이아웃 검사는 요소를 강조 표시하고 Tab 탐색을 지원하며 좌표와 RGB 값을 표시하고 XML 레이아웃 트리를 내보냅니다. 동일한 UI에서 셀렉터와 자동화 로직을 검증할 수 있어 화면에서 스크립트로 이어지는 루프를 단축합니다.
원격 데스크톱과 RPC는 종단 간 TLS와 서비스 인증서 접근 제어를 지원하며, 공용 네트워크 노출을 줄이기 위해 선택적으로 커스텀 WebUI 로그인 비밀번호를 설정할 수 있습니다. 원격 데스크톱 기능은 WebSocket을 통해 자체 웹 앱에 임베드할 수도 있습니다(실시간 비디오, 터치, 터미널, 키 입력 등). allow_origin으로 크로스 오리진 통합이 가능하며 실제 기기 제어의 제품화에 적합합니다.
FIRERPA는 완전한 셀렉터 기반 자동화 시스템을 제공합니다. text, resourceId, description, scrollable 및 기타 일반적인 매처와 함께 중복 요소, 깊은 계층 구조, 또는 구별되는 속성이 없는 컨트롤을 위한 자식/형제 체이닝을 지원합니다. 요소 수준에서는 스크린샷, 나타남/사라짐 대기, 모서리/중심 좌표, 존재 확인, 유니코드 입력, 단계적 스와이프, 플링 스크롤, 끝까지 스크롤 등을 제공합니다. Android 8.0+에서는 다른 접근성 서비스와 공존할 수 있으며 하이브리드 앱의 WebView 노드 탐지를 개선합니다.
UI Watcher는 UI 변경을 실시간으로 감지하여 조건이 일치하면 클릭, 키 이벤트 또는 카운터를 실행합니다. 동의 팝업, 업데이트 프롬프트, 광고 및 기타 방해 요소를 자동으로 닫는 데 유용합니다. 여러 셀렉터 조건과 이벤트별 활성화/비활성화를 지원하며 일시적인 화면도 카운트할 수 있습니다.
가상 디스플레이는 차별화된 기능입니다. 기기에 격리된 백그라운드 디스플레이를 만들고 메인 화면에 영향을 주지 않으면서 그곳에서 앱과 자동화를 실행할 수 있습니다. 예를 들어 휴대폰을 정상적으로 사용하는 동안 가상 디스플레이에서 자동 응답을 실행할 수 있습니다. 가상 디스플레이 API는 메인 기기 API를 미러링하며(d.xxx → vd.xxx), Watcher를 가상 디스플레이 범위로 한정할 수 있습니다. WebUI는 원격 데스크톱에서 다중 디스플레이 보기 및 전환을 지원하므로 백그라운드 작업, 병렬 작업, 사람 개입(HITL)과 머신 자동화 결합에 이상적입니다.
표준 뷰 트리가 없는 시나리오(게임, 커스텀 드로잉 UI)에서는 OCR과 이미지 매칭을 제공합니다. OCR은 paddleocr, easyocr 및 커스텀 HTTP 백엔드를 지원합니다. 클러스터 환경에서는 매 PC마다 모델을 로드하는 대신 인식을 중앙에서 실행할 수 있으며 GPU 가속과 유연한 텍스트 매칭을 제공합니다. 이미지 매칭은 기기에서 실행되므로(템플릿 또는 SIFT) PC 리소스를 소모하지 않습니다. SIFT는 회전, 크기, 조명 변화에 강건합니다. 멀티터치는 복잡한 제스처와 압력을 위한 녹화, 재생, 프로그래매틱 구성, 바이너리 영속화를 지원합니다.
아키텍처 측면에서 FIRERPA는 클라이언트/서버 모델을 사용합니다. AutoJS와 같은 온디바이스 스크립트 러너보다 중앙 집중식 스케줄링, 버전 관리, 플릿 제어에 적합하고, Appium보다 가볍고, 다중 기기 시나리오에서 uiautomator2보다 안정적입니다. 문서에서는 일반적인 Android 자동화 스택의 기능적 상위 집합으로 설명합니다. 자동화, 캡처, Hook, 운영 작업을 도구 전환 없이 하나의 플랫폼에서 코드로 연결할 수 있습니다.
FIRERPA는 원클릭 MITM 캡처를 제공합니다. 시스템 루트 CA 자동 설치, 프록시 설정, Android 버전 차이 처리, 종료 시 네트워크 자동 복원까지 지원하므로 수동 인증서 또는 프록시 전환이 필요 없습니다. 전체 캡처, 패키지별 캡처, 실시간 요청/응답 편집, 공유 mitmweb, 해외 트래픽을 위한 업스트림 HTTP 프록시를 지원합니다. 내장 QUIC 다운그레이드로 QUIC 간섭을 줄입니다. PC와 기기가 단일 FIRERPA 포트만 공유하는 경우(예: ADB connect 또는 frp 포워딩)에도 캡처가 동작합니다.
원클릭 스크립트를 넘어 MITM은 완전히 API 기반입니다. mitmproxy, Fiddler, Charles 등과 호환되는 시스템 CA 설치/제거가 가능하며 UI 단계 및 Frida 훅과 함께 자동화 파이프라인에 캡처를 내장할 수 있습니다. Python 설치 없이 사용할 수 있는 Windows용 startmitm.exe도 제공됩니다.
기기에서 FIRERPA는 완전한 프록시 지원을 제공합니다. HTTP / HTTPS / SOCKS5 / Shadowsocks(다중 암호화), 앱별 프록시(멀티 유저 클론 포함), DNS 프록시, UDP 프록시, LAN 우회, OpenVPN과의 공존, 시작 시 구성된 프록시로의 자동 연결을 지원합니다. 프록시는 복잡한 네트워크를 위한 IPv6 및 UDP를 지원합니다.
**기기 HTTP 브리지 프록시(tunnel2)**는 리버스 프록시 기능을 제공합니다. PC 또는 브라우저의 HTTP 프록시를 휴대폰으로 지정하면 트래픽이 휴대폰의 네트워크 이그레스(egress)를 통해 전달되며 아웃바운드 IP는 휴대폰 IP와 일치합니다. 이그레스 인터페이스로 Wi‑Fi 또는 셀룰러(rmnet)를 선택할 수 있어 공동 디버깅, 해외 앱, 다중 기기 IP 풀 구성에 유용합니다.
내장 OpenVPN 클라이언트는 시스템 프록시와 함께 인증서, 사용자 이름/비밀번호, 혼합 인증을 지원합니다. OpenVPN Docker 이미지와 구성 생성기는 기기 측 코드와 자동 시작 설정을 생성합니다. 내장 frp 클라이언트는 암호화와 TLS를 통해 fwd.*로 기기 서비스를 공용 서버에 포워딩합니다.
mDNS 디스커버리는 {device_id}.local로 원격 데스크톱 및 기타 서비스에 접근할 수 있게 하며, LAN 플릿 디스커버리를 위한 선택적 TXT 메타데이터(모델, ABI, 기기 ID)를 지원합니다.
FIRERPA는 최신 Frida를 번들로 제공하므로 별도의 frida-server가 필요 없습니다. 원격 데스크톱 터미널에서 -U, -H 등 없이 frida 도구를 사용할 수 있습니다. 내장 은닉 패치(오픈소스 + 자체 개발)가 탐지 방지를 위해 유지 관리되며, 연결은 FIRERPA 포트를 통한 토큰 인증을 사용합니다. objection 패치와 Frida 17.x java-bridge 헬퍼로 마이그레이션이 쉬워집니다.
영속 Frida 스크립트는 앱 충돌 또는 종료 후 다시 인젝션합니다. YAML 오프라인 영속화와 디렉토리 감시 및 핫 리로드를 지원합니다. Frida RPC는 Python 메서드와 JVM, UI 메인 또는 순수 JS 스레드에서의 HTTP + JSON-RPC 2.0 원격 호출에 매핑됩니다. 스크립트 emit 데이터는 기기/앱 메타데이터, zlib 압축, HTTP 재시도, MQTT TLS와 함께 **HTTP / Redis / RabbitMQ (MQTT)**로 전송할 수 있습니다.
FIRERPA는 독립형 내장 ADB를 포함합니다. 시스템 개발자 옵션을 활성화하지 않고 무선 고권한 ADB를 사용할 수 있어 앱이 개발자 모드를 탐지하는 경우 유용합니다. Magisk 모듈은 기본 인증을 위해 adb_keys를 사전 설치할 수 있습니다. 내장 SSH와 원격 셸 및 파일 전송을 위한 ssh.sh / scp.sh를 제공합니다.
내장 터미널에는 strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper와 함께 Crypto, cv2, unicorn, capstone, keystone, redis, grpc 같은 Python 스택이 포함됩니다. sqlite3는 WeChat, WeCom, Alibaba 계열 클라이언트 같은 앱의 암호화된 데이터베이스를 읽기 위한 wxsqlite / sqlcipher / sqlcrypto를 지원합니다. 원격 데스크톱, SSH, ADB에서 동일한 환경을 사용하므로 PC를 오가는 이동을 줄이고 기기에서 직접 분석과 제어를 수행할 수 있습니다.
**FIRERPA StarLink 플랫폼(Hub + hub-bridge)**은 로컬 및 원격 기기에 대한 중앙 집중식 다중 기기 접근을 통합 관리와 P2P 접근으로 제공합니다. "집의 기기, 다른 곳의 운영자" 시나리오와 다중 기기 협업에 이상적입니다. hub v3는 SAPI를 사용하여 로컬 및 원격 기기에 통합 요청을 보냅니다. Hub 외에도 frp 포워딩과 OpenVPN mesh를 자체 호스팅 옵션으로 지원하며 전체 문서와 Docker 지원을 제공합니다.
9.0부터 P2P Bridge 피어 연결과 내장 분산 태스크 시스템을 지원합니다. 7.50부터는 네트워킹 구독 서비스가 제공되어 frp/OpenVPN을 자체 호스팅할 필요가 없습니다. 클라우드 폰 풀, 디바이스 팜, 에뮬레이터 클러스터를 위해 설계되었으며 대량 기기, 상시 가동, 무인 운영에 적합합니다.
FIRERPA는 streamable-http 기반의 MCP 서버(/mcp/)를 포함합니다. 도구 호출, 리소스 읽기, 프롬프트, 진행 알림, 로그를 지원하며 Claude, Cursor 및 기타 MCP 클라이언트와 호환됩니다. 공식 MCP 확장은 ~/modules/extension에 있습니다.
내장 agent 명령은 도구 호출을 지원하는 모든 OpenAI 호환 API를 통해 자연어로 기기를 구동하며 비전 모드와 OpenAI 시맨틱 태스크 실행기를 포함합니다. crontab과 결합하면 실제 기기에서 예약된 AI 태스크를 실행할 수 있습니다.
160개 이상의 Python API가 앱 운영, 파일 I/O, 명령 실행, 기기 상태, WiFi, 프록시, OpenVPN, 종료/재부팅, 서비스 로그 등을 포괄합니다. setprop로 ro.* 읽기 전용 속성도 작성할 수 있고, Settings API로 밝기, 개발자 모드 등을 조정할 수 있습니다. SELinux 도메인 생성, 퍼미시브 모드, 세밀한 허용/차단을 지원합니다. 전체 다중 인스턴스 앱 API, 권한 무음 부여/회수, non-exported 액티비티 실행, 리소스 절약을 위한 앱 비활성화를 제공합니다.
바이너리 패칭(hex 와일드카드, glob 경로, dryrun)과 디스크, 배터리, CPU, 메모리, 네트워크 I/O에 대한 런타임 메트릭을 제공합니다. WAV 재생 및 내부 저장소 API도 지원합니다. 엣지 추론을 위한 하드웨어 가속 컴퓨팅을 갖춘 온디바이스 tflite-runtime을 포함합니다.
가상 Debian 환경은 apt를 갖춘 완전한 Debian을 실행합니다. BPF 컴파일, OpenSSH 배포, 내장 터미널의 한계를 넘는 임의 Python 의존성 설치가 가능합니다.
원클릭 APP(root 또는 Shizuku), Magisk 모듈 자동 시작, 수동 압축 해제, 또는 ROM 통합 방식으로 배포할 수 있으며 24/7 운영에 맞게 설계되었습니다. APP은 서비스 인증서를 자동 생성할 수 있고, Magisk zip에는 properties, lamda.pem, adb_keys를 포함할 수 있습니다. INI 서비스 구성은 포트, WebUI, 인증서, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns 등을 중앙 관리하며, WebUI에서 시각적 편집, 원본 텍스트, 서비스 리로드와 원격 구성 파일 로드를 지원합니다.
Root 및 shell ID를 지원하며, arm64, armeabi-v7a, x86, x86_64 아키텍처와 실제 기기, 에뮬레이터(LDPlayer, Nox 등), Redroid, WSA, AVD, 클라우드 폰을 지원합니다. 깔끔한 제거 경로를 제공하고 API 전용 잠금으로 클라이언트 경합을 방지합니다. 개인정보 보호 정책: 연락처, SMS, 위치 등을 수집하지 않으며 오프라인 라이선싱을 지원합니다.
6년 이상의 지속적인 개발을 통해 Android 14–16 호환성 수정과 함께 멀티 유저 원격 데스크톱, 표준화된 터치 API, MCP, Frida 버전 및 스텔스, 프록시 IPv6/UDP, P2P Bridge, 분산 태스크에 대한 지속적인 작업이 진행되고 있습니다.
FIRERPA의 강점은 단일 기능이 아니라 원격 데스크톱(WebRTC/H.264/멀티 유저), UI 자동화(가상 디스플레이, Watcher, OCR, 이미지 매칭, 멀티터치), 원클릭 캡처, 내장 Frida, 풀스택 프록시와 VPN/frp/P2P, ADB/SSH/내장 터미널, AI MCP/에이전트, 시스템 수준 제어, 가상 Debian, 영속 KV, 스크립트 암호화를 단일 Android 기기, 단일 서비스, 단일 Python 클라이언트에 통합한 것입니다. 이로써 보안 테스트, 컴플라이언스 분석, 프로토콜 복원, 플릿 관리, 자동화가 여러 도구를 접합하는 대신 하나의 파이프라인에서 실행됩니다.
