lakr233/vphone-cliЗагружайте и управляйте виртуальными iPhone на Apple Silicon с патчингом прошивки, вариантами джейлбрейка и функциями для исследований в области безопасности при тестировании и анализе iOS.
Запустите виртуальный iPhone на Mac с Apple Silicon.
vphone-cli запускает iOS с помощью Apple Virtualization.framework и исследовательских виртуальных машин PCC — для исследования безопасности, обратной разработки и отладки.
Физический Mac с Apple Silicon под управлением macOS 15 или новее. В виртуальной машине macOS это не работает.
Свободное место на диске. По умолчанию каждая виртуальная машина имеет виртуальный диск на 64 ГБ, а прошивка занимает больше.
Подключение к сети. При восстановлении системы билеты подписи загружаются онлайн.
Изменённые настройки безопасности. Загрузитесь в macOS Recovery, выполните эти команды в Terminal, затем перезагрузитесь:
csrutil enable --without debug
csrutil allow-research-guests enable
SIP остаётся включённым, ослаблены только ограничения отладки. Подробности см. в разделе Настройка хоста.
vphone-launchpad-<version>-notarized.zip из последнего релиза, распакуйте его и откройте. Не каждый релиз нотаризован. Если в последнем нет файла -notarized, выберите нотаризованную версию из раздела Загрузки.Launchpad скачивает прошивку, патчит её, восстанавливает систему и загружает виртуальную машину. Чтобы использовать собственные IPSW для iPhone и 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 автоматизации, добавьте --api-listen 127.0.0.1:8765 при запуске и используйте токен, который он выведет. См. документацию API.
| Документ | Содержание |
|---|---|
| Загрузки | Нотаризованные версии Launchpad и соответствующие версии VPhone.bundle |
| Настройка хоста | Настройки SIP и AMFI, сборка из исходников, проверки окружения |
| Создание и запуск | Источники прошивок, процесс создания, хранилище и резервные копии |
| Совместимость | Проверенные пары прошивок |
| Гости iPadOS | Запуск iPadOS (iPad mini A17 Pro) вместо iOS |
| Пакетное окружение | Установка и удаление менеджера пакетов в виртуальной машине |
| Устранение неполадок | Распространённые ошибки и способы их исправления |
| Сеть | Сетевые режимы и tunnel для Mac за VPN или прокси |
| Командная строка Launchpad | Установка и тестирование локальной сборки с помощью vphone-launchpad-cli |
| Участие в разработке | Структура проекта, сборка из исходников, заметки об исследованиях |
Если это не решает вашу проблему, откройте issue.