vphone-web README

The project's README from github.com/34306/vphone-web. As one markdown file: README.md.

vphone-web

I vibe code this repo so please if you had anything issue with AI then just skip it. (i vibed but still checking the function before sharing so it must be work fine)

A self-hosted web platform for running multiple virtual iPhones at once in the browser — user accounts + RBAC, per-user device assignment, live screen streaming (WebRTC with an MJPEG/WebSocket fallback), touch & hardware-key input, IPA/TIPA install, an in-browser root shell and a file browser, on top of the vphone-cli engine (Apple Virtualization.framework, PV=3 research VMs).

You need build the vphone-cli and create your own base VM locally, i did not included it here due to large files.

Requirements

1. Clone (recursive)

git clone --recursive https://github.com/34306/vphone-web.git
cd vphone-web

This also creates vendor/vphone-cli/ with the full engine + toolchain.

2. Build the vphone-cli engine

cd vendor/vphone-cli
make setup_tools     # brew deps, build toolchain, create its Python venv
make build           # build + sign the vphone-cli binary
make bundle          # app bundle (bundles the IPA signing cert) — recommended
cd ../..

3. Create a base VM

Each web VM is an instant copy-on-write clone of a base VM directory. Build one with vphone-cli's automated pipeline (downloads IPSW + cloudOS, restores, patches, installs CFW, first boot).

See vendor/vphone-cli/README.md for the full firmware matrix, supported iOS/cloudOS builds, variants (regular / dev / jb / exp), and how to resolve IPSW URLs. When it finishes, the base lives at vendor/vphone-cli/vm/ (contains Disk.img, nvram.bin, SEPStorage, config.plist, AVPBooter*.bin, .vphoned.signed).

Tip — one base per iOS version. Keep each version's base in its own folder (vm/, vm-26.5/, vm-27/, …) and point the matching VPHONE_BASE_VM* env var at it. The web only offers versions whose Disk.img actually exists.

Boot cleanly. Always Stop a VM from the web UI (or Ctrl-C the process) and let it finish shutting down before copying/promoting a base — a hard kill leaves the APFS volume dirty and the next boot does a slow fsck replay.

4. Configure & run the web

cp .env.example .env          # then edit paths (see below)
make web_setup                # create .venv, install web deps
make web_seed_admin USER=admin PASS='choose-a-strong-password'
make web_run                  # serves http://127.0.0.1:8080

Open http://127.0.0.1:8080, sign in as the admin, then:

  1. Admin → Create VM — pick an iOS version; it clones the base instantly.
  2. Admin → assign the VM to one or more users.
  3. As a user: Start → Open → interact; drag on the screen for touch, use the home/power/volume buttons, or the SSH/Files tabs. Drop an .ipa/.tipa on the install zone to install.

Admin-only logs dashboard live-tails every VM at /logs.

5. (Optional) Expose it with a Cloudflare Tunnel

The server binds 127.0.0.1 only. To reach it from the internet without opening a port, use a Cloudflare Tunnel. You need a domain on Cloudflare.

brew install cloudflared
cloudflared tunnel login                      # authorize your domain (opens browser)
cloudflared tunnel create vphone              # creates a tunnel + credentials json
cloudflared tunnel route dns vphone phone.example.com   # your hostname

Create ~/.cloudflared/config.yml (replace the id + hostname with yours):

tunnel: <YOUR-TUNNEL-ID>
credentials-file: /Users/<you>/.cloudflared/<YOUR-TUNNEL-ID>.json
ingress:
  - hostname: phone.example.com
    service: http://localhost:8080
  - service: http_status:404

Run it:

cloudflared tunnel run vphone

Notes:

Auto-start on boot (macOS LaunchAgent, optional)

Run the web + tunnel automatically after a reboot/power-restore by creating two per-user LaunchAgents (~/Library/LaunchAgents/…) that RunAtLoad + KeepAlive: one execs make web_run (or uvicorn directly) from this repo, the other execs cloudflared tunnel run vphone. Web VMs need a GUI login session (WindowServer), so use a LaunchAgent (per-user), not a system LaunchDaemon; enable macOS Automatic Login for a fully unattended restore.

