lakr233/vphone-cliقم بتشغيل وإدارة أجهزة iPhone افتراضية على Apple Silicon مع تصحيح البرامج الثابتة، وأنواع كسر الحماية، وميزات أبحاث الأمان لاختبار وتحليل iOS.
شغّل iPhone افتراضي على Mac بشريحة Apple Silicon.
يشغّل vphone-cli نظام iOS باستخدام Virtualization.framework من Apple وأجهزة PCC البحثية الافتراضية، لأغراض البحث الأمني والهندسة العكسية وتصحيح الأخطاء.
جهاز Mac فعلي بشريحة Apple Silicon يعمل بنظام macOS 15 أو أحدث. لا يعمل داخل جهاز macOS افتراضي.
مساحة قرص حرة. يحتوي كل جهاز افتراضي على قرص افتراضي بسعة 64 GB افتراضيًا، ويستهلك البرنامج الثابت مساحة أكبر.
اتصال بالشبكة. تتطلب استعادة النظام جلب تذاكر التوقيع عبر الإنترنت.
إعدادات أمان معدّلة. أقلع في وضع macOS Recovery، ونفّذ هذه الأوامر في Terminal، ثم أعد التشغيل:
csrutil enable --without debug
csrutil allow-research-guests enable
يبقى SIP مفعّلًا، مع تخفيف قيود تصحيح الأخطاء فقط. لمزيد من التفاصيل، راجع إعداد المضيف.
vphone-launchpad-<version>-notarized.zip من أحدث إصدار، وفك ضغطه، وافتحه. ليست كل الإصدارات موثّقة. إذا لم يحتوي أحدث إصدار على ملف -notarized، فاختر إصدارًا موثّقًا من التنزيلات.يقوم Launchpad بتنزيل البرنامج الثابت وترقيعه واستعادة النظام وإقلاع الجهاز الافتراضي. لاستخدام iPhone الخاص بك وملفات IPSW من cloudOS، راجع التوافق.
لتثبيت مدير حزم في الجهاز الافتراضي، راجع بيئة الحزم.
إذا كنت تستخدم وكيلًا برمجيًا (Claude Code أو Codex أو ما شابه) على جهاز Mac هذا، فالصق الموجّه أدناه بدلًا من اتباع الخطوات يدويًا. يقرأ الوكيل مهارة vphone، ويتحقق مما تم إعداده بالفعل، ويثبّت Launchpad وVPhone.bundle، ويتوقف ليسألك عندما تتطلب خطوة تدخّلك، مثل كلمة مرور المسؤول أو تغيير في macOS Recovery.
Set up vphone on this Mac. Read the skill at
https://raw.githubusercontent.com/Lakr233/vphone-cli/main/Skills/vphone-guest-control/SKILL.md
and the files it links under references/ (same folder), then follow them:
install the newest notarized vphone-launchpad (not every release has a
-notarized zip), put vphone-launchpad-cli on PATH, install the VPhone.bundle
that matches Launchpad's series, and check `vphone-launchpad-cli status`.
Do not change SIP, boot-args or any other host security setting, and do not
create a machine until I confirm the firmware and the free disk space. When a
step needs me, tell me exactly what to do and wait.
يقود Launchpad الأجهزة الافتراضية عبر vphone-cli الموجود داخل VPhone.bundle. يمكنك أيضًا تشغيله في Terminal:
vphone-cli vm list
vphone-cli vm launch myphone
vphone-cli vm export myphone --out myphone.tzst
تُخزَّن الأجهزة الافتراضية في ~/.vphone/. نفّذ vphone-cli <group> --help لعرض جميع الأوامر. لإنشاء جهاز افتراضي بدون Launchpad، راجع الإنشاء والتشغيل.
لتفعيل واجهة برمجة تطبيقات الأتمتة، أضف --api-listen 127.0.0.1:8765 عند التشغيل واستخدم الرمز الذي يطبعه. راجع توثيق واجهة برمجة التطبيقات.
| المستند | المحتويات |
|---|---|
| التنزيلات | إصدارات Launchpad الموثّقة وإصدارات VPhone.bundle المطابقة لها |
| إعداد المضيف | إعدادات SIP وAMFI، والبناء من المصدر، وفحوصات البيئة |
| الإنشاء والتشغيل | مصادر البرنامج الثابت، وعملية الإنشاء، والتخزين والنسخ الاحتياطي |
| التوافق | اقترانات البرنامج الثابت التي تم التحقق منها |
| أجهزة iPadOS الافتراضية | تشغيل iPadOS (iPad mini A17 Pro) بدلًا من iOS |
| بيئة الحزم | تثبيت مدير حزم في الجهاز الافتراضي وإزالته |
| استكشاف الأخطاء وإصلاحها | الأخطاء الشائعة وكيفية إصلاحها |
| الشبكات | أوضاع الشبكة، وtunnel لجهاز Mac خلف VPN أو وكيل |
| سطر أوامر Launchpad | تثبيت نسخة محلية واختبارها باستخدام vphone-launchpad-cli |
| المساهمة | بنية المشروع، والبناء من المصدر، وملاحظات البحث |
إذا لم تحل هذه المشكلة، افتح تذكرة.