frida-ipa-extract

هذا المشروع مستوحى من frida-ios-dump. نظرًا لأنني واجهت مؤخرًا مشاكل مع تلك الأداة، قررت إنشاء frida-ipa-extract بقوة أكبر وإضافات لمعالجة المشاكل التي نواجهها اليوم. استخراج ملف .ipa مفكوك التشفير من جهاز iOS مكسور الحماية باستخدام Frida. يدعم التطبيقات المثبتة عبر App Store، والتثبيت الجانبي، وتطبيقات النظام.

المتطلبات

• Python 3.9+
• جهاز iOS مكسور الحماية مع تشغيل frida-server
• لوضع SSH: OpenSSH على الجهاز

التثبيت:

# Install as a standalone tool using uv or pipx
uv tool install git+https://github.com/lautarovculic/frida-ipa-extract.git

# Or install as an editable package (for development)
pip install -e .

الاستخدام

# Using the entry point (if installed as standalone tool)
frida-ipa-extract

# Or using the script directly
python extract.py -U -f com.example.app -o MyApp.ipa
python extract.py -U -f com.example.app -o MyApp.ipa --sandbox
python extract.py -U -f com.example.app -o MyApp.ipa --no-resume
python -m frida_ipa_extract -U --pid 1234 -o MyApp.ipa
./extract.py -U "My Running App"
python extract.py -H 192.168.100.32 -P 2222 -u root -p password -f com.example.app

الوسائط:

• -f <target>: تشغيل تطبيق (معرف الحزمة أو اسم التطبيق)
• --pid <pid>: الالتصاق بعملية جارية PID
• target (موضعي): اسم التطبيق/معرف الحزمة لتطبيق قيد التشغيل
• -o <path>: مسار إخراج IPA (الافتراضي <AppName>.ipa)
• -U: الاتصال عبر USB
• -H <host> -P <port> -u <user> -p <pass>: الاتصال عبر SSH (paramiko)
• --sandbox: تفريغ صندوق رمل التطبيق إلى <AppName>-sandbox في الدليل الحالي
• --no-resume: إبقاء التطبيق المشغل معلقًا (مفيد إذا تعطل التطبيق بسبب كشف كسر الحماية عند التجهيز)

إذا لم تمرر -f أو --pid، تلتصق الأداة بتطبيق قيد التشغيل. إذا لم يتم توفير هدف، فستعرض التطبيقات الجارية وتطلب منك الاختيار.

ملاحظات

• عند استخدام SSH بدون -U، تفتح الأداة نفقًا محليًا إلى frida-server على المنفذ 27042 وتستخدم SFTP لتنزيل حزمة التطبيق. إذا مررت كلاً من -U و-H، يتم استخدام USB لـ Frida ويستخدم SSH فقط لنقل الملفات.
• عند استخدام USB بدون SSH، يتم سحب الحزمة عبر Frida RPC (أبطأ للتطبيقات الكبيرة).
• إذا لم يكن التطبيق قيد التشغيل، استخدم -f لتشغيله.
• تأكد من تشغيل frida-server على الجهاز قبل التفريغ.
• يظهر شريط تقدم أثناء تنزيل الملفات.
• إذا فقدت جلسة Frida أثناء التنزيل، تعيد الأداة المحاولة بالتبديل إلى عملية نظام مستقرة؛ للتطبيقات العنيدة استخدم --no-resume أو نقل SSH.

استكشاف الأخطاء وإصلاحها

• Frida attach timed out: قد يحظر التطبيق الالتصاق؛ استخدم -f للتشغيل أو جرب --no-resume.
• script has been destroyed أثناء التنزيل: تعطل التطبيق؛ أعد المحاولة مع --no-resume أو استخدم نقل SSH (-H/-u/-p).
• No running apps found: التطبيق غير قيد التشغيل؛ استخدم -f لتشغيله.