업데이트로 돌아가기
New releaseSep 11, 2026

appsandbox v0.1.5

개발 또는 컴퓨터 사용 모델을 위해 샌드박스 처리된 완전한 가상 머신을 손쉽게 생성하세요.

공유
App Sandbox

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(네트워크 불필요)
  • 스냅샷
  • 다양한 해상도 옵션 및 선택적 동적 해상도
  • 호스트에서 클라이언트로의 핫키 지원
  • 인터넷 연결 여부와 관계없이 프로비저닝 및 부팅
  • 중첩 가상화 지원 덕분에 VM 내부에서 Claude Cowork 및 Docker 실행 지원
  • 로컬 API, MCP 서버, Python SDK

Mac 기능:

  • macOS 또는 Windows 11 ARM VM 지원
  • 무인 설치
  • 복사 및 붙여넣기
  • 2채널 오디오
  • macOS: Metal을 지원하는 반가상화를 통한 GPU 가속, Windows: GPU 가속 없음
  • virtio-vsock을 통한 SSH(네트워크 불필요)
  • 동적 디스플레이 크기 조정(Windows에서 선택 사항)
  • 인터넷 연결 여부와 관계없이 프로비저닝 및 부팅
  • 로컬 API, MCP 서버, Python SDK

요구 사항: x64 프로세서가 탑재된 Windows 11 또는 macOS 27 이상(M 시리즈)

App Sandbox 소개

App Sandbox는 완전한 데스크톱 가상 머신(Windows 11, Ubuntu, macOS)을 생성하고 실행합니다. 무료 오픈 소스(MIT)이며, Releases 페이지에서 사전 빌드된 바이너리(Windows에서는 EV 서명, macOS에서는 Apple Developer 서명)로 배포됩니다. 그래픽 UI를 사용하거나 API, MCP 서버, Python SDK를 통해 자동화할 수 있습니다. 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 관리자를 사용하지 않으며, 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 기능입니다.

활용 용도:

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

API 및 MCP. App Sandbox는 Windows 및 macOS에서 GUI 또는 헤드리스 모드로 로컬 HTTP API, MCP 서버, Python SDK를 통한 자동화를 지원합니다. 설정 및 사용법은 API, MCP, Python SDK 문서를 참조하세요.

작동 방식: 이 저장소는 Windows HCS/HCN API와 Apple의 Virtualization.framework를 사용하여 전체 데스크톱 VM을 프로그래밍 방식으로 생성하는 실용적인 예제가 되는 것도 목표로 합니다. Windows에서 App Sandbox는 Hyper-V 관리자를 거치지 않고, WSL2와 Windows Sandbox의 기반이기도 한 HCS/HCN 계층인 computecore.dll / computenetwork.dll에 직접 작성한 HCS 머신 문서를 제출합니다. GPU 가속은 GPU 반가상화(GPU-PV)를 사용하여 호스트에 설치된 GPU를 게스트와 공유합니다. 이는 전용 패스스루(VFIO/IOMMU 없음, 두 번째 GPU 없음)가 아닌 WSL2와 동일한 경로입니다. 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로 작성되었습니다.

macOS에서의 Windows 게스트는 HVF 가속과 함께 QEMU 11.1.3을 사용하며, 공개된 asb-qemu 포크에서 빌드됩니다. 이 포크는 macOS 지원과 선택적 x-device-id 재정의를 포함한 네 가지 ivshmem 변경 사항을 유지합니다. QEMU, 그 라이브러리, 펌웨어는 macOS 앱 내부에 포함되어 제공됩니다. 고정된 소스와 재빌드 지침은 QEMU 빌드 노트를 참조하세요.

팁:

기본 사용자 이름은 user이고 기본 비밀번호는 test123입니다

기존 VM에 새로운 App Sandbox 기능을 적용하고 싶으신가요? 새로운 App Sandbox 버전을 다운로드하여 실행한 후, AI 에이전트에게 이 프롬프트를 제공하여 업그레이드를 도와주세요

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 라이선스에 따라 라이선스가 부여됩니다 — Copyright (c) 2026 James Stringer.

게스트 드라이버와 번들로 제공되는 타사 구성 요소는 asb-dxgkrnl, asb-mesa, QEMU를 포함하여 자체 라이선스를 유지합니다. AppSandbox의 Linux DRM 모듈(tools/linux/asb_drm/)은 MIT OR GPL-2.0 이중 라이선스입니다. 구성 요소 라이선스 및 소스 링크는 THIRD-PARTY-NOTICES.md를 참조하세요.

감사의 말

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

저자

James Stringer — Easy-GPU-PV의 저자.

카테고리