jamesstringer90/appsandboxЛегко создавайте полноценные виртуальные машины, изолированные для разработки или моделей использования компьютера.
<img width="1028" height="446" alt="App Sandbox" src="https://assets.kitploit.com/production/public/readmes/9069/22f20578f6addd52e9c49edd40a96b935bc2fa169592852d8d5ac91d0c4b7160.png" /> # App Sandbox App Sandbox — это приложение виртуальной машины для Windows и macOS, ориентированное на производительность и простоту использования. Возможности Windows: - Работает на Windows 11 Home или Pro, без Hyper-V - Поддержка виртуальных машин Windows 11 или Ubuntu 26.04 LTS - Установка без участия пользователя - Копирование и вставка - Двухканальный звук - Ускорение GPU через паравиртуализацию (GPU-PV) с поддержкой DirectX 12 (только Windows), OpenGL, Vulkan, CUDA, OpenCL - Поддержка аппаратного видео-декодера/энкодера GPU - SSH через прокси Hyper-V socket (сеть не требуется) - Снимки состояния - Фиксированный дисплей 1080P60 - Поддержка горячих клавиш от хоста к клиенту - Подготовка и загрузка с интернетом / без интернета - Поддержка запуска Claude Cowork и Docker внутри виртуальной машины благодаря поддержке вложенной виртуализации - Headless-режим: скриптуемый локальный HTTP/JSON API + Python SDK без зависимостей (`asb.py`) для создания и управления GPU-ускоренными виртуальными машинами программно Возможности Mac: - Поддержка виртуальных машин macOS или Windows 11 ARM - Установка без участия пользователя для Windows 11, в macOS 3 обязательных шага первоначальной настройки - Копирование и вставка - Двухканальный звук - macOS: ускорение GPU через паравиртуализацию с поддержкой Metal, Windows: без ускорения GPU - SSH через virtio-vsock (сеть не требуется) - Фиксированный дисплей 1080P60 для гостей Windows 11, динамическое изменение размера дисплея для гостей macOS - Подготовка и загрузка с интернетом / без интернета - Headless-режим: тот же скриптуемый локальный HTTP/JSON API + Python SDK (`asb.py`), что и в Windows, для управления виртуальными машинами macOS и Windows 11 программно Требования: Windows 11 с процессором x64 или macOS Tahoe (серия M) ## О App Sandbox App Sandbox создаёт и запускает полноценные настольные виртуальные машины — Windows 11, Ubuntu и macOS. Это бесплатное программное обеспечение с открытым исходным кодом (MIT), распространяемое в виде готовых бинарных файлов (подписанных EV в Windows, подписанных Apple Developer в macOS) на странице [Releases](https://github.com/jamesstringer90/appsandbox/releases). Управление осуществляется двумя способами: через графический интерфейс или программно через headless-демон с Python SDK без зависимостей (`asb.py`). В любом случае вы выбираете ОС, указываете установочный образ, и App Sandbox подготавливает диск, выполняет автоматическую установку и загружает гостя. Вы предоставляете ISO Windows или Ubuntu; гости macOS загружают свой образ восстановления автоматически. Работает на ПК с Windows 11 (x64) или Mac с Apple Silicon, включая ноутбуки. **Работает на Windows 11 Home, без Hyper-V.** В Windows App Sandbox не использует Hyper-V или Hyper-V Manager; он создаёт и запускает виртуальные машины через API Windows Host Compute System (HCS) и Host Compute Network (HCN), для которых требуется только компонент *Virtual Machine Platform*. Hyper-V ограничен Windows 11 Pro и Enterprise, тогда как Virtual Machine Platform доступен в Windows 11 Home, поэтому лицензия Windows 11 Pro не требуется. Virtual Machine Platform — это тот же компонент Windows, который использует WSL2. **Для чего это можно использовать:** - Полноценная **настольная** виртуальная машина Windows или Ubuntu — полная графическая ОС с ускорением GPU (OpenGL, Vulkan, CUDA) — для сборки и тестирования собственного программного обеспечения на чистой установке. - Запуск программы в виртуальной машине, изолированной от вашей основной ОС и файлов. - Разработка и тестирование драйверов Windows: встроенный **Test Mode** включает тестовую подпись внутри гостя, поэтому Secure Boot и конфигурация загрузки хоста остаются неизменными. - Запуск AI-агента, использующего компьютер (например, модели computer use от Claude), в его собственной виртуальной машине. App Sandbox предоставляет рабочий стол и виртуальную машину; собственный цикл модели агента выполняется внутри гостя. Несколько агентов могут работать одновременно, каждый в своей виртуальной машине, на одном ноутбуке или настольном компьютере. - Создание GPU-ускоренных (**GPU-PV**) виртуальных машин из GUI или headless API. - Скриптинг жизненного цикла виртуальной машины из кода — создание, создание снимков, ветвление, SSH-подключение и удаление GPU-ускоренных виртуальных машин — с помощью Python SDK. **Headless API.** `appsandbox.exe --headless` (или `sudo /Appsandbox.app/Contents/MacOS/AppSandbox --headless` в macOS) запускает демон с единственным владельцем, который размещает то же ядро, что и GUI, и предоставляет его как локальный HTTP/JSON API в стиле Docker на `127.0.0.1`, идентичный на обеих платформах. Python SDK, использующий только стандартную библиотеку (`asb.py`), оборачивает его: создание GPU-ускоренных виртуальных машин (GPU-PV — это опция создания `gpuMode`), SSH- подключение через автоматически развёрнутый ключ (гости Windows, Ubuntu или macOS), создание снимков и ветвление, открытие живого дисплея и запуск нескольких одновременно — количество одновременно работающих ограничено CPU, RAM и памятью GPU хоста, а не фиксированным лимитом. Демон работает на одном хосте — он управляет виртуальными машинами на той машине, где запущен, и не предоставляет облачные виртуальные машины; для CI запускайте его на self-hosted runner. Подготовка виртуальной машины выполняет полную автоматическую установку; снимки, ветки и шаблоны (только Windows) запускают новую виртуальную машину из подготовленного состояния вместо переустановки. Виртуальная машина сохраняется до удаления. Снимок — это контрольная точка состояния диска, снятая при остановленной виртуальной машине, а ветка ответвляет от него записываемый диск для выполнения расходящихся действий. Полный справочник по API и запускаемые примеры находятся в [`tools/headless-api/`](https://github.com/jamesstringer90/appsandbox/blob/main/tools/headless-api). **Как это работает:** этот репозиторий также стремится быть рабочим примером создания полноценных настольных виртуальных машин программно с помощью API Windows HCS/HCN и Apple Virtualization.framework. В Windows App Sandbox отправляет вручную собранный документ HCS-машины в `computecore.dll` / `computenetwork.dll` — слой HCS/HCN, который также лежит в основе WSL2 и Windows Sandbox — вместо использования Hyper-V Manager. Ускорение GPU использует паравиртуализацию GPU (GPU-PV) для совместного использования установленного GPU хоста с гостем — тот же путь, что и в WSL2, а не выделенный проброс (без VFIO/IOMMU, без второго GPU). Гости Windows получают DirectX 12, OpenGL, Vulkan, CUDA и OpenCL; гости Ubuntu — то же самое, кроме DirectX; гости macOS — Metal. Пользовательский драйвер косвенного дисплея **IddCx** и виртуальное аудиоустройство передают экран и звук, а буфер обмена, аудио, ввод и SSH между гостем и хостом работают через **Hyper-V sockets**. Диски гостя создаются инструментом из репозитория с поддержкой ext4, squashfs, qcow2 и VHDX. В macOS App Sandbox использует Apple **Virtualization.framework** (`VZVirtualMachine`, `VZMacOSInstaller`) через **virtio-vsock**. В Windows гости Linux (Ubuntu) получают доступ к GPU через пользовательский модуль ядра DRM/KMS (`asb_drm`), `dxgkrnl` из Microsoft WSL2 и пользовательскую сборку Mesa. Приложения написаны на нативных C / Objective-C с UI на HTML/JS (WebView2 в Windows, WKWebView в macOS). # Советы: Имя пользователя по умолчанию — `user`, пароль по умолчанию — `test123` [Windows] Включение горячих клавиш или отключение звука виртуальной машины: подключитесь к виртуальной машине и щёлкните правой кнопкой мыши по заголовку окна подключения [Windows] Нужен высокопроизводительный удалённый рабочий стол для удалённого доступа к вашей виртуальной машине? [Phaze](https://phaze.app) хорошо работает [Windows] Вы можете проверить, работает ли настройка драйвера GPU-PV, запустив gpu-test.exe внутри вашей виртуальной машины Windows в App Sandbox; gpu-test.exe покажет окно с 6 вращающимися кубами, каждый из которых использует свой движок рендеринга (D3D9, D3D10, D3D11, D3D12, OpenGL и Vulkan). Если один или несколько не работают, они не будут корректно отображать вращающийся куб для этого API рендеринга. [gpu-test.zip](https://github.com/jamesstringer90/appsandbox/releases/download/v0.1.2/gpu-test.zip). Примечание: успешная работа API рендеринга означает, что GPU-PV работает, но иногда игры или приложения написаны таким образом, что они не обнаруживают систему GPU-PV корректно и всё равно показывают ошибку. ## Обмен исправлениями и функциями Спасибо за обмен исправлениями и идеями! Pull requests, включая изменения с помощью ИИ из вашего собственного форка, приветствуются как предложения. Они вряд ли будут формально рассмотрены или объединены, но вклад, помогающий сформировать изменение, будет отмечен. Подробности см. в [рекомендациях по участию](https://github.com/jamesstringer90/appsandbox/blob/main/CONTRIBUTING.md). ## Лицензия AppSandbox лицензирован под [MIT License](https://github.com/jamesstringer90/appsandbox/blob/main/LICENSE) — Copyright (c) 2026 James Stringer. Он включает сторонние компоненты, которые **не** покрываются лицензией MIT и сохраняют свои собственные условия — в частности, драйвер GPU Microsoft WSL2 `dxgkrnl` (GPL-2.0) и встроенный декодер XZ (0BSD). См. [THIRD-PARTY-NOTICES.md](https://github.com/jamesstringer90/appsandbox/blob/main/THIRD-PARTY-NOTICES.md) для полного списка. Собственный модуль ядра Linux DRM AppSandbox (`tools/linux/asb_drm/`) имеет двойную лицензию MIT OR GPL-2.0, чтобы он мог разрешать символы ядра, доступные только под GPL. ## Благодарности Помимо моего собственного опыта создания [Easy-GPU-PV](https://github.com/jamesstringerparsec/Easy-GPU-PV), я нашёл [NanaBox](https://github.com/M2Team/NanaBox) действительно полезным ресурсом для понимания HCS. ## Автор [James Stringer](https://www.linkedin.com/in/jamesstringerphotography/) — автор [Easy-GPU-PV](https://github.com/jamesstringerparsec/Easy-GPU-PV).
