lakr233/vphone-cliAvvia e gestisci iPhone virtuali su Apple Silicon con patch del firmware, varianti di jailbreak e funzionalità di ricerca sulla sicurezza per test e analisi iOS.
Esegui un iPhone virtuale su un Mac con Apple Silicon.
vphone-cli esegue iOS con Virtualization.framework di Apple e le macchine virtuali di ricerca PCC, per la ricerca sulla sicurezza, il reverse engineering e il debug.
Un Mac fisico con Apple Silicon che esegue macOS 15 o versioni successive. Non funziona in una VM macOS.
Spazio su disco libero. Ogni VM ha un disco virtuale da 64 GB per impostazione predefinita, e il firmware ne occupa altro.
Una connessione di rete. Il ripristino del sistema scarica i ticket di firma online.
Impostazioni di sicurezza modificate. Avvia in macOS Recovery, esegui questi comandi nel Terminale, poi riavvia:
csrutil enable --without debug
csrutil allow-research-guests enable
SIP rimane abilitato, con solo le restrizioni di debug allentate. Per i dettagli, vedi Host Setup.
vphone-launchpad-<version>-notarized.zip dalla release più recente, estrailo e aprilo. Non tutte le release sono notarizzate. Se l'ultima non ha un file -notarized, scegli una versione notarizzata da Downloads.Launchpad scarica il firmware, lo patcha, ripristina il sistema e avvia la VM. Per usare il tuo iPhone e gli IPSW di cloudOS, vedi Compatibility.
Per installare un gestore di pacchetti nella VM, vedi Package Environment.
Se usi un agente di programmazione (Claude Code, Codex o simili) su questo Mac, incolla il prompt qui sotto invece di seguire i passaggi manualmente. L'agente legge la skill vphone, controlla cosa è già configurato, installa Launchpad e VPhone.bundle, e si ferma a chiedere quando un passaggio richiede il tuo intervento, come una password di amministratore o una modifica in 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 gestisce le VM tramite vphone-cli all'interno di VPhone.bundle. Puoi anche eseguirlo nel Terminale:
vphone-cli vm list
vphone-cli vm launch myphone
vphone-cli vm export myphone --out myphone.tzst
Le VM sono archiviate in ~/.vphone/. Esegui vphone-cli <group> --help per vedere tutti i comandi. Per creare una VM senza Launchpad, vedi Create and Run.
Per attivare l'API di automazione, aggiungi --api-listen 127.0.0.1:8765 all'avvio e usa il token che stampa. Vedi la documentazione API.
| Documento | Contenuto |
|---|---|
| Downloads | Versioni notarizzate di Launchpad e versioni corrispondenti di VPhone.bundle |
| Host Setup | Impostazioni SIP e AMFI, compilazione dal sorgente, controlli dell'ambiente |
| Create and Run | Sorgenti del firmware, processo di creazione, archiviazione e backup |
| Compatibility | Abbinamenti di firmware verificati |
| iPadOS Guests | Esegui iPadOS (iPad mini A17 Pro) invece di iOS |
| Package Environment | Installazione e rimozione di un gestore di pacchetti nella VM |
| Troubleshooting | Errori comuni e come risolverli |
| Networking | Modalità di rete, e tunnel per un Mac dietro una VPN o un proxy |
| Launchpad Command Line | Installa e testa una build locale con vphone-launchpad-cli |
| Contributing | Struttura del progetto, compilazione dal sorgente, note di ricerca |
Se questi non risolvono il tuo problema, apri una issue.