Credits

Built on vphone-cli by Lakr233. This repo adds the web platform layer on top.

vphone-web (34306/vphone-web)

Searching Database…

374 ·GitHub
Vphone-web
Что это?Это селфхостед-веб-платформа для одновременного запуска нескольких виртуальных iPhone в браузере: с учётными записями, RBAC, живой трансляцией экрана, сенсорным вводом, установкой IPA, root-шеллом и файловым менеджером; построена поверх движка vphone-cli с использованием Virtualization.framework от Apple.
Это самостоятельное приложение или надстройка над чем-то ещё?Это веб-слой (сервер, который запускается через uvicorn/make) поверх движка vphone-cli, который и занимается виртуализацией iOS; данный репозиторий лишь добавляет многопользовательский браузерный интерфейс.
Как это запустить?Склонируйте репозиторий рекурсивно, чтобы подтянуть vendor/vphone-cli, соберите движок vphone-cli, создайте базовую ВМ с помощью автоматизированного конвейера vphone-cli (скачивание/восстановление/патч), затем настройте и запустите веб-сервер и войдите как админ, чтобы создавать и назначать ВМ.
Нужен определённый Mac или подойдёт любая машина?Нужен macOS 15+ (Sequoia) именно на Apple Silicon, поскольку проект опирается на приватную виртуализацию PV=3, плюс отключённые SIP и AMFI, Xcode command-line tools, Homebrew и Python 3.11+.
В комплекте есть готовый образ виртуального iPhone?Нет — базовая ВМ не входит в комплект из-за больших размеров файлов; придётся самому собрать vphone-cli и прогнать его конвейер (скачивание IPSW + cloudOS, восстановление, патч, первый запуск), чтобы создать свой базовый образ, прежде чем веб-интерфейс сможет клонировать из него ВМ.
Могут ли несколько человек пользоваться одной установкой?Да — здесь есть учётные записи с ролевым управлением доступом и назначением устройств отдельным пользователям: админ создаёт ВМ и назначает их конкретным пользователям, каждый из которых получает своё устройство.
Можно ли безопасно открыть доступ из интернета?Сервер по умолчанию слушает только 127.0.0.1; для удалённого доступа настраивается Cloudflare Tunnel со своим доменом, а живое видео автоматически переключается на MJPEG-over-WebSocket, поскольку Cloudflare не умеет проксировать WebRTC UDP.
Что такое vphone-cli и как он связан с этим репозиторием?vphone-cli (автор Lakr233) — это базовый движок, который выполняет саму виртуализацию iOS через приватные API Virtualization.framework от Apple; vphone-web лишь добавляет многопользовательский веб-фронтенд поверх него.
Как установить приложение на виртуальный iPhone?Перетащите файл .ipa или .tipa в зону установки в веб-интерфейсе ВМ; загрузки идут частями (chunked), чтобы обойти лимиты прокси на размер тела запроса.
Можно ли доверять тому, что этот код вообще работает?Автор называет это vibe-coded и говорит, что проверил функции перед публикацией, но предупреждает не присылать issue, сгенерированные ИИ, — так что относитесь к этому как к экспериментальному коду, поддерживаемому сообществом.
Влияет ли выбор накопителя на ВМ?Да — храните образы ВМ на внутреннем SSD, а не на медленном внешнем/USB-диске: первый запуск iOS выполняет тысячи мелких записей, которые на медленном накопителе непозволительно долгие.
What are similar projects?vphone-aio, macos, financial_intelligence_system_web, codflow, walle-web, macPad, scam-with-your-friends-web, windows
Which topics is it in?remote-desktop, jailbreak, file-manager, virtual-machine, webrtc, admin-dashboard, rbac, virtualization, cloudflare, apple, websocket, apple-silicon
Creator
34306
Size
0.2 MB
Stars
374
Updated
CommitSep 05
Age
1mo
Commits · 90 Days