App Sandbox

App Sandbox는 성능과 사용 편의성에 중점을 둔 Windows 및 macOS용 가상 머신 앱입니다.

Windows 기능:

Hyper-V 없이 Windows 11 Home 또는 Pro에서 동작
Windows 11 또는 Ubuntu 26.04 LTS VM 지원
제로 터치 설치
복사 및 붙여넣기
2채널 오디오
DirectX 12(Windows 전용), OpenGL, Vulkan, CUDA, OpenCL을 지원하는 반가상화(GPU-PV)를 통한 GPU 가속
GPU 하드웨어 비디오 디코더/인코더 지원
Hyper-V 소켓 프록시를 통한 SSH(네트워크 불필요)
스냅샷
고정 1080P60 디스플레이
호스트에서 클라이언트로의 단축키 지원
인터넷 유무에 관계없이 프로비저닝 및 부팅
중첩 가상화 지원 덕분에 VM 내부에서 Claude Cowork 및 Docker 실행 지원
헤드리스 모드: GPU 가속 VM을 프로그래밍 방식으로 생성하고 구동하기 위한 스크립트 가능한 로컬 HTTP/JSON API + 의존성 없는 Python SDK(asb.py)

Mac 기능:

macOS 또는 Windows 11 ARM VM 지원
Windows 11은 제로 터치 설치, macOS는 건너뛸 수 없는 온보딩 단계 3개
복사 및 붙여넣기
2채널 오디오
macOS: Metal을 지원하는 반가상화를 통한 GPU 가속, Windows: GPU 가속 없음
Windows 11 게스트는 고정 1080P60 디스플레이, macOS 게스트는 동적 디스플레이 크기 조정
인터넷 유무에 관계없이 프로비저닝 및 부팅
헤드리스 모드: Windows와 동일한 스크립트 가능한 로컬 HTTP/JSON API + Python SDK(asb.py)로 macOS 및 Windows 11 VM을 프로그래밍 방식으로 구동

요구 사항: x64 프로세서가 장착된 Windows 11 또는 macOS Tahoe(M 시리즈)

App Sandbox 소개

App Sandbox는 Windows 11, Ubuntu, macOS용 완전한 데스크톱 가상 머신을 생성하고 실행합니다. 무료 오픈소스(MIT)이며, 사전 빌드된 바이너리(Windows는 EV 서명, macOS는 Apple Developer 서명)로 릴리스 페이지에 배포됩니다. 사용 방법은 두 가지입니다: 그래픽 UI를 사용하거나, 의존성 없는 Python SDK(asb.py)를 갖춘 헤드리스 데몬을 통해 프로그래밍 방식으로 구동하는 것입니다. 어느 쪽이든 OS를 선택하고 설치 이미지를 지정하면 App Sandbox가 디스크를 프로비저닝하고, 무인 설치를 실행한 뒤 게스트를 부팅합니다. Windows 또는 Ubuntu ISO는 직접 제공해야 하며, macOS 게스트는 복원 이미지를 자동으로 다운로드합니다. Windows 11(x64) PC 또는 Apple Silicon Mac(노트북 포함)에서 실행됩니다.

Hyper-V 없이 Windows 11 Home에서 실행됩니다. Windows에서 App Sandbox는 Hyper-V 또는 Hyper-V 관리자를 사용하지 않습니다. 대신 Windows Host Compute System(HCS) 및 Host Compute Network(HCN) API를 통해 VM을 생성하고 실행하는데, 여기에는 Virtual Machine Platform 기능만 있으면 됩니다. Hyper-V는 Windows 11 Pro 및 Enterprise에서만 사용할 수 있지만 Virtual Machine Platform은 Windows 11 Home에서도 사용할 수 있으므로 Windows 11 Pro 라이선스는 필요하지 않습니다. Virtual Machine Platform은 WSL2가 사용하는 것과 동일한 Windows 기능입니다.

사용 용도:

GPU 가속(OpenGL, Vulkan, CUDA)을 갖춘 완전한 그래픽 OS를 제공하는 Windows 또는 Ubuntu 데스크톱 VM — 클린 설치 환경에서 자신의 소프트웨어를 빌드하고 테스트.
기본 OS 및 파일과 분리된 VM에서 프로그램 실행.
Windows 드라이버 개발 및 테스트: 내장된 테스트 모드가 게스트 내부에서 테스트 서명을 활성화하므로 호스트의 보안 부팅 및 부팅 구성은 변경되지 않은 상태로 유지됩니다.
컴퓨터 사용 AI 에이전트(예: Claude의 컴퓨터 사용 모델)를 자체 VM에서 실행. App Sandbox가 데스크톱과 VM을 제공하고, 에이전트 자체의 모델 루프는 게스트 내부에서 실행됩니다. 단일 노트북 또는 데스크톱에서 여러 에이전트를 각각 자체 VM에서 동시에 실행할 수 있습니다.
GUI 또는 헤드리스 API에서 GPU 가속(GPU-PV) VM 생성.
Python SDK로 코드에서 VM 수명 주기 스크립팅 — GPU 가속 VM 생성, 스냅샷, 브랜치, SSH 접속, 삭제.

헤드리스 API. appsandbox.exe --headless (또는 macOS에서는 sudo /Appsandbox.app/Contents/MacOS/AppSandbox --headless) 명령은 GUI와 동일한 코어를 호스팅하고 이를 127.0.0.1에서 Docker 스타일의 로컬 HTTP/JSON API로 노출하는 단일 소유자 데몬을 시작하며, 두 플랫폼에서 동일하게 동작합니다. 표준 라이브러리만 사용하는 Python SDK (asb.py)가 이를 래핑합니다: GPU 가속 VM 생성(GPU-PV는 gpuMode 생성 옵션), 자동 배포된 키를 통한 SSH 접속(Windows, Ubuntu 또는 macOS 게스트), 스냅샷 및 브랜치 생성, 라이브 디스플레이 열기, 여러 VM 동시 실행 — 동시 실행 수는 고정된 제한이 아니라 호스트 CPU, RAM 및 GPU 메모리에 의해 결정됩니다. 데몬은 단일 호스트 전용입니다 — 실행 중인 머신의 VM만 구동하며 클라우드 VM은 프로비저닝하지 않습니다. CI의 경우 자체 호스팅 러너에서 실행하세요. VM 프로비저닝은 전체 무인 설치를 실행하며, 스냅샷, 브랜치 및 템플릿(Windows 전용)은 재설치 대신 프로비저닝된 상태에서 새 VM을 시작합니다. VM은 삭제할 때까지 유지됩니다. 스냅샷은 VM을 중지한 상태에서 생성하는 디스크 상태 체크포인트이며, 브랜치는 여기에서 쓰기 가능한 디스크를 포크하여 별도의 작업을 실행합니다. 전체 API 참조 및 실행 가능한 예제는 tools/headless-api/에 있습니다.

작동 방식: 이 저장소는 Windows HCS/HCN API와 Apple의 Virtualization.framework를 사용하여 프로그래밍 방식으로 완전한 데스크톱 VM을 만드는 실제 사례를 제공하는 것도 목표로 합니다. Windows에서 App Sandbox는 Hyper-V 관리자를 거치지 않고, 수작업으로 작성한 HCS 머신 문서를 computecore.dll / computenetwork.dll(WSL2 및 Windows Sandbox의 기반이 되는 HCS/HCN 계층)에 제출합니다. GPU 가속은 GPU 반가상화(GPU-PV)를 사용하여 호스트에 설치된 GPU를 게스트와 공유합니다 — 전용 패스스루가 아닌 WSL2와 동일한 경로입니다(VFIO/IOMMU 없음, 보조 GPU 없음). Windows 게스트는 DirectX 12, OpenGL, Vulkan, CUDA, OpenCL을 지원하고, Ubuntu 게스트는 DirectX를 제외한 동일한 기능을, macOS 게스트는 Metal을 지원합니다. 커스텀 IddCx 간접 디스플레이 드라이버와 가상 오디오 장치가 화면과 사운드를 전달하며, 게스트↔호스트 클립보드, 오디오, 입력 및 SSH는 Hyper-V 소켓을 통해 실행됩니다. 게스트 디스크는 ext4, squashfs, qcow2, VHDX를 지원하는 저장소 내장 도구로 빌드됩니다. macOS에서 App Sandbox는 virtio-vsock 위에서 Apple의 Virtualization.framework(VZVirtualMachine, VZMacOSInstaller)를 사용합니다. Windows에서 Linux(Ubuntu) 게스트는 커스텀 DRM/KMS 커널 모듈(asb_drm), Microsoft의 WSL2 dxgkrnl, 커스텀 Mesa 빌드를 통해 GPU에 접근합니다. 앱은 HTML/JS UI(Windows의 WebView2, macOS의 WKWebView)를 사용하는 네이티브 C / Objective-C로 작성되었습니다.

팁:

[Windows] 단축키를 활성화하거나 VM 오디오를 음소거하려면: VM에 연결한 다음 연결 제목 표시줄을 마우스 오른쪽 버튼으로 클릭하세요

[Windows] VM에 원격으로 접속할 고성능 원격 데스크톱이 필요하신가요? Phaze가 잘 작동합니다

[Windows] App Sandbox Windows VM 내부에서 gpu-test.exe를 실행하면 GPU-PV 드라이버 설정이 작동하는지 확인할 수 있습니다. gpu-test.exe는 각각 다른 렌더링 엔진(D3D9, D3D10, D3D11, D3D12, OpenGL 및 Vulkan)을 사용하는 6개의 회전 큐브가 있는 상자를 표시합니다. 하나 이상이 실패하면 해당 렌더링 API에 대해 회전 큐브가 올바르게 표시되지 않습니다. gpu-test.zip. 참고: 렌더링 API가 성공하면 GPU-PV가 작동했음을 의미하지만, 일부 게임이나 앱은 GPU-PV 시스템을 올바르게 감지하지 못하도록 코딩되어 여전히 오류를 표시할 수 있습니다.

라이선스

MIT 라이선스가 적용되지 않고 자체 약관을 유지하는 타사 구성 요소를 번들로 포함합니다 — 가장 주목할 만한 것은 Microsoft WSL2 dxgkrnl GPU 드라이버(GPL-2.0)와 내장 XZ 디코더(0BSD)입니다. 전체 목록은 THIRD-PARTY-NOTICES.md를 참조하세요. AppSandbox 자체의 Linux DRM 커널 모듈(tools/linux/asb_drm/)은 MIT OR GPL-2.0 이중 라이선스이므로 커널의 GPL 전용 심볼을 해석할 수 있습니다.

감사의 말

직접 Easy-GPU-PV를 만든 경험 외에도, HCS를 이해하는 데 NanaBox가 매우 유용한 자료라는 것을 알게 되었습니다.

작성자

James Stringer — Easy-GPU-PV의 작성자.

appsandbox v0.1.5

카테고리