ZAFrida UI - PyCharm Frida Plugin

현재 버전: 0.3.7

0.3.7 주요 업데이트

각 ZAFrida Project에서 Python/Frida 환경을 독립적으로 선택하거나 공유할 수 있으며, 기본적으로 현재 PyCharm 프로젝트 인터프리터를 사용하고 venv, Conda, uv, Poetry, Pipenv, Hatch 등 로컬 환경을 지원합니다.
Session UI와 Project Settings를 재설계하여 플러그인, Python, Frida 버전 정보를 완전히 표시하고, 적응형·드래그 가능한 로그 패널과 세션 상태를 최적화했습니다.
.js / .ts, Frida 16/17, 다중 프로젝트 환경 전환, USB, Remote, Gadget 세 가지 연결 흐름을 완전히 지원합니다.
로컬 HTTP API, CLI 및 중국어 Skill의 장치 복구, 세션 대기, 증분 로그 기능을 강화하고, 중복되고 불안정한 MCP 어댑터 계층을 제거했습니다.

프로젝트 소개

PyCharm/IntelliJ 전용 Frida 그래픽 도구

ZAFrida UI는 PyCharm 및 JetBrains 계열 IDE에 통합된 Frida 그래픽 조작 플러그인입니다. Frida 명령줄 조작의 번거로움과 스크립트 관리의 혼란을 해결하기 위해 설계되었으며, 장치, 프로세스, 스크립트 및 로그를 관리할 수 있는 완전한 UI 인터페이스를 제공합니다.

핵심 하이라이트는 "체크박스식" 템플릿 관리 시스템입니다. 사용자는 체크/체크 해제를 통해 코드 조각을 메인 스크립트에 동적으로 삽입하거나 주석 처리할 수 있어 "블록 조립식" Hook 스크립트 구성을 구현할 수 있습니다. 또한 플러그인에는 완전한 프로젝트 관리 (zafrida-project.xml)가 내장되어 있어 다중 장치, 다중 환경 구성의 빠른 전환을 지원합니다.

ZAFrida는 Frida를 대체하는 것이 아니라 frida-tools의 강력한 UI 셸로, 기존 Python 및 Frida 환경과 원활하게 연결됩니다.

간편 버전 Wiki: ZAFrida UI 간편 Wiki (BBS) (더 간편한 Wiki) 상세 사용 튜토리얼: ZAFrida UI 상세 사용 튜토리얼 Wiki

효과 데모

Home

빠른 시작

플러그인 설치: IDE 플러그인 마켓에서 "ZAFrida"를 검색하거나 디스크에서 설치합니다.
기본 환경 구성: 기본적으로 현재 PyCharm 프로젝트의 Python Interpreter를 사용합니다. 전역 Settings -> Tools -> ZAFrida에는 도구 이름/경로 기본값만 유지됩니다.
프로젝트 생성: 프로젝트 뷰에서 마우스 오른쪽 버튼 클릭 -> New Frida Project.
- 해당 프로젝트에 다른 Frida 버전이 필요한 경우 ZAFrida Project Settings를 열고 Python 인터프리터 또는 환경 디렉터리를 선택한 후 Test를 클릭합니다.
스크립트 작성/선택: Run 패널에서 agent.js 또는 agent.ts를 선택합니다.
Hook 디버깅:

장치 연결 (USB 또는 Remote 또는 Gadget).
대상 프로세스 또는 패키지 이름 선택.
Run 클릭.

템플릿 사용: Templates 탭으로 전환하여 필요한 Hook 기능(예: "SSL Pinning Bypass")을 체크하면 코드가 자동으로 스크립트에 주입됩니다.
Skills 자동화(선택 사항): 기본적으로 비활성화되어 있습니다. Settings/Preferences -> ZAFrida -> Skills HTTP API로 이동하여 Enable Skills를 체크하면 로컬 API가 자동으로 시작됩니다(수동 Start/Stop도 가능). CLI 및 템플릿 위치:
- Skill 및 메인 CLI: skills-template/zafrida-http-control/
- 이전 경로 호환 런처: skills-cli/zafrida_skill_cli.py

교류 그룹 QR 코드

기능 특성

장치 및 프로세스 관리
frida-ls-devices 및 frida-ps를 통합하여 원클릭 장치 목록 새로고침, 실행 중인 프로세스, 실행 중인 App 또는 설치된 애플리케이션 확인을 지원합니다.
다중 모드 연결
USB / Remote / Gadget 모드를 완전히 지원하며, 사용자 정의 원격 Host 및 Port를 지원하여 복잡한 명령줄 인수를 수동으로 조합할 필요가 없습니다.
대화형 스크립트 실행 (Run / Attach)
- 단순한 "모드 전환"이 아닌 Run(기본 Spawn) 및 Attach 두 가지 실행 동작을 지원합니다.
- Force Stop으로 대상 애플리케이션을 강제 종료할 수 있습니다.
- 내장 콘솔 로그 출력 및 프로젝트 디렉터리 zafrida-logs/에 로그 자동 저장.
JS / TypeScript 편집기 우클릭 메뉴 (중요)
- Frida .js 또는 .ts 파일 편집 영역에서 우클릭하여 다음을 직접 선택할 수 있습니다:
  - Run Frida Script: 현재 파일을 메인 스크립트로 실행(기본 Spawn).
  - Attach Frida Script: 현재 파일을 추가 스크립트로 실행 중인 대상 프로세스에 주입.
- 실행 전에 현재 파일을 자동 저장하고, 스크립트가 속한 ZAFrida Project로 자동 전환합니다.
- 빠른 PoC, Demo 검증, Gadget 모드 또는 실행 중인 프로세스의 즉시 주입에 적합합니다.
- 단축키:
  - Windows / Linux: Ctrl + Alt + S
  - macOS: ⌘ + ⌥ + S
편집기 우클릭 Snippets 삽입
- JS / TypeScript 편집기 우클릭 메뉴에서 ZAFrida Frida Snippets 제공.
- 원클릭으로 일반적인 Frida 코드 조각 삽입, 예:

적용 시나리오

ZAFrida UI는 Frida를 사용한 리버스 엔지니어링의 모든 시나리오에 적합하며, 특히:

Android / iOS App 침투 테스트 및 리버스 분석.
서로 다른 Hook 스크립트를 자주 전환해야 하는 디버깅 과정.
IDE(PyCharm/IDEA)에서 Python, JavaScript, TypeScript 혼합 개발에 익숙한 엔지니어.

기술 문서

환경 요구 사항:
- IntelliJ IDEA 또는 PyCharm (2024.3+ 권장)
- 로컬에 Python3 및 frida-tools 설치 (pip install frida-tools)
- frida, frida-ps, frida-ls-devices가 시스템 PATH에 있거나 플러그인 설정에서 경로를 지정했는지 확인.
문제 피드백: Github Issues

프로젝트 시작

소스 코드 클론: git clone https://github.com/yilongmd/zafrida-ui.git
IntelliJ IDEA로 프로젝트를 엽니다.
Gradle 작업 runIde를 실행하여 디버그 환경을 시작합니다.

시스템 화면

메인 인터페이스 및 실행 패널 (Run Panel)

장치 선택, 스크립트 선택, 실행 모드 구성 및 콘솔 출력을 제공합니다.

Run Panel

동적 템플릿 관리 (Template Panel)

왼쪽에서 카테고리를 선택하고, 가운데에서 템플릿을 체크하며, 오른쪽에서 코드를 실시간 미리보기합니다. 체크박스가 스크립트 내용의 적용 여부를 직접 제어합니다.

Template Panel

설정 인터페이스 (Settings)

Frida 도구 경로, 원격 연결 주소 및 로그 구성을 사용자 정의할 수 있습니다.

Settings

프로젝트 생성 마법사

표준화된 Frida 프로젝트 구조를 빠르게 생성합니다.

New Project

기술 아키텍처

개발 환경

언어: Java 21, Java, 빌드 스크립트는 Gradle Kotlin DSL 사용
프레임워크: IntelliJ Platform SDK
빌드 도구: Gradle
의존성: frida frida-tools (Python environment)

감사의 말

이 프로젝트에 Frida JS 스크립트 템플릿을 지원해 주신 다음 분들께 특별히 감사드립니다:

小佳
Lane
迷人

더 많은 기여자 및 감사 정보는 다음을 참조하세요: CONTRIBUTORS.md

zafrida-ui

인기