中文 | Inglés

ZAFrida UI - PyCharm Frida Plugin

Versión actual: 0.3.6

Introducción del proyecto

Herramienta gráfica de Frida diseñada para PyCharm/IntelliJ

ZAFrida UI es un complemento de operación gráfica de Frida integrado en PyCharm y en los IDE de la familia JetBrains. Está diseñado para resolver los problemas de tediosas operaciones en línea de comandos de Frida y la gestión desordenada de scripts, proporcionando un conjunto completo de interfaz de interacción UI para gestionar dispositivos, procesos, scripts y registros.

La característica principal es su sistema de gestión de plantillas tipo "casilla de verificación": el usuario puede marcar/desmarcar para insertar dinámicamente fragmentos de código en el script principal o comentarlos, logrando así un ensamblaje "modular" de scripts Hook. Al mismo tiempo, el complemento incorpora una gestión completa basada en proyectos (zafrida-project.xml), que admite el cambio rápido de configuraciones multi-dispositivo y multi-entorno.

ZAFrida no reemplaza a Frida, sino que actúa como un potente shell de UI para frida-tools, conectándose sin problemas con su entorno Python y Frida existente.

Wiki simplificada: ZAFrida UI Wiki simplificada (BBS) (Esta es la wiki más simple) Tutorial detallado de uso: Wiki detallada de ZAFrida UI

Demostración

Inicio rápido

1. Instalar el complemento: Busque "ZAFrida" en el mercado de complementos del IDE o instálelo desde disco.
2. Configurar el entorno: Abra Settings -> Tools -> ZAFrida, configure la ruta del ejecutable frida (si no se detecta automáticamente).
3. Crear un proyecto: Haga clic derecho en la vista de proyecto -> New Frida Project.
4. Escribir/Seleccionar script: En el panel Run, seleccione su agent.js.
5. Depurar con Hook:

• Conecte el dispositivo (USB, Remote o Gadget).
• Seleccione el proceso o nombre de paquete objetivo.
• Haga clic en Run.

6. Usar plantillas: Cambie a la pestaña Templates, marque las funciones Hook que necesite (por ejemplo, "SSL Pinning Bypass"), el código se inyectará automáticamente en su script.
7. Automatización Skills (opcional): Desactivado por defecto. Vaya a Settings/Preferences -> ZAFrida -> Skills HTTP API, marque Enable Skills para iniciar automáticamente la API local (también puede iniciar/detener manualmente). Ubicación de la CLI y plantillas:
   • skills-cli/zafrida_skill_cli.py
   • skills-template/zafrida-http-control/

Código QR del grupo de comunicación

Características

• Gestión de dispositivos y procesos
  Integra frida-ls-devices y frida-ps, admite actualización con un clic de la lista de dispositivos, visualización de procesos en ejecución, aplicaciones activas o aplicaciones instaladas.

• Conexión en múltiples modos
  Soporte completo para los modos USB / Remote / Gadget, admite Host y Puerto remoto personalizados, sin necesidad de construir manualmente parámetros complejos de línea de comandos.

• Ejecución interactiva de scripts (Run / Attach)

  • Soporta las acciones de Run (Spawn por defecto) y Attach, no solo un simple "cambio de modo".
  • Soporta Force Stop para detener forzosamente la aplicación objetivo.
  • Consola integrada de salida de registros, guarda automáticamente los registros en el directorio del proyecto zafrida-logs/.

• Menú contextual del editor JS (importante)

  • En el área de edición de archivos Frida JS, haga clic derecho para seleccionar directamente:
    • Run Frida JS: Ejecuta el archivo JS actual como script principal (Spawn por defecto).
    • Attach Frida JS: Inyecta el archivo JS actual como script adicional en el proceso objetivo ya en ejecución.
  • Antes de ejecutar, guarda automáticamente el archivo actual y cambia al proyecto ZAFrida correspondiente.
  • Ideal para PoC rápido, verificación de demos, modo Gadget o inyección instantánea en procesos en ejecución.
  • Atajos de teclado:
    • Windows / Linux: Ctrl + Alt + S
    • macOS: ⌘ + ⌥ + S

Escenarios de uso

ZAFrida UI es adecuado para todos los escenarios de ingeniería inversa que utilicen Frida, especialmente:

• Pruebas de penetración y análisis inverso de aplicaciones Android / iOS.
• Procesos de depuración que requieren cambiar frecuentemente entre diferentes scripts Hook.
• Ingenieros acostumbrados a usar IDE (PyCharm/IDEA) para desarrollo mixto Python y JS.

Documentación técnica

• Requisitos del entorno:

  • IntelliJ IDEA o PyCharm (se recomienda 2024.3+)
  • Python3 y frida-tools instalados localmente (pip install frida-tools)
  • Asegúrese de que frida, frida-ps, frida-ls-devices estén en el PATH del sistema o especificados en la configuración del complemento.

• Reporte de problemas: Github Issues

Iniciar el proyecto

1. Clonar el código fuente: git clone https://github.com/yilongmd/zafrida-ui.git
2. Abrir el proyecto con IntelliJ IDEA.
3. Ejecutar la tarea Gradle runIde para iniciar el entorno de depuración.

Capturas de pantalla

Panel principal y de ejecución (Run Panel)

Proporciona selección de dispositivo, selección de script, configuración del modo de ejecución y salida de consola.

Gestión de plantillas dinámicas (Template Panel)

Categorías seleccionables a la izquierda, plantillas marcables en el centro, previsualización de código en tiempo real a la derecha. Las casillas de verificación controlan directamente la activación/desactivación del contenido del script.

Interfaz de configuración (Settings)

Admite personalizar la ruta de la herramienta Frida, la dirección de conexión remota y la configuración de registros.

Asistente de creación de proyectos

Crea rápidamente una estructura de proyecto Frida estandarizada.

Arquitectura técnica

Entorno de desarrollo

• Lenguaje: Java 21, Java, scripts de construcción con Gradle Kotlin DSL
• Framework: IntelliJ Platform SDK
• Herramienta de construcción: Gradle
• Dependencias: frida frida-tools (entorno Python)

Agradecimientos

Agradecimientos especiales a los siguientes colaboradores que proporcionaron soporte de plantillas de scripts Frida JS para este proyecto:

• 小佳
• Lane
• 迷人

Para más contribuyentes e información de agradecimientos, consulte: CONTRIBUTORS.md