TopGit
Đánh giá repo GitHub

vphone-cli: iPhone trên Apple Silicon qua Virtualization

Lakr233/vphone-cli
VTopGit review image for Lakr233/vphone-cli
Review by Topgit.dev for Lakr233/vphone-cli, with GitHub repository stats and README context.
Nhận định nhanh

vphone-cli boot một hệ thống iOS thực sự bên trong VM macOS trên Apple Silicon qua Virtualization.framework của Apple. Năm biến thể firmware từ 4 patch (`less`) đến 141 patch (`exp`) với các patch nghiên cứu chống phát hiện VM; biến thể `jb` tự cài Sileo và TrollStore khi khởi động. Đáng để setup nếu bạn cần iOS bare-metal trên Mac. Bỏ qua nếu chỉ cần test UI app và Simulator chính thức đã đủ.

Sao
★ 16.7k
Fork
⑂ 2.0k
Người đóng góp
👥 38
Ngôn ngữ
Swift
Giấy phép
MIT
Chủ đề
Mobile
Cập nhật
Nov 2026
Trang chủ
—
GitHub

Boot iPhone OS thực trong VM trên Apple Silicon

vphone-cli là CLI Swift khởi tạo và chạy máy ảo iOS thực sự trên Apple Silicon qua Virtualization.framework. Nó tự động hoá toàn bộ quy trình: tải IPSW, patch boot chain, khôi phục DFU, và cài CFW. Một lệnh duy nhất tạo iPhone ảo có thể dùng được.

Tính năng chính của vphone-cli

  • ✓Tạo VM bằng một lệnh: `vphone-cli vm create myphone -V jb` chạy toàn bộ pipeline từ tải IPSW đến khởi động đầu tiên
  • ✓Năm biến thể firmware: `less` (4 patch), `regular` (42 patch), `dev` (53 patch), `jb` (113 patch), và `exp` (141 patch với nghiên cứu chống phát hiện VM)
  • ✓Dùng CLI hoặc chạy từng bước thủ công: `fw prepare`, `fw patch`, `restore`, `cfw install`
  • ✓SSH và VNC: VM jailbreak mở cổng 22222 với `mobile`/`alpine`, VM thường với `root`/`alpine`; VNC trên cổng 5901
  • ✓Socket điều khiển host để tự động hoá: hỗ trợ chạm, vuốt, phím, clipboard và chụp màn hình qua `~/.vphone.sock`
  • ✓Python runtime được cài tự động: `~/.vphone/venv/` tạo khi chạy lần đầu với mọi dependency
  • ✓Tuỳ chỉnh vị trí lưu trữ: `$VPHONE_ROOT`, `$VPHONE_LIBRARY_ROOT`, `$VPHONE_VENV_DIR` thay đổi nơi lưu VM, cache và venv
  • ✓MCP server sẵn có: vphone-mcp bao gói socket điều khiển cho E2E testing dựa trên AI
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Cài vphone-cli và dependency

Cài vphone-cli qua Homebrew: `brew install zqxwce/tap/vphone-cli`. Tap formula xử lý binary. Sau khi cài, vẫn cần relax bảo mật host — xem phần SIP/AMFI Relaxation. Lần chạy đầu, vphone-cli tự tạo Python venv trong `~/.vphone/venv/` với mọi dependency cần thiết.

Tạo và khởi chạy iPhone ảo đầu tiên

Tạo và khởi chạy iPhone ảo bằng một lệnh: `vphone-cli vm create myphone -V jb`. Lệnh này tải IPSW, patch boot chain, khôi phục DFU, cài CFW và boot vào iOS. Sau khi tạo, chạy `vphone-cli vm launch myphone` để mở VM. Kết nối qua SSH: `ssh -p 22222 mobile@<vm-ip>` (mật khẩu `alpine`) cho VM jailbreak, hoặc `ssh -p 22222 root@<vm-ip>` cho VM thường. VNC tại `vnc://<vm-ip>:5901`.

Điểm mạnh

  • ✓Một lệnh duy nhất (`vphone-cli vm create`) tự động hóa toàn bộ pipeline: tải IPSWs, patch boot chain, chạy DFU restore, cài CFW, và boot VM. Không cần thao tác thủ công sau đó.
  • ✓Năm biến thể firmware cho phép chọn mức độ patch chính xác theo nhu cầu. Từ `less` (giữ nguyên iOS mitigations) đến `exp` (141 patches với nghiên cứu chống phát hiện VM).
  • ✓Quản lý vòng đời VM được thiết kế bài bản. APFS clone nhanh để tạo bản sao có device identity mới, export zstd bỏ qua restore/staging files, và các thao tác rename/delete/list đều script được với `--json`.
  • ✓Socket điều khiển host expose screenshot, touch, swipe, key press, và clipboard. README đặc biệt nhấn mạnh AI-driven E2E testing là trường hợp sử dụng, với MCP server riêng (vphone-mcp) bao gói nó.
  • ✓Dữ liệu nằm trong `~/.vphone/` tách biệt với app bundle. Cache directory cho IPSWs, APFS seal-volume artifacts, và `.deb` packages đều có thể tái sử dụng qua nhiều VM.

Yêu cầu phần cứng và giới hạn đã biết

  • △Apple Silicon và macOS 15+ (Sequoia) là yêu cầu cứng. Intel Mac và macOS cũ không hỗ trợ, và công cụ từ chối boot nếu phát hiện host đang là VM (nested PV=3 không hỗ trợ).
  • △SIP và AMFI phải được relax trước khi chạy, đòi hỏi disable System Integrity Protection hoàn toàn và đặt boot-arg nvram, hoặc biên dịch binary allowlist tuỳ chỉnh. Không phải thao tác một lần, và cả hai đều có implications bảo mật.
  • △Bug trong `ldid-procursus` bản Homebrew (đến `2.1.5-procursus7`) gây memory growth không giới hạn và hang khi re-sign một số Apple system binary có giá trị integer bằng `0` trong entitlements plist. README ghi workaround là rebuild từ `--HEAD`.
  • △Base image iOS 18 gây crash `EXC_GUARD` / `GUARD_TYPE_MACH_PORT` khi launch trừ khi ép flag `exc-guard` (`--force-exc-guard`) khi patch và re-restore. Bước phụ này không cần với iOS version cũ hơn.
  • △Chọn vùng Nhật Bản hoặc EU trong iOS setup khiến system app từ chối cài đặt do kiểm tra regulatory mà VM không thể đáp ứng. README khuyên chọn United States.

So sánh vphone-cli với các lựa chọn khác

Apple iOS Simulator — tích hợp Xcode, chạy iOS app không cần SIP drama, nhưng không có root access, không nghiên cứu kernel được, và không chạy jailbreak codeCorellium — thiết bị ARM ảo host trên cloud có full root, nhưng là SaaS trả phí, không kiểm soát local, và cần upload workload lên hạ tầng bên thứ baUTM — hypervisor PC mã nguồn mở chạy ARM64 Linux, nhưng thiếu tích hợp Virtualization.framework cho iOS và không có patch boot-chain tự độngcheckra1n + thiết bị vật lý — iOS hardware thật với full access, nhưng cần hardware tương thích, tethered, và hoàn toàn không chạy trên Apple Silicon Mac

Câu hỏi thường gặp và cách xử lý lỗi

Phần cứng nào cần để chạy vphone-cli?

Cần Mac Apple Silicon chạy macOS 15 Sequoia trở lên, đã cài Xcode và iOS SDK. vphone-cli dùng Virtualization.framework của Apple — chỉ chạy trên phần cứng Apple Silicon thật. Không hỗ trợ Intel, không hỗ trợ nested VM.

vphone-cli có chạy được trên Intel Mac hoặc trong VM không?

Không. Virtualization.framework không hỗ trợ PV=3 guest trong nested virtual machine, và framework không tồn tại trên Intel Mac. Cần Apple Silicon bare-metal.

vphone-cli khác gì so với iOS Simulator chính thức?

Simulator chạy bản biên dịch lại của thư viện iOS trên kiến trúc gốc Mac. Nhanh, tích hợp Xcode, nhưng không phải kernel thật, không có root access, và không chạy được jailbreak code. vphone-cli boot hệ thống iOS thực qua Virtualization.framework.

Biến thể jailbreak khác gì so với biến thể thường?

Biến thể `regular` áp 42 boot-chain patches và 10 CFW phases. Biến thể `jb` tăng lên 113 patches và 14 phases, thêm jailbreak đầy đủ tự cài Sileo và TrollStore khi boot lần đầu. Biến thể `exp` mở rộng hơn nữa với 141 patches và 18 phases bao gồm anti-VM-detection research patches.

Làm sao sửa lỗi killed trên macOS khi chạy vphone-cli?

Lỗi `zsh: killed` nghĩa là AMFI hoặc debug restrictions đang chặn binary. Đặt boot-arg `amfi_get_out_of_my_way=1` sau khi disable SIP bằng `csrutil disable` trong Recovery, hoặc giữ SIP bật và chạy `vphone-amfidont` để cho phép binary.

vphone-cli có cần disable SIP không?

Chỉ cần enable `csrutil allow-research-guests enable` trong Recovery là đủ cho cơ chế cơ bản. Disable SIP hoàn toàn chỉ cần nếu muốn dùng boot-arg `amfi_get_out_of_my_way=1` cho chế độ permissive nhất. Giữ SIP bật kết hợp debug-relaxed mode và `vphone-amfidont` là lựa chọn thay thế.

Trường hợp sử dụng phù hợp nhất

  • •Nghiên cứu nội bộ kernel iOS, AMFI và SSV mà không cần thiết bị vật lý
  • •Phát triển và lặp jailbreak tweak local trước khi test trên thiết bị thật
  • •Tự động hoá UI testing iOS qua socket điều khiển host và chụp màn hình
  • •Xây dựng workflow CFW cần DFU restore và thu thập SHSH blob
  • •Chạy iOS trong môi trường có thể tái tạo và huỷ bỏ, gắn với phiên bản iOS cụ thể
  • •Test hành vi iOS ở cấp độ hệ thống, không chỉ cấp ứng dụng, trên kernel iOS thực

Ai nên thử — và ai nên bỏ qua

Thử vphone-cli nếu bạn là nhà nghiên cứu bảo mật iOS, lập trình viên jailbreak tweak, hoặc kỹ sư tự động hoá cần kernel và API cấp hệ thống iOS thực sự mà không có thiết bị vật lý. Bỏ qua nếu chỉ cần test UI app — Simulator chính thức nhanh và đơn giản hơn. Bỏ qua nếu không có Apple Silicon hoặc không muốn xử lý setup SIP/AMFI. Nhà phát triển cần môi trường iOS có thể tái tạo trong CI/CD sẽ thấy giá trị nhất từ pipeline được script hóa.

Repo liên quan

Nguồn & ghi công

GitHub repository Lakr233/vphone-cli (MIT License)

Dữ liệu GitHub · đồng bộ lần cuối 31 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

vphone-cli có đáng để bạn bỏ thời gian?

ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về vphone-cli.

GitHub