中文 | English

ZAFrida UI - PyCharm Frida Plugin

Текущая версия: 0.3.6

Описание проекта

Графический инструмент Frida, разработанный специально для PyCharm/IntelliJ

ZAFrida UI — это плагин для графической работы с Frida, интегрированный в PyCharm и другие IDE семейства JetBrains. Он решает проблемы громоздких команд Frida и хаотичного управления скриптами, предоставляя полный интерфейс пользователя для управления устройствами, процессами, скриптами и журналами.

Ключевая особенность — система управления шаблонами "по флажкам": пользователи могут динамически вставлять или комментировать фрагменты кода в основном скрипте с помощью установки/снятия флажков, собирая Hook-скрипты по принципу "конструктора". Кроме того, плагин включает полное управление проектами (zafrida-project.xml) с поддержкой быстрого переключения между конфигурациями для нескольких устройств и сред.

ZAFrida не заменяет Frida, а служит мощной UI-оболочкой для frida-tools, бесшовно взаимодействуя с вашей существующей средой Python и Frida.

Упрощённая Wiki: ZAFrida UI Упрощённая Wiki (BBS) (это более простая Wiki) Подробное руководство: ZAFrida UI Подробное руководство Wiki

Демонстрация

Быстрый старт

1. Установка плагина: В маркетплейсе плагинов IDE найдите "ZAFrida" или установите через диск.
2. Настройка окружения: Откройте Settings -> Tools -> ZAFrida, укажите путь к исполняемому файлу frida (если не определён автоматически).
3. Создание проекта: В представлении проекта нажмите правой кнопкой мыши -> New Frida Project.
4. Написание/выбор скрипта: В панели Run выберите ваш agent.js.
5. Отладка Hook:

• Подключите устройство (USB, Remote или Gadget).
• Выберите целевой процесс или имя пакета.
• Нажмите Run.

6. Использование шаблонов: Перейдите на вкладку Templates, отметьте нужные функции Hook (например, "SSL Pinning Bypass"), код будет автоматически вставлен в ваш скрипт.
7. Автоматизация Skills (опционально): По умолчанию отключена. Перейдите в Settings/Preferences -> ZAFrida -> Skills HTTP API, включите Enable Skills для автоматического запуска локального API (также можно вручную Start/Stop). CLI и расположение шаблонов:
   • skills-cli/zafrida_skill_cli.py
   • skills-template/zafrida-http-control/

QR-код группы

Функциональные возможности

• Управление устройствами и процессами
  Интеграция frida-ls-devices и frida-ps, поддержка обновления списка устройств одним щелчком, просмотр запущенных процессов, работающих приложений или установленных приложений.

• Многомодальное подключение
  Полная поддержка режимов USB / Remote / Gadget, настраиваемые удалённый хост и порт — без ручного составления сложных команд.

• Интерактивный запуск скриптов (Run / Attach)

  • Поддержка действий Run (по умолчанию Spawn) и Attach, а не просто "переключение режимов".
  • Поддержка Force Stop для принудительной остановки целевого приложения.
  • Встроенный вывод консоли с автоматическим сохранением журналов в каталог проекта zafrida-logs/.

• Контекстное меню редактора JS (важно)

  • В области редактирования файлов Frida JS нажмите правой кнопкой мыши, чтобы напрямую выбрать:
    • Run Frida JS: выполнить текущий JS-файл как основной скрипт (по умолчанию Spawn).
    • Attach Frida JS: внедрить текущий JS-файл как дополнительный скрипт в уже запущенный целевой процесс.
  • Перед выполнением файл автоматически сохраняется, и плагин переключается на проект ZAFrida, к которому относится скрипт.
  • Идеально подходит для быстрого PoC, демонстрации, режима Gadget или мгновенного внедрения в работающий процесс.
  • Горячие клавиши:
    • Windows / Linux: Ctrl + Alt + S
    • macOS: ⌘ + ⌥ + S

• Вставка сниппетов через контекстное меню редактора

Сценарии использования

ZAFrida UI подходит для всех сценариев реверс-инжиниринга с использованием Frida, особенно:

• Тестирование на проникновение и реверсивный анализ приложений Android / iOS.
• Отладка, требующая частого переключения между различными Hook-скриптами.
• Инженеры, привыкшие использовать IDE (PyCharm/IDEA) для смешанной разработки на Python и JS.

Техническая документация

• Системные требования:

  • IntelliJ IDEA или PyCharm (рекомендуется 2024.3+)
  • Установленные Python3 и frida-tools (pip install frida-tools)
  • Убедитесь, что frida, frida-ps, frida-ls-devices находятся в системном PATH или указаны в настройках плагина.

• Обратная связь: Github Issues

Запуск проекта

1. Клонируйте исходный код: git clone https://github.com/yilongmd/zafrida-ui.git
2. Откройте проект в IntelliJ IDEA.
3. Запустите задачу Gradle runIde для запуска отладочной среды.

Скриншоты системы

Главный интерфейс и панель запуска (Run Panel)

Выбор устройства, скрипта, настройка режима запуска и вывод консоли.

Управление динамическими шаблонами (Template Panel)

Слева — выбор категории, в центре — выбор шаблонов флажками, справа — предварительный просмотр кода. Флажки напрямую управляют включением/отключением кода в скрипте.

Настройки (Settings)

Поддержка настройки пути к инструментам Frida, адреса удалённого подключения и конфигурации журнала.

Мастер создания проекта

Быстрое создание стандартизированной структуры проекта Frida.

Техническая архитектура

Среда разработки

• Язык: Java 21, Java, скрипты сборки на Gradle Kotlin DSL
• Фреймворк: IntelliJ Platform SDK
• Инструмент сборки: Gradle
• Зависимости: frida frida-tools (среда Python)

Благодарности

Особая благодарность следующим разработчикам за предоставленные шаблоны скриптов Frida JS для этого проекта:

• Сяоцзя
• Lane
• Мижэнь

Дополнительная информация о вкладчиках: CONTRIBUTORS.md