
lamda v10.12
Android 풀스택 기기 제어 플랫폼: WebRTC/H.264 원격 데스크톱, UI/OCR/이미지 매칭 자동화, 원클릭 MITM, 내장 Frida, 프록시/VPN/frp/P2P 네트워킹, MCP/Agent, 160개 이상의 API, 멀티 디바이스 클러스터 및 엔지니어링 배포용으로 설계됨.
FIRERPA Android | AI 기반 자동화
온디바이스 서비스, AI 지원 에이전트, 확장 가능한 도구 호출을 결합한 올인원 Android 자동화 프레임워크입니다.
문서 | 사용 문서 | 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도 지원되며, 구성 가능한 STUN/TURN 서버를 통해 공용 또는 지역 간 환경에서 NAT 통과를 개선하고 종단 간 지연을 낮출 수 있습니다.
원격 데스크톱은 협업 디버깅, 데모, 교육을 위한 다중 사용자 동시 접속을 지원합니다. 양방향 클립보드 공유와 라이브 오디오(Android 10+)가 포함되며, 통합 터미널, 드래그 앤 드롭 업로드, 브라우저 기반 파일 탐색 및 다운로드를 모두 단일 포트를 통해 제공합니다. 내장된 시각적 레이아웃 검사는 요소를 강조 표시하고, Tab 탐색을 지원하며, 좌표와 RGB 값을 보여주고, XML 레이아웃 트리를 내보낼 수 있어 동일한 UI에서 셀렉터와 자동화 로직을 검증할 수 있으므로 화면에서 스크립트까지의 반복 주기를 단축합니다.
원격 데스크톱과 RPC는 종단 간 TLS와 서비스 인증서 접근 제어를 지원하며, 선택적으로 사용자 지정 WebUI 로그인 비밀번호를 설정해 공용 네트워크에서의 노출을 줄일 수 있습니다. 원격 데스크톱 기능은 WebSocket(라이브 비디오, 터치, 터미널, 키 등)을 통해 자체 웹 앱에 임베드할 수도 있으며, 교차 출처 통합을 위한 allow_origin을 지원하므로 실제 기기 제어를 제품화하는 데 적합합니다.
UI 자동화
FIRERPA는 완전한 셀렉터 기반 자동화 시스템을 제공합니다. text, resourceId, description, scrollable 및 기타 일반적인 매처와 함께, 중복 요소, 깊은 계층 구조, 또는 구별되는 속성이 없는 컨트롤을 위한 자식 / 형제 체이닝을 지원합니다. 요소 수준에서는 스크린샷, 나타남/사라짐 대기, 모서리/중심 좌표, 존재 여부 확인, 유니코드 입력, 단계별 스와이프, 플링 스크롤, 끝까지 스크롤 등이 가능합니다. Android 8.0+에서 다른 접근성 서비스와 공존할 수 있으며 하이브리드 앱의 WebView 노드 탐색을 개선합니다.
UI Watcher는 UI 변경을 실시간으로 감지하고 조건이 일치할 때 클릭, 키 이벤트 또는 카운터를 실행합니다. 동의 화면, 업데이트 알림, 광고 및 기타 방해 요소를 자동으로 닫는 데 유용합니다. 여러 선택자 조건과 이벤트별 활성화/비활성화를 지원하며, 일시적인 화면을 카운트할 수 있습니다.
Virtual Display는 차별화된 기능입니다. 기기에서 격리된 백그라운드 디스플레이를 생성하고 그곳에서 앱과 자동화를 실행하여 메인 화면에 영향을 주지 않습니다. 예를 들어 휴대폰을 정상적으로 사용하는 동안 가상 디스플레이에서 자동 응답을 실행할 수 있습니다. 가상 디스플레이 API는 메인 기기 API를 미러링하며(d.xxx → vd.xxx), Watcher는 가상 디스플레이로 범위를 지정할 수 있습니다. WebUI는 원격 데스크톱에서 다중 디스플레이 보기 및 전환을 지원하여 백그라운드 작업, 병렬 작업, 그리고 휴먼 인 더 루프와 머신 자동화의 조합에 이상적입니다.
표준 뷰 트리가 없는 장면(게임, 커스텀 드로잉 UI)의 경우 FIRERPA는 OCR과 이미지 매칭을 제공합니다. OCR은 paddleocr, easyocr 및 커스텀 HTTP 백엔드를 지원하며, 클러스터에서는 모든 PC에 모델을 로드하는 대신 인식을 중앙에서 실행할 수 있고 GPU 가속과 유연한 텍스트 매칭을 제공합니다. 이미지 매칭은 기기에서 실행되며(템플릿 또는 SIFT) PC 리소스를 소비하지 않습니다. SIFT는 회전, 크기 조정 및 조명 변화에 강건합니다. 멀티 터치는 복잡한 제스처와 압력을 위한 기록, 재생, 프로그래밍 방식 구성 및 바이너리 영속성을 지원합니다.
아키텍처적으로 FIRERPA는 클라이언트/서버 모델을 사용하여 AutoJS와 같은 기기 내 스크립트 러너보다 중앙 집중식 스케줄링, 버전 관리 및 플릿 제어에 더 적합합니다. Appium보다 가볍고, 다중 기기 시나리오에서 uiautomator2보다 더 안정적입니다. 문서에서는 이를 일반적인 Android 자동화 스택의 기능적 상위 집합으로 위치시키며, 자동화, 캡처, Hook 및 운영을 도구 전환 없이 하나의 플랫폼에서 코드로 연결할 수 있습니다.
패킷 캡처 및 MITM
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 프록시를 휴대폰으로 지정하면 트래픽이 휴대폰의 네트워크 이그레스를 통해 포워딩되며, 아웃바운드 IP가 휴대폰과 일치합니다. Wi‑Fi 또는 셀룰러(rmnet)를 이그레스 인터페이스로 선택할 수 있어 공동 디버깅, 국제 앱 및 다중 기기 IP 풀에 유용합니다.
내장된 OpenVPN 클라이언트는 인증서, 사용자 이름/비밀번호 및 혼합 인증을 지원하며 시스템 프록시와 함께 사용할 수 있습니다. OpenVPN Docker 이미지와 구성 생성기는 기기 측 코드와 자동 시작 설정을 생성합니다. 내장된 frp 클라이언트는 fwd.*를 통해 기기 서비스를 공용 서버로 포워딩하며 암호화와 TLS를 지원합니다.
mDNS 검색은 {device_id}.local을 통한 원격 데스크톱 및 기타 서비스 접근을 가능하게 하며, LAN 플릿 검색을 위한 선택적 TXT 메타데이터(모델, ABI, 기기 ID)를 제공합니다.
Frida 및 리버스 엔지니어링
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) 로 전송할 수 있습니다.
ADB, SSH 및 내장 터미널
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는 wxsqlite / sqlcipher / sqlcrypto를 지원하여 WeChat, WeCom, Alibaba 계열 클라이언트 같은 앱의 암호화된 데이터베이스를 읽을 수 있습니다. 원격 데스크톱, SSH, ADB 전반에 걸친 단일 환경—PC를 오가며 작업하는 일을 줄이고 기기에서 직접 분석하고 제어하세요.
분산 및 다중 기기 관리
**FIRERPA StarLink Platform (Hub + hub-bridge)**은 로컬 및 원격 기기에 대한 중앙 집중식 다중 기기 접근을 제공하며, 통합 관리와 P2P 접근을 지원합니다—“기기는 집에, 운영자는 다른 곳에” 있는 상황과 다중 기기 협업에 이상적입니다. hub v3는 로컬 및 원격 기기에 대한 통합 요청에 SAPI를 사용합니다. Hub 외에도 frp 포워딩과 OpenVPN 메시가 자체 호스팅 옵션으로 지원되며, 전체 문서와 Docker 지원이 제공됩니다.
9.0부터 P2P Bridge 피어 연결과 내장 분산 작업 시스템이 지원되며, 7.50부터는 frp/OpenVPN을 직접 호스팅할 필요가 없도록 네트워킹 구독 서비스가 제공됩니다. 클라우드 폰 풀, 기기 팜, 에뮬레이터 클러스터를 위해 설계되었습니다—기기 일괄 처리, 상시 가동, 무인 운영.
AI / MCP / Agent
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 도메인 생성, permissive 모드, 세밀한 allow/disallow를 지원합니다. 완전한 다중 인스턴스 앱 API, 무음 권한 부여/취소, 비공개(non-exported) 액티비티 실행, 리소스 절약을 위한 앱 비활성화도 제공됩니다.
바이너리 패칭(hex 와일드카드, glob 경로, dryrun)과 디스크, 배터리, CPU, 메모리, 네트워크 I/O에 대한 런타임 메트릭을 제공합니다. WAV 재생과 내부 저장소 API도 지원합니다. 기기 내 tflite-runtime은 엣지 추론을 위한 하드웨어 가속 연산을 제공합니다.