lamda — Android 풀스택 기기 제어 플랫폼: WebRTC/H.264 원격 데스크톱, UI/OCR/이미지 매칭 자동화, 원클릭 MITM, 내장 Frida, 프록시/VPN/frp/P2P 네트워킹, MCP/Agent, 160개 이상의 API, 멀티 디바이스 클러스터 및 엔지니어링 배포용으로 설계됨. | Kitploit

# **FIRERPA Android** ｜ AI 기반 자동화

<h6>온디바이스 서비스, AI 지원 에이전트, 확장 가능한 도구 호출을 하나로 결합한 올인원 Android 자동화 프레임워크입니다.</h6>

<p align="left"><a href="https://device-farm.com/docs/en/">문서</a> | <a href="https://device-farm.com/docs/zh/">使用文档</a> | <a href="https://device-farm.com/contact#telegram">TELEGRAM</a> | <a href="https://device-farm.com/contact#QQ">QQ 그룹</a> | <a href="https://github.com/firerpa/skills">SKILLS</a> | <a href="https://device-farm.com/llms-full.txt">llms-full.txt</a> | <a href="https://github.com/firerpa/lamda/blob/10/README.zh.md">中文版本</a></p>

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`으로 크로스 오리진 통합이 가능하며 실제 기기 제어의 제품화에 적합합니다.

## UI 자동화

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, 운영 작업을 도구 전환 없이 하나의 플랫폼에서 코드로 연결할 수 있습니다.

## 패킷 캡처 & 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 프록시를 휴대폰으로 지정하면 트래픽이 휴대폰의 네트워크 이그레스(egress)를 통해 전달되며 아웃바운드 IP는 휴대폰 IP와 일치합니다. 이그레스 인터페이스로 Wi‑Fi 또는 셀룰러(rmnet)를 선택할 수 있어 공동 디버깅, 해외 앱, 다중 기기 IP 풀 구성에 유용합니다.

내장 **OpenVPN 클라이언트**는 시스템 프록시와 함께 인증서, 사용자 이름/비밀번호, 혼합 인증을 지원합니다. **OpenVPN Docker 이미지**와 구성 생성기는 기기 측 코드와 자동 시작 설정을 생성합니다. 내장 **frp 클라이언트**는 암호화와 TLS를 통해 `fwd.*`로 기기 서비스를 공용 서버에 포워딩합니다.

**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는 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을 자체 호스팅할 필요가 없습니다. 클라우드 폰 풀, 디바이스 팜, 에뮬레이터 클러스터를 위해 설계되었으며 **대량 기기, 상시 가동, 무인** 운영에 적합합니다.

## AI / MCP / 에이전트

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 클라이언트에 통합한 것입니다. 이로써 보안 테스트, 컴플라이언스 분석, 프로토콜 복원, 플릿 관리, 자동화가 여러 도구를 접합하는 대신 **하나의 파이프라인**에서 실행됩니다.

도구 다운로드

인기

lamda