맥에서 가상 아이폰을 실행한다고? vphone-cli 소개

 

 

 

vphone-cli란?

 

혹시 실제 아이폰 없이 맥에서 "가상 아이폰"을 띄워볼 수 있다면 어떨까요?

`vphone-cli`는 애플의 Virtualization.framework를 활용해서 애플 실리콘 맥 위에 진짜로 iOS가 부팅되는 가상 아이폰을 만들어주는 오픈소스 CLI 도구입니다.

Lakr233이라는 개발자가 만들었고, 애플이 자사의 PCC(Private Cloud Compute) 보안 연구를 위해 공개했던 리서치 VM 인프라를 기반으로 동작합니다.

GitHub에서 벌써 9천 개가 넘는 스타를 받았을 정도로 개발자들 사이에서 화제가 되고 있는 프로젝트입니다.

 

쉽게 말하면, 별도의 아이폰 기기 없이도 맥 안에서 iOS를 통째로 돌려볼 수 있는 셈입니다.

앱 테스트, 커널/보안 연구, 자동화 테스트 등에 관심 있는 분들에게는 정말 매력적인 도구죠.

 

 

어떤 환경에서 쓸 수 있나요?

 

먼저 실행 환경부터 확인해야 합니다.

 

- 애플 실리콘(M시리즈) 맥이어야 합니다. 인텔 맥에서는 동작하지 않습니다.

- macOS 15(Sequoia) 이상이 필요합니다.

- Xcode와 iOS SDK가 있어야 게스트 데몬을 빌드할 수 있습니다.

- SIP(시스템 무결성 보호)와 AMFI(코드 서명 검증)를 일부 완화해줘야 합니다.

 

여기에 더해 `python@3.13`, `aria2`, `wget`, `openssl@3`, `keystone`, `libusb` 등 여러 개발 도구들을 `brew`로 미리 설치해줘야 합니다.

설정이 다소 까다로운 편이라, 개발 환경에 익숙하지 않다면 시간을 좀 넉넉히 잡고 진행하시는 게 좋습니다.

 

 

설치와 실행은 이렇게

 

Homebrew로 간단히 설치할 수 있습니다.

brew install zqxwce/tap/vphone-cli

 

 

직접 소스를 받아 빌드하고 싶다면 아래처럼 진행하면 됩니다.

 

git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git
./scripts/setup_tools.sh
./scripts/build.sh

 

 

설치가 끝나면 명령어 한 줄로 가상 아이폰 하나가 통째로 완성됩니다.

 

vphone-cli vm create myphone -V jb
vphone-cli vm launch myphone

 

 

이 한 줄 안에서 iOS 이미지 다운로드, 패치 적용, DFU 복원, 커스텀 펌웨어 설치, 첫 부팅까지 전 과정이 자동으로 진행됩니다.

물론 각 단계를 하나씩 손으로 실행해가며 원하는 시점에 멈추고 다시 시작하는 것도 가능합니다.

 

 

다섯 가지 펌웨어 변형(Variant)

 

`vphone-cli`의 재미있는 점은 보안 우회 수준을 선택할 수 있다는 것입니다. `--variant` 옵션으로 아래 다섯 가지 중 고를 수 있습니다.

 

- less : 패치를 최소화해서 iOS 자체 보안 기능을 그대로 유지합니다.

- regular : AMFI/SSV/Img4/TXM 같은 보안 검증을 우회합니다.

- dev : regular에 더해 TXM 엔타이틀먼트와 디버그 기능까지 우회합니다.

- jb : 완전한 탈옥(jailbreak) 버전으로, Sileo와 TrollStore가 첫 부팅 시 자동으로 설치됩니다.

- exp : jb를 포함하면서 가상머신 탐지를 우회하는 실험적인 연구용 패치까지 담고 있습니다.

 

패치 개수도 크게 차이가 나서, `less`는 4개 패치인 반면 `exp`는 무려 141개 패치가 적용됩니다.

용도에 맞게 필요한 만큼만 보안을 풀어서 쓸 수 있다는 게 장점입니다.

 

 

만들어진 가상 아이폰은 이렇게 접속

 

부팅이 끝나면 SSH나 VNC로 접속할 수 있습니다.

 

- 탈옥(jb/exp) 버전: `ssh -p 22222 mobile@<가상머신 IP>` (비밀번호 alpine)

- 일반(regular/dev) 버전: `ssh -p 22222 root@<가상머신 IP>`

- 화면을 직접 보고 싶다면: `vnc://<가상머신 IP>:5901`

 

VM 파일들은 모두 `~/.vphone/` 폴더 아래 저장됩니다. VM 목록, 복제, 내보내기/가져오기 같은 관리 명령어도 갖추고 있어서 여러 개의 가상 아이폰을 동시에 운영하기도 편합니다.

 

vphone-cli vm list
vphone-cli vm clone myphone myphone-2
vphone-cli vm export myphone --out myphone.tzst

 

 

 

이런 분들께 추천합니다

 

`vphone-cli`는 일반 사용자가 아이폰 대신 쓰는 도구라기보다는, iOS 내부 구조를 들여다보고 싶은 개발자와 보안 연구자를 위한 도구에 가깝습니다.

 

- 실제 기기 없이 여러 iOS 버전에서 앱을 테스트하고 싶은 개발자

- 커널이나 보안 패치 구조를 연구하고 싶은 리서처

- 반복적인 UI 테스트를 자동화하고 싶은 QA 엔지니어

 

특히 호스트 제어 소켓을 통해 스크린샷, 터치, 스와이프 같은 동작을 프로그래밍적으로 제어할 수 있어서, AI 기반 자동화 테스트와도 잘 맞물립니다. 실제로 이 소켓을 감싼 MCP 서버(vphone-mcp)까지 별도로 공개되어 있을 정도입니다.

 

 

마무리하며

 

`vphone-cli`는 애플이 공개한 리서치 인프라를 재해석해서, 누구나 애플 실리콘 맥 한 대로 가상의 아이폰을 부팅해볼 수 있게 만든 흥미로운 프로젝트입니다.

설정 과정이 간단하지는 않지만, iOS 내부를 깊이 들여다보고 싶은 개발자라면 한 번쯤 시도해볼 만한 도구라는 생각이 듭니다.

 

다만 SIP/AMFI 완화나 탈옥 관련 기능을 다루는 만큼, 연구·개발 목적으로만 신중하게 활용하시는 걸 권해드립니다.

 

 

#vphone-cli #가상아이폰 #애플실리콘 #Virtualization #iOS연구 #탈옥 #맥개발자 #오픈소스