MagiskRenef

Модуль для Magisk / KernelSU / APatch, который автоматически упаковывает и запускает renef — набор инструментов динамической инструментации для Android.

Вдохновлено magisk-frida.

Требования

• Root-доступ на Android-устройстве (Magisk / KernelSU / KernelSU Next / APatch)
• Только ARM64 — renef поддерживает только ARM64 Android
• Рекомендуется Android 10+

Установка

1. Загрузите последний MagiskRenef-{version}.zip из Releases
2. Установите через ваш root-менеджер (Magisk / KSU / APatch)
3. Перезагрузите устройство

После перезагрузки renef_server запускается автоматически, используя UDS (Unix Domain Socket) на абстрактном сокете @com.android.internal.os.RuntimeInit.

Использование

Подключитесь с вашего компьютера с помощью клиента renef:

# Запустить новый процесс
renef -s com.example.app -l ваш-скрипт.lua

# Подключиться к запущенному процессу (сначала откройте приложение)
adb shell su 0 sh -c "pidof com.example.app"   # получить PID
renef -a <PID> -l ваш-скрипт.lua

Состояние модуля

После перезагрузки проверьте список модулей вашего root-менеджера:

• ✅ renef_server is running (UDS) — работает
• ❌ renef_server failed to start — см. раздел «Устранение неполадок»

Устранение неполадок

renef_server не запускается

Проверьте журнал сервера:

adb shell su 0 cat /data/local/tmp/renef_server.log

Ошибка внедрения — «Failed to find libc base»

Возможные причины:

• SELinux enforcing — наиболее частая причина на кастомных прошивках / устройствах Samsung:

  root@kitploit:~

  adb shell su -c setenforce 0
  

  Затем повторите попытку. Если работает — проблема в SELinux, блокирующем внедрение процесса renef.

• Устройство не рутировано — renef_server должен работать от root (uid 0)

• Неверная архитектура — поддерживается только ARM64

Ошибка запуска — банковские/защищённые приложения

Некоторые приложения устанавливают android:exported="false" для всех активностей. Флаг -s (spawn) использует monkey, который не может их запустить. Используйте -a (attach) вместо этого:

# 1. Откройте приложение вручную на устройстве
# 2. Получите его PID
adb shell su 0 sh -c "pidof com.example.app"
# 3. Подключитесь
renef -a <PID> -l ваш-скрипт.lua

Как это работает

Рабочий процесс GitHub Actions запускается ежедневно. Когда обнаруживается новый релиз renef, он:

1. Скачивает renef-v{VERSION}-android-arm64.tar.gz из релизов renef
2. Извлекает renef_server и libagent.so
3. Упаковывает их в ZIP-архив, совместимый с Magisk
4. Публикует новый релиз на GitHub

Сборка локально

# Установите uv (https://docs.astral.sh/uv/)
uv run python3 main.py

# Принудительная пересборка
FORCE_RELEASE=1 uv run python3 main.py

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

• renef от Ahmeth4n
• magisk-frida от ViRb3 (структурное вдохновение)