lakr233/vphone-cliBoot e gerencie iPhones virtuais em Apple Silicon com patch de firmware, variantes de jailbreak e recursos de pesquisa de segurança para testes e análise de iOS.
Execute um iPhone virtual em um Mac com Apple Silicon.
O vphone-cli executa o iOS com o Virtualization.framework da Apple e máquinas virtuais de pesquisa do PCC, para pesquisa de segurança, engenharia reversa e depuração.
Um Mac físico com Apple Silicon rodando macOS 15 ou mais recente. Não funciona em uma VM do macOS.
Espaço livre em disco. Cada VM tem um disco virtual de 64 GB por padrão, e o firmware ocupa mais.
Uma conexão de rede. A restauração do sistema busca tickets de assinatura online.
Configurações de segurança ajustadas. Inicialize no macOS Recovery, execute estes comandos no Terminal e reinicie:
csrutil enable --without debug
csrutil allow-research-guests enable
O SIP permanece ativado, com apenas as restrições de depuração relaxadas. Para detalhes, veja Host Setup.
vphone-launchpad-<version>-notarized.zip da última release, descompacte e abra. Nem toda release é notarizada. Se a mais recente não tiver um arquivo -notarized, escolha uma versão notarizada em Downloads.O Launchpad baixa o firmware, aplica os patches, restaura o sistema e inicializa a VM. Para usar seus próprios IPSWs de iPhone e cloudOS, veja Compatibility.
Para instalar um gerenciador de pacotes na VM, veja Package Environment.
Se você usa um agente de programação (Claude Code, Codex ou similar) neste Mac, cole o prompt abaixo em vez de seguir os passos manualmente. O agente lê a skill do vphone, verifica o que já está configurado, instala o Launchpad e o VPhone.bundle, e para para perguntar quando um passo precisa de você, como uma senha de administrador ou uma alteração no 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.
O Launchpad controla VMs através do vphone-cli dentro do VPhone.bundle. Você também pode executá-lo no Terminal:
vphone-cli vm list
vphone-cli vm launch myphone
vphone-cli vm export myphone --out myphone.tzst
As VMs são armazenadas em ~/.vphone/. Execute vphone-cli <group> --help para ver todos os comandos. Para criar uma VM sem o Launchpad, veja Create and Run.
Para ativar a API de automação, adicione --api-listen 127.0.0.1:8765 na inicialização e use o token que ela imprime. Veja a documentação da API.
| Documento | Conteúdo |
|---|---|
| Downloads | Versões notarizadas do Launchpad e versões correspondentes do VPhone.bundle |
| Host Setup | Configurações de SIP e AMFI, compilação a partir do código-fonte, verificações de ambiente |
| Create and Run | Fontes de firmware, o processo de criação, armazenamento e backups |
| Compatibility | Pareamentos de firmware verificados |
| iPadOS Guests | Executar iPadOS (iPad mini A17 Pro) em vez de iOS |
| Package Environment | Instalar e remover um gerenciador de pacotes na VM |
| Troubleshooting | Erros comuns e como corrigi-los |
| Networking | Modos de rede, e tunnel para um Mac atrás de uma VPN ou proxy |
| Launchpad Command Line | Instalar e testar uma compilação local com vphone-launchpad-cli |
| Contributing | Estrutura do projeto, compilação a partir do código-fonte, notas de pesquisa |
Se isso não resolver o seu problema, abra uma issue.