jamesstringer90/appsandbox개발 또는 컴퓨터 사용 모델을 위해 샌드박스 처리된 완전한 가상 머신을 손쉽게 생성하세요.
App Sandbox는 성능과 사용 편의성에 중점을 둔 Windows 및 macOS용 가상 머신 앱입니다.
Windows 기능:
asb.py)Mac 기능:
asb.py)로 macOS 및 Windows 11 VM을 프로그래밍 방식으로 구동요구 사항: x64 프로세서가 있는 Windows 11 또는 macOS Tahoe (M 시리즈)
App Sandbox는 완전한 데스크톱 가상 머신 — Windows 11, Ubuntu, macOS — 을 생성하고 실행합니다. 무료 오픈 소스(MIT)이며, Releases 페이지에서 사전 빌드된 바이너리(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 Manager를 사용하지 않고, Virtual Machine Platform 기능만 필요한 Windows Host Compute System(HCS) 및 Host Compute Network(HCN) API를 통해 VM을 생성하고 실행합니다. Hyper-V는 Windows 11 Pro 및 Enterprise로 제한되지만 Virtual Machine Platform은 Windows 11 Home에서 사용할 수 있으므로 Windows 11 Pro 라이선스가 필요하지 않습니다. Virtual Machine Platform은 WSL2가 사용하는 것과 동일한 Windows 기능입니다.
활용 용도:
헤드리스 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 게스트), 스냅샷 및 브랜치, 라이브 디스플레이 열기, 여러 개 동시 실행 — 동시 실행 개수는 고정 제한이 아니라 호스트 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 Manager를 거치지 않고, WSL2와 Windows Sandbox의 기반이기도 한 HCS/HCN 계층인 computecore.dll / computenetwork.dll에 직접 작성한 HCS 머신 문서를 제출합니다. 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에 접근합니다. 앱은 네이티브 C / Objective-C이며 HTML/JS UI(Windows에서는 WebView2, macOS에서는 WKWebView)를 사용합니다.
기본 사용자 이름은 user이고 기본 비밀번호는 test123입니다
[Windows] 핫키를 활성화하거나 VM 오디오를 음소거하려면: VM에 연결한 후 연결 제목 표시줄을 마우스 오른쪽 버튼으로 클릭하세요
[Windows] VM에 원격으로 접속하기 위한 고성능 원격 데스크톱이 필요하신가요? Phaze가 잘 작동합니다
[Windows] GPU-PV 드라이버 설정이 작동하는지 확인하려면 App Sandbox Windows VM 내부에서 gpu-test.exe를 실행하세요. gpu-test.exe는 각각 다른 렌더링 엔진(D3D9, D3D10, D3D11, D3D12, OpenGL, Vulkan)을 사용하는 6개의 회전하는 큐브가 있는 상자를 표시합니다. 하나 이상이 실패하면 해당 렌더링 API에 대해 회전하는 큐브가 올바르게 표시되지 않습니다. gpu-test.zip. 참고: 렌더링 API가 성공한다는 것은 GPU-PV가 작동했다는 의미이지만, 때때로 게임이나 앱이 GPU-PV 시스템을 올바르게 감지하지 못하도록 코딩되어 여전히 오류를 표시할 수 있습니다.
수정 사항과 아이디어를 공유해 주셔서 감사합니다! 자체 포크에서의 AI 지원 변경을 포함한 풀 리퀘스트를 제안으로 환영합니다. 공식적으로 검토되거나 병합될 가능성은 낮지만, 변경에 기여한 기여자는 크레딧을 받습니다. 자세한 내용은 기여 가이드라인을 참조하세요.
AppSandbox는 MIT License에 따라 라이선스가 부여됩니다 — Copyright (c) 2026 James Stringer.
MIT 라이선스에 포함되지 않고 자체 조건을 유지하는 타사 구성 요소를 번들로 포함합니다 — 특히 Microsoft WSL2 dxgkrnl GPU 드라이버(GPL-2.0)와 내장 XZ 디코더(0BSD)가 그렇습니다. 전체 목록은 THIRD-PARTY-NOTICES.md를 참조하세요. AppSandbox 자체의 Linux DRM 커널 모듈(tools/linux/asb_drm/)은 커널의 GPL 전용 심볼을 해결할 수 있도록 MIT OR GPL-2.0 이중 라이선스입니다.
Easy-GPU-PV를 구축한 제 경험 외에도, HCS를 이해하는 데 NanaBox가 정말 유용한 자료였습니다.
James Stringer — Easy-GPU-PV의 작성자.