1VMTool은 단일 애플리케이션입니다. 함께 설치할 런타임, 다운로드할 하이퍼바이저, 패키지 관리자가 없습니다.

요구 사항


Mac	Apple silicon. Intel 빌드는 없습니다.
macOS	26 이상.
Disk	생성할 머신에 충분한 용량. 디스크는 sparse이므로 미리 할당하지 않고 게스트가 쓸 때마다 커집니다.
Everything else	없음. QEMU, Homebrew, Docker, 커널 확장 불필요.

Apple silicon 요구 사항은 패키징 선택이 아닙니다. 두 엔진 모두 CPU에서 게스트 코드를 네이티브 실행하므로 게스트는 ARM64여야 합니다. 여기서는 외부 명령어 집합을 에뮬레이션하지 않으므로 어떤 Mac에서도 x86 게스트는 지원되지 않습니다.

설치

1VM.app을 /Applications로 끌어다 놓고 엽니다. 첫 실행 시 macOS가 서명과 공증을 확인합니다. 이후에는 네트워크 없이도 바로 열립니다.

명령줄

1vm은 앱 번들 안에 포함되어 두 프런트엔드가 어긋나지 않습니다. PATH에 링크하세요:

ln -sf /Applications/1VM.app/Contents/MacOS/1vm /usr/local/bin/1vm
1vm --version

앱이 할 수 있는 모든 것을 1vm도 할 수 있습니다 — 1vm 명령줄 참조.

서명이 중요한 이유

앱은 com.apple.security.virtualization 권한이 없으면 모든 머신이 시작에 실패합니다. Virtualization.framework를 사용하는 프로세스에 대한 Apple 요구 사항이며, 퍼스트파티 엔진에는 추가로 hypervisor 권한이 필요합니다.

실질적 결과: 바이너리를 앱 번들 밖으로 옮기거나 서명을 제거하지 마세요. 소스에서 빌드하면 패키징 스크립트가 릴리스 단계가 아니라 빌드의 일부로 서명하므로, 로컬 빌드가 이유 없이 깨지지 않습니다.

머신 저장 위치

기본적으로 머신은 홈 디렉터리의 폴더 라이브러리에 있습니다. ONEVM_HOME을 설정해 다른 곳에 둘 수 있습니다 — 예: 외장 SSD:

export ONEVM_HOME=/Volumes/Fast/vms

각 머신은 자체 포함 폴더입니다. VM 번들 참조.

호스트 확인

1vm doctor는 호스트, 권한, 라이브러리, 두 엔진을 보고합니다. 1vm capabilities는 이 특정 Mac이 할 수 있는 것과 없는 것을 출력합니다 — 중첩 가상화 등은 가정이 아니라 기능 감지됩니다.

1vm doctor
1vm capabilities