개요
vphone-cli는 Lakr233이 만든 MIT 오픈소스로, Apple Silicon Mac에서 가상 iPhone(iOS)을 실행한다. Apple의 Virtualization.framework와 PCC(Private Cloud Compute) 연구용 가상 머신 경로를 이용하며, 보안 연구·리버스 엔지니어링·디버깅이 목적이다. 2026-10-04 기준 별 14.8k, 최신 릴리스 2.5.1. 2.x는 1.x에서 만든 VM을 부팅하지 못하므로 다시 만들어야 한다.
무엇을 할 수 있나
- 그래픽 창: 가상 iPhone 화면 조작, 앱·파일 탐색, 스크린샷·화면 녹화
- 커스텀 펌웨어: 시스템 패치가 미리 적용돼 패키지 환경(탈옥 부트스트랩)을 설치할 수 있다
- 백업·복제: VM 내보내기(
.tzst)·가져오기·복제 - 자동화 API:
--api-listen으로 로컬 HTTP·WebSocket 인터페이스를 연다. 실행마다 새 토큰이 생기고, 토큰 없는 요청과 웹 페이지발 요청은 거부한다 - 의존성 없음: 실행에 Xcode·Python·Homebrew가 필요 없다
준비와 설치
| 항목 | 내용 |
|---|---|
| 호스트 | macOS 15 이상 물리 Apple Silicon Mac (macOS VM 안에서는 불가) |
| 디스크 | VM당 기본 64GB 가상 디스크 + 펌웨어·임시 파일 |
| 네트워크 | 복원 시 서명 티켓을 온라인으로 받음 |
| 보안 설정 | 복구 모드에서 csrutil enable --without debug, csrutil allow-research-guests enable (SIP는 켠 채 디버깅 제한만 완화) |
설치는 공증된 vphone-launchpad 앱 → Host Setup → Core Bundle(VPhone.bundle) 설치 → New Machine 순서다. Launchpad가 펌웨어 다운로드·패치·복원·첫 부팅까지 처리한다. 코딩 에이전트에게 맡기는 프롬프트도 README에 있다. 에이전트가 저장소의 vphone-guest-control 스킬을 읽고 설치하되, SIP·boot-args 변경과 VM 생성은 사람 확인 전까지 멈추게 하는 방식이다.
패키지 환경과 CLI
- 메뉴 **Apps > Install Bootstrap…**에서 roothide 레이아웃을 고르면 Irisin이 설치된다(rootless는 비권장). 첫 설치 때
apt·bash·uikittools·launchctl·openssh-server를 한 번에 Bootstrap Install해야 한다. 의존성 선언이 순환·부정확해서 하나씩 설치하면 실패할 수 있다. - 망가지면 고치려 하지 말고 Uninstall Bootstrap 후 처음부터 다시 설치하라는 것이 공식 안내다.
vphone-cli vm list|info|launch|stop|clone|export|import로 VM을 관리하고, VM은~/.vphone/에 저장된다.- 구성:
vphone-launchpad(설치 앱),vphone-cli(펌웨어·복원·VM 관리),vphone-vm(실행·창),vphoned(게스트 안 제어 서비스).
의미와 한계
iOS를 Mac 위 VM으로 띄워 자동화 API로 제어할 수 있으니, 모바일 앱 분석이나 에이전트 기반 iOS 조작 실험의 기반이 된다. serve-sim이 Xcode 시뮬레이터를 에이전트에 여는 쪽이라면 vphone-cli는 실제 iOS 펌웨어를 패치해 돌리는 연구용 경로다. 시뮬레이터·실기기를 MCP 도구로 조작하는 쪽은 2026-10-02-github-mobile-next-mobile-mcp가 있다. 리버스 엔지니어링 맥락은 2026-04-19-android-reverse-engineering-skill과 함께 볼 만하다.
- 한국어 README만 근거로 했고 직접 설치해 보지는 않았다.
- 호스트 보안 설정 완화가 필요하고 펌웨어 패치 기반이라, 업무용 Mac에서는 정책 검토가 먼저다.
X 반응
@denziideng(중국어, 2026-10-09)은 보안 연구보다 앱 테스트 자동화 쪽으로 소개했다. 실기기 없이 “앱 열기 → 로그인 → 입력 → 결과 확인” 흐름을 자동화 인터페이스의 탭·스와이프·스크린샷으로 돌려 반복 수동 테스트를 줄이고, 프로그램이나 AI가 가상 iPhone을 조작하게 할 수 있다는 것이다.