MagiskRenef

Um módulo Magisk / KernelSU / APatch que empacota e executa automaticamente o renef — um kit de ferramentas de instrumentação dinâmica para Android.

Inspirado por magisk-frida.

Requisitos

• Dispositivo Android com root (Magisk / KernelSU / KernelSU Next / APatch)
• Apenas ARM64 — o renef suporta apenas Android ARM64
• Android 10+ recomendado

Instalação

1. Baixe o MagiskRenef-{version}.zip mais recente em Releases
2. Instale através do seu gerenciador de root (Magisk / KSU / APatch)
3. Reinicie

Após a reinicialização, o renef_server inicia automaticamente usando UDS (Unix Domain Socket) no socket abstrato @com.android.internal.os.RuntimeInit.

Uso

Conecte-se a partir da sua máquina host usando o cliente renef:

# Iniciar um novo processo
renef -s com.example.app -l your-script.lua

# Anexar a um processo em execução (abra o aplicativo primeiro)
adb shell su 0 sh -c "pidof com.example.app"   # obter PID
renef -a <PID> -l your-script.lua

Status do Módulo

Após a reinicialização, verifique a lista de módulos do seu gerenciador de root:

• ✅ renef_server is running (UDS) — saudável
• ❌ renef_server failed to start — veja Solução de Problemas

Solução de Problemas

renef_server falhou ao iniciar

Verifique o log do servidor:

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

Falha na Injeção — Failed to find libc base

Possíveis causas:

• SELinux em modo enforcing — causa mais comum em ROMs personalizadas / dispositivos Samsung:

  root@kitploit:~

  adb shell su -c setenforce 0
  

  Depois tente novamente. Se funcionar, o problema é o SELinux bloqueando a injeção de processo do renef.

• Dispositivo sem root — o renef_server deve ser executado como root (uid 0)

• Arquitetura errada — apenas ARM64 é suportado

Falha na Inicialização — aplicativos bancários/protegidos

Alguns aplicativos definem android:exported="false" em todas as atividades. A flag -s (spawn) usa o monkey, que não consegue iniciá-los. Use -a (attach) no lugar:

# 1. Abra o aplicativo manualmente no seu dispositivo
# 2. Obtenha o PID
adb shell su 0 sh -c "pidof com.example.app"
# 3. Anexe
renef -a <PID> -l your-script.lua

Como Funciona

Um workflow do GitHub Actions é executado diariamente. Quando uma nova versão do renef é detectada, ele:

1. Baixa renef-v{VERSION}-android-arm64.tar.gz dos releases do renef
2. Extrai renef_server e libagent.so
3. Empacota-os em um ZIP compatível com Magisk
4. Publica um novo release no GitHub

Compilando Localmente

# Instale o uv (https://docs.astral.sh/uv/)
uv run python3 main.py

# Forçar uma recompilação
FORCE_RELEASE=1 uv run python3 main.py

Créditos

• renef por Ahmeth4n
• magisk-frida por ViRb3 (inspiração na estrutura)