lakr233/vphone-cliArranca y gestiona iPhones virtuales en Apple Silicon con parcheo de firmware, variantes de jailbreak y funciones de investigación de seguridad para pruebas y análisis de iOS.
Ejecuta un iPhone virtual en un Mac con Apple Silicon.
vphone-cli ejecuta iOS con Virtualization.framework de Apple y máquinas virtuales de investigación PCC, para investigación de seguridad, ingeniería inversa y depuración.
Un Mac físico con Apple Silicon ejecutando macOS 15 o posterior. No funciona en una máquina virtual de macOS.
Espacio libre en disco. Cada máquina virtual tiene un disco virtual de 64 GB por defecto, y el firmware ocupa más.
Una conexión de red. La restauración del sistema obtiene los tickets de firma en línea.
Ajustes de seguridad modificados. Arranca en macOS Recovery, ejecuta estos comandos en Terminal y luego reinicia:
csrutil enable --without debug
csrutil allow-research-guests enable
SIP permanece habilitado, con solo las restricciones de depuración relajadas. Para más detalles, consulta Configuración del host.
vphone-launchpad-<version>-notarized.zip desde la última versión, descomprímelo y ábrelo. No todas las versiones están notarizadas. Si la última no tiene un archivo -notarized, elige una versión notarizada de Descargas.Launchpad descarga el firmware, lo parchea, restaura el sistema y arranca la máquina virtual. Para usar tus propios IPSW de iPhone y cloudOS, consulta Compatibilidad.
Para instalar un gestor de paquetes en la máquina virtual, consulta Entorno de paquetes.
Si usas un agente de programación (Claude Code, Codex o similar) en este Mac, pega el siguiente prompt en lugar de seguir los pasos manualmente. El agente lee la skill de vphone, comprueba qué está ya configurado, instala Launchpad y VPhone.bundle, y se detiene para preguntar cuando un paso te necesita, como una contraseña de administrador o un cambio en 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 controla las máquinas virtuales a través de vphone-cli dentro de VPhone.bundle. También puedes ejecutarlo en Terminal:
vphone-cli vm list
vphone-cli vm launch myphone
vphone-cli vm export myphone --out myphone.tzst
Las máquinas virtuales se almacenan en ~/.vphone/. Ejecuta vphone-cli <group> --help para ver todos los comandos. Para crear una máquina virtual sin Launchpad, consulta Crear y ejecutar.
Para activar la API de automatización, añade --api-listen 127.0.0.1:8765 al arrancar y usa el token que imprime. Consulta la documentación de la API.
| Documento | Contenido |
|---|---|
| Descargas | Versiones notarizadas de Launchpad y versiones correspondientes de VPhone.bundle |
| Configuración del host | Ajustes de SIP y AMFI, compilación desde el código fuente, comprobaciones del entorno |
| Crear y ejecutar | Fuentes de firmware, el proceso de creación, almacenamiento y copias de seguridad |
| Compatibilidad | Emparejamientos de firmware verificados |
| Invitados iPadOS | Ejecutar iPadOS (iPad mini A17 Pro) en lugar de iOS |
| Entorno de paquetes | Instalar y eliminar un gestor de paquetes en la máquina virtual |
| Solución de problemas | Errores comunes y cómo solucionarlos |
| Redes | Modos de red, y tunnel para un Mac detrás de una VPN o proxy |
| Línea de comandos de Launchpad | Instalar y probar una compilación local con vphone-launchpad-cli |
| Contribuir | Estructura del proyecto, compilación desde el código fuente, notas de investigación |
Si esto no resuelve tu problema, abre un issue.