MagiskRenef

Android용 동적 계측 툴킷인 renef를 자동으로 패키징하고 실행하는 Magisk / KernelSU / APatch 모듈입니다.

magisk-frida에서 영감을 받았습니다.

요구 사항

루팅된 Android 기기 (Magisk / KernelSU / KernelSU Next / APatch)
ARM64만 지원 — renef는 ARM64 Android만 지원합니다
Android 10 이상 권장

설치

Releases에서 최신 MagiskRenef-{version}.zip을 다운로드하세요.
루트 매니저(Magisk / KSU / APatch)를 통해 설치하세요.
재부팅하세요.

재부팅 후, renef_server는 추상 소켓 @com.android.internal.os.RuntimeInit에서 UDS(Unix Domain Socket)를 사용하여 자동으로 시작됩니다.

사용법

호스트 머신에서 renef 클라이언트를 사용하여 연결하세요:

# 새 프로세스 스폰
renef -s com.example.app -l your-script.lua

# 실행 중인 프로세스에 어태치 (앱을 먼저 열어두세요)
adb shell su 0 sh -c "pidof com.example.app"   # PID 확인
renef -a <PID> -l your-script.lua

모듈 상태

재부팅 후, 루트 매니저의 모듈 목록을 확인하세요:

✅ 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) — 커스텀 ROM/Samsung 기기에서 가장 흔한 원인:
```
adb shell su -c setenforce 0
```
그런 다음 재시도하세요. 작동한다면 SELinux가 renef의 프로세스 인젝션을 차단하고 있는 것입니다.
기기가 루팅되지 않음 — renef_server는 루트(uid 0)로 실행되어야 합니다
잘못된 아키텍처 — ARM64만 지원됩니다

스폰 실패 — 금융/강화된 앱

일부 앱은 모든 활동에 android:exported="false"를 설정합니다. -s(스폰) 플래그는 monkey를 사용하며, 이로는 해당 앱을 실행할 수 없습니다. 대신 -a(어태치)를 사용하세요:

# 1. 기기에서 앱을 수동으로 엽니다.
# 2. PID를 확인합니다.
adb shell su 0 sh -c "pidof com.example.app"
# 3. 어태치합니다.
renef -a <PID> -l your-script.lua

작동 방식

GitHub Actions 워크플로우가 매일 실행됩니다. 새로운 renef 릴리스가 감지되면 다음을 수행합니다:

renef 릴리스에서 renef-v{VERSION}-android-arm64.tar.gz를 다운로드합니다.
renef_server와 libagent.so를 추출합니다.
Magisk 호환 ZIP으로 패키징합니다.
새로운 GitHub 릴리스를 게시합니다.

로컬에서 빌드하기

# uv 설치 (https://docs.astral.sh/uv/)
uv run python3 main.py

# 강제 재빌드
FORCE_RELEASE=1 uv run python3 main.py

크레딧

Ahmeth4n의 renef
ViRb3의 magisk-frida (구조 영감)

magisk-renef

인기