Как разместить Dormice для sandbox агентов на VPS
Установите Dormice на свой Linux VPS, запускайте код через E2B-совместимый API, проверьте изоляцию sandbox и рассчитайте требования к хосту.
Что такое Dormice и чем он не является
Dormice — это самостоятельно размещаемая среда для запуска агентов: один daemon на принадлежащем вам Linux VPS. Код агента обращается к daemon по HTTP, чтобы выполнять непроверенный код внутри изолированного контейнера. Программа запрашивает sandbox по имени, получает тот же sandbox независимо от его состояния, выполняет в нём команду и читает результат. Sandbox — это программный ресурс, а не машина, к которой вы подключаетесь.
Это не то же самое, что предоставить агенту целый компьютер. Временная VM для агента, который пишет код — это система, к которой вы подключаетесь по SSH, позволяете агенту изменить её, а затем удаляете. Dormice находится уровнем ниже: это API выполнения, к которому обращается программа, когда у неё уже есть код и нужно безопасное место для его запуска. Используйте временную VM, если единицей работы является целая машина. Используйте Dormice, если единицей работы является один вызов exec и вам нужно выполнять сто таких вызовов в день без создания ста VM.
Проект заявляет о совместимости с E2B. E2B — это размещаемый сервис sandbox, клиентскую библиотеку которого уже импортируют многие платформы для агентов. Dormice предоставляет тот же протокол по собственным префиксам URL. Поэтому приложение, написанное с использованием официального пакета e2b, продолжит работать после перенаправления запросов на ваш сервер. Код приложения менять не нужно. Изменяются два URL и один префикс API key.
Что на практике означает «SQLite для песочниц агентов»
SQLite — это база данных, которую вы встраиваете в приложение, а не сервис, которым нужно управлять. Dormice напрямую заимствует это сравнение. Один демон на машину, один файл SQLite для журнала, один TCP-порт и небольшой шлюз рядом, который обслуживает веб-консоль. Никакого Kubernetes, никакого внешнего сервера баз данных. Демон устанавливает монопольную блокировку на свой журнал, поэтому второй демон на той же машине откажется запускаться, вместо того чтобы незаметно разделять состояние. Каждая песочница живет на той машине, где была создана. В README теперь парк серверов описывается как один шлюз плюс машины в его частной сети, но там по-прежнему указано: если вам нужны песочницы, перемещающиеся между машинами, или парк серверов в разных регионах, выберите другое решение, и к этому совету стоит прислушаться.
Вторая часть идеи касается стоимости. За хостинговую песочницу вы платите каждую секунду её существования, поэтому такие песочницы по своей сути являются одноразовыми. Dormice работает на оборудовании, за которое вы уже платите, поэтому его песочницы постоянны и становятся дешевле, чем дольше они остаются без дела. Песочница переходит в режим ожидания постепенно: активная, затем замороженная, затем остановленная, затем архивированная. Любой запрос на получение возвращает её обратно с любого уровня, которого она достигла.
Замораживание — это тот аспект, который важно понять, поскольку именно он делает хранение песочницы каждого агента доступным в течение неограниченного времени. Ниже приведены опубликованные показатели проекта, измеренные на его собственном оборудовании, а не на вашем.
Данные, на которых построен график
[
{
"label": "Active, holding 1 GiB",
"resident_memory_mib": 1024,
"wake_ms": 0
},
{
"label": "Frozen",
"resident_memory_mib": 5,
"wake_ms": 50
}
]Простаивающая песочница, занимающая 1024 МиБ оперативной памяти, после заморозки сокращает объем резидентной памяти до 5 МиБ и возвращается в работу примерно за 50 мс. Процессы приостанавливаются и возобновляются на месте, поэтому долгоживущий агент сохраняет состояние своей оболочки и незавершенную работу после заморозки. Воспроизведите это на своем хосте, прежде чем планировать на основе этих данных емкость системы.
Что необходимо хосту перед установкой
Хост должен работать под управлением Ubuntu или Debian на архитектуре x86_64, а установщику требуются права root. Демон сохраняет права root во время работы, так как он выполняет loop-монтирование и запись в cgroups.
Песочницы запускаются в Docker с использованием gVisor (среда выполнения контейнеров, которая помещает ядро пользовательского пространства между контейнером и ядром хоста), что обеспечивает среду runsc, используемую каждой песочницей. Демон работает на Node 22 или новее. Если в вашей системе уже установлена Node 22 или более новая версия, установщик использует её; только в случае отсутствия или использования устаревшей версии установщик загрузит собственную зафиксированную копию, проверит её контрольную сумму и распакует в /opt.
Раздел подкачки (swap) должен существовать, а значение vm.swappiness должно быть равно 100. Это не рекомендация по настройке, а функциональное требование. Механизм заморозки работает путем вытеснения памяти простаивающей песочницы в swap; gVisor хранит память песочницы как разделяемую память, а ядро не будет вытеснять разделяемую память при стандартном значении swappiness. Проект показал, что при стандартном значении освобождается 0 байт, а при значении 100 — 99,5 процента. Проверьте значение, которое реально использует ядро, так как некоторые облачные образы содержат vm.swappiness = 0 в файле, который вы вряд ли догадаетесь прочитать.
sysctl vm.swappiness
swapon --showКоманда sysctl vm.swappiness должна выводить vm.swappiness = 100, а swapon --show должна отображать файл подкачки. Если swappiness выводит 0, любая заморозка будет фиктивной операцией, из-за чего вы будете оплачивать полный объем памяти для каждой простаивающей песочницы.
Установка Dormice на Ubuntu
Документированный способ установки представляет собой конвейер в bash:
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh | bashЗагрузите его и изучите перед запуском. Этот скрипт выполняется от имени root и изменяет конфигурацию хоста: он устанавливает Docker, если тот отсутствует, загружает gVisor и Caddy с проверкой контрольных сумм, создает файл подкачки (swapfile), если на хосте его нет, записывает systemd-юниты для демона, шлюза и реестра образов, а также добавляет правила межсетевого экрана.
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh -o dormice-install.sh
less dormice-install.sh
sudo bash dormice-install.sh --swap-gb 8--swap-gb задает размер файла подкачки; по умолчанию используется 16, что является значительным объемом дискового пространства для небольшого VPS. --mirror cn переключает загрузку на зеркала, доступные из материкового Китая. Повторный запуск установщика обновляет код и исправляет отклонения в конфигурации, при этом API-токен никогда не меняется.
Код размещается в /opt/dormice, конфигурация — в /etc/dormice/env (плюс /etc/dormice/gateway.env для шлюза), данные песочницы — в /var/lib/dormice, а команды dormice и dor находятся в /usr/local/bin. Установщик генерирует API-токен во время установки и записывает его в /etc/dormice/env с правами доступа 600; это же значение записывается в файл шлюза.
Релизов с тегами для установки не существует. По состоянию на 12 октября 2026 года в репозитории нет git-тегов и GitHub-релизов, поэтому установщик клонирует main, и вы получаете версию, актуальную на текущее утро. Фиксация версии (pinning) в данном случае означает запись хеша коммита, который вы установили.
git -C /opt/dormice rev-parse HEADСохраните этот хеш в своих заметках по развертыванию, так как он точно указывает, какой код вы используете. Сам по себе он не является способом отката: новые процессы применяют миграции базы данных при запуске, а документация по обновлению гласит, что миграция не отменяется повторным запуском старого установщика. Перед перезапуском чего-либо установщик сохраняет снимки обеих баз данных в /var/lib/dormice/backups/ и хранит три последних из них. Эти снимки — документированный способ восстановления после неудачного обновления, поэтому копируйте самый свежий из них с сервера перед следующим обновлением.
Установщик завершает работу запуском dor doctor — проверки хоста в режиме только для чтения, которая запускает реальные контейнеры gVisor, чтобы подтвердить работоспособность среды выполнения, а не полагаться на список пакетов. Запускайте эту команду повторно, если демон ведет себя некорректно.
sudo dor doctor
systemctl is-active dormicesystemctl is-active dormice должен вывести active. Если выводится failed, то в journalctl -u dormice -n 50 указана причина; сбой при запуске обычно связан с файлом подкачки или предварительными требованиями gVisor, а не с самим демоном.
Установщик также размещает Caddy на сервере, поэтому проверьте, какие порты прослушиваются, прежде чем считать настройку межсетевого экрана завершенной.
sudo ss -lntpДемон всегда привязывается к 127.0.0.1, и по замыслу разработчиков настройки для изменения этого адреса нет. Изменить можно только порт: DORMICE_PORT по умолчанию использует 3676. Шлюз рядом с ним следует тому же правилу на 127.0.0.1:3677, используя DORMICE_GATEWAY_PORT для порта, и также намеренно не имеет настройки хоста. Доступ к ним с вашего ноутбука — это осознанное действие, и самый простой способ — SSH-туннель, перенаправляющий оба порта.
ssh -L 3676:127.0.0.1:3676 -L 3677:127.0.0.1:3677 root@your-serverПосле открытия туннеля http://127.0.0.1:3677/console на вашем ноутбуке станет доступна веб-консоль, обслуживаемая шлюзом. При первом посещении вы подтверждаете права оператора, вставив API-токен, после чего задаете имя пользователя и пароль для консоли. Вход в систему устанавливает httpOnly сессионную cookie, действительную в течение 7 дней, которую JavaScript на странице не может прочитать; консоль также никогда не отображает токен повторно. Страница Connect в консоли выводит готовые фрагменты кода для клиентов, уже настроенные на вашу конечную точку.
Создание песочницы и выполнение кода в ней
Одна операция создает песочницу: acquire. Она идемпотентна, поэтому один и тот же ключ всегда возвращает одну и ту же песочницу, создавая, пробуждая, запуская или восстанавливая её по мере необходимости. Любой другой глагол возвращает ошибку 404 для ключа, который ранее не встречался. В dor CLI отсутствует глагол acquire, поэтому первая песочница создается через консоль или клиентскую библиотеку.
Путь через консоль — самый быстрый. Откройте /console через туннель и создайте песочницу с именем my-agent. После этого с ней можно работать через CLI.
sudo grep DORMICE_API_TOKEN /etc/dormice/env
export DORMICE_ENDPOINT=http://127.0.0.1:3676
export DORMICE_API_TOKEN=paste-the-value-here
dor sandbox ls
dor sandbox exec my-agent 'python3 --version'dor sandbox ls выводит список всех песочниц с указанием их состояния жизненного цикла; так можно отследить переход из активного состояния в замороженное. dor sandbox exec выводит версию Python 3.12, так как базовый образ — это Ubuntu 24.04 с предустановленными Python 3.12, Node 24, git и ripgrep. Ошибка аутентификации означает, что в скопированной строке токена было указано имя переменной.
Файлы передаются с помощью dor sandbox push my-agent ./script.py, которые попадают в /home/user/script.py, а dor sandbox pull my-agent notes.txt позволяет забрать файл обратно. Стандартные файловые операции ограничены 16 MiB на файл, в то время как файловый интерфейс E2B поддерживает потоковую передачу, и единственным ограничением остается дисковая квота песочницы.
Удаление — единственный глагол, приводящий к потере данных. dor sandbox destroy my-agent удаляет песочницу и является идемпотентным; основной README, встроенный навык агента и README пакета CLI документируют эту операцию под одним и тем же именем. В любом случае запускайте dor sandbox --help для своей сборки, так как установщик отслеживает main, а CLI постоянно расширяется.
Подключите существующий код E2B к собственному серверу
В этом и заключается практическая ценность. Официальный пакет e2b из npm без изменений обращается к Dormice. Запустите этот код на своём ноутбуке при открытом SSH-туннеле. Поэтому на сервере не будет открыто ничего нового.
npm init -y
npm i e2b tsximport { Sandbox } from 'e2b';
const sbx = await Sandbox.create({
apiKey: `e2b_${process.env.DORMICE_API_TOKEN}`,
apiUrl: 'http://127.0.0.1:3676/e2b/api',
sandboxUrl: 'http://127.0.0.1:3676/e2b/envd',
});
const result = await sbx.commands.run('python3 -c "print(6 * 7)"');
console.log(result.exitCode, result.stdout);
await sbx.kill();DORMICE_API_TOKEN=paste-the-value-here npx tsx index.tsПри успешном выполнении выводятся код завершения 0 и 42. В качестве API key используется ваш токен Dormice с префиксом e2b_. Именно такой формат ожидает слой совместимости.
Это не заглушка. Официальный пакет проверяет потоковую передачу stdout и stderr, фоновые команды, интерактивный PTY, подписанные URL для загрузки и скачивания, мониторинг каталогов и прокси порта. Проверки выполняются в отношении реальных daemon Docker и gVisor в составе end-to-end suite проекта. Перед миграцией рабочих систем учтите несколько отличий:
- Сборка template не реализована. Template — это docker image, который вы самостоятельно собираете и регистрируете с помощью
dor template add. ЗатемSandbox.create('name')разрешает его имя. Для незарегистрированного имени возвращается ошибка 404, а не создаётся фиктивный объект. - Для sandbox, созданных через интерфейс E2B, действуют реальные deadlines, поскольку этого требует семантика E2B. Для sandbox, созданных через native API, deadlines никогда не устанавливаются.
- При заморозке sandbox его процессы сохраняются и продолжают выполнение после возобновления. Поэтому pause и resume здесь не означают остановку и последующий полный запуск, как это может быть в других системах.
Что ограничивает песочница, а что нет
gVisor перехватывает системные вызовы контейнера в пространстве пользователя и обрабатывает их самостоятельно, поэтому код в песочнице не взаимодействует напрямую с ядром хоста. Внутри песочницы команды выполняются от имени user (uid 1000), но эта учетная запись имеет право на sudo без пароля, поэтому root внутри песочницы доступен любому коду, который его запросит. Не рассматривайте uid как средство защиты: проект прямо заявляет, что границей безопасности является gVisor, а не uid, и песочница, которая повышает свои привилегии, всё равно не может получить доступ к ядру хоста. Это решает стандартную задачу: сгенерированный скрипт, который запускает rm -rf /, заполняет диск или создает процессы до исчерпания ресурсов, повреждает только свою песочницу и не выходит за её пределы.
Вот что песочница не ограничивает. Защита от этого — ваша задача.
- Песочница имеет доступ к исходящей сети. Сгенерированный код может скачивать всё, что угодно, и отправлять найденные данные. Сетевая защита установщика охватывает два конкретных аспекта: она блокирует трафик контейнера к службе метаданных облака по адресам 169.254.0.0/16 и 100.100.100.200 (адрес, используемый Alibaba Cloud, где облако передает учетные данные экземпляра любому, кто может к ним обратиться), а также отключает трафик между контейнерами с помощью
"icc": falseвdaemon.jsonDocker. Ничто другое не блокируется. Изучитеsudo iptables -S DOCKER-USERи добавьте собственные правила DROP для частных диапазонов, к которым у песочницы не должно быть доступа. - Docker вставляет свои правила перед правилами вашего брандмауэра, поэтому опубликованный порт контейнера может отвечать из Интернета, даже если ufw показывает, что он закрыт. Прочитайте как Docker публикует порты в обход ufw и основы брандмауэра ufw для VPS, прежде чем открывать что-либо на этом хосте.
- gVisor — это ядро в пространстве пользователя, а не гипервизор. Это осознанный компромисс, так как для заморозки процессов песочницы должны быть обычными процессами, а требование KVM ограничило бы возможность установки в некоторых средах. Если ваша модель угроз требует аппаратной виртуализации, используйте изоляцию уровня Firecracker и примите связанные с этим эксплуатационные расходы.
- API-токен является единственной границей безопасности на стороне клиента. Любой, у кого есть
DORMICE_API_TOKEN, может создавать, читать и уничтожать любую песочницу на машине. Предоставьте процессу агента отдельного пользователя с минимальными привилегиями на VPS и обращайтесь с токеном так же, как с SSH-ключом. Рекомендации из безопасного запуска Claude Code на VPS применимы напрямую.
Сам демон работает от имени root на вашем хосте. gVisor защищает хост от кода внутри песочницы, но ничто не защищает хост от самого демона или от того, у кого есть его токен. Поэтому машина, на которой работает Dormice, должна выполнять только эту задачу. Если ваш агент также обращается к инструментам через MCP (model context protocol), держите эти MCP-серверы на отдельном VPS по той же причине.
Сколько песочниц помещается в 4 GB и 8 GB?
Память расходуется по двум направлениям: базовая нагрузка самого хоста и рабочий набор каждой песочницы, которая сейчас активна. Выделите около 1 GB на Ubuntu, Docker и daemon, а оставшийся объём разделите на фактическое потребление одной песочницы. Песочница, в которой выполняется Python-скрипт и читается несколько файлов, обычно использует от 200 до 300 MiB. Песочница с компилятором или полным набором тестов может потреблять больше 1 GiB.
Данные, на которых построен график
[
{
"host": "4 GB VPS",
"active_at_512_mib": 6,
"active_at_1_gib": 3,
"frozen_on_16gb_swap": 16
},
{
"host": "8 GB VPS",
"active_at_512_mib": 14,
"active_at_1_gib": 7,
"frozen_on_16gb_swap": 16
}
]VPS с 4 GB одновременно поддерживает около 6 активных песочниц, если каждая использует 512 MiB, или 3, если каждая использует полный gibibyte. Для VPS с 8 GB эти значения составляют 14 и 7. Это предельные значения для параллельной работы, а не результаты тестирования производительности. Поэтому отслеживайте free -m во время работы собственной нагрузки.
Для замороженных песочниц ограничивающим ресурсом становится swap, а не RAM. В этом и состоит основной принцип такой схемы. Если замороженная песочница занимала 1 GiB, примерно такой же объём сохраняется в swap, тогда как в RAM она почти ничего не занимает. Поэтому swapfile размером 16 GB, который создаётся установщиком по умолчанию, позволяет разместить около 16 таких песочниц. После этого их нужно перевести на остановленный уровень, где они будут занимать только место на диске. В долгосрочной перспективе именно диск становится основным ограничением: каждая песочница сохраняет свою файловую систему, и несколько десятков агентов, каждый со своей директорией node_modules, заполнят небольшой том задолго до того, как потребление памяти станет проблемой.
Заморозка, остановка, архивация: параметры жизненного цикла
По умолчанию используется заморозка через 10 минут простоя, остановка через 3 дня и архивация через 7 дней, если она настроена. Установка stopAfterSeconds в значение null превращает процесс в резидентный агент: он может замораживаться при простое, но никогда не выполняет «холодный» запуск.
Архивация является опциональной, и демон корректно обрабатывает этот статус. Настройте S3-совместимое хранилище на странице параметров консоли (четыре переменные DORMICE_S3_* по-прежнему существуют, но используются только как начальные значения при первом запуске шлюза), и диск остановленной «песочницы» будет упакован с помощью tar и zstd, отправлен в бакет и освобожден локально. Этот бакет может быть вашим собственным бакетом MinIO, размещенным на другой вашей машине. Если оставить хранилище ненастроенным, «песочницы» будут оставаться в состоянии остановки бесконечно, а политика, требующая архивации, будет отклонена, а не проигнорирована без уведомления. Восстановление происходит прозрачно: следующий запрос acquire немедленно возвращает статус restoring и значение прогресса, а затем переключается в состояние ready, как только диск будет восстановлен.
Стоит ли использовать это решение сейчас?
Прямой ответ: не для задач, которые вы не сможете восстановить с нуля. Репозиторий был создан 8 июля 2026 года. По состоянию на 12 октября 2026 года у него 1,509 звезд, 109 форков, лицензия Apache-2.0 и нет ни одного тегированного релиза. В строке статуса в README прямо указано, что проект не готов к промышленной эксплуатации.
Такое сочетание факторов создает специфические риски. Код постоянно меняется, так как установщик отслеживает main. Интерфейс все еще находится в стадии формирования: документация теперь описывает шлюз перед демоном, у которого есть собственный порт, отдельный файл конфигурации и собственная база данных. Проект, которому всего три месяца, может быть закрыт в любой момент, так как условия лицензии никого не обязывают продолжать разработку.
Риск становится приемлемым благодаря совместимости с E2B. Ваше приложение взаимодействует с протоколом, для которого существует облачная реализация, поэтому, если Dormice перестанет развиваться, вы просто измените два URL и продолжите работу. Пишите агент с расчетом на интерфейс E2B, а не на нативный API, чтобы сохранить возможность миграции. Нативный пакет @dormice/sdk еще не опубликован в npm, поэтому его использование требует сборки из репозитория, что является еще одной причиной выбрать путь совместимости.
Запускайте проект там, где потеря данных не будет критичной. Автоматизируйте пересборку хоста с помощью скриптов, не допускайте попадания токенов в командную строку или коммиты, а все ценные данные выгружайте из песочниц согласно собственному графику резервного копирования.
FAQ
Готов ли Dormice к промышленной эксплуатации?
Нет, и сам проект прямо об этом заявляет. В статусе README указано, что проект пока не готов к использованию в production. По состоянию на 12 октября 2026 года репозиторию около трех месяцев, в нем нет git-тегов и релизов, поэтому зафиксировать версию невозможно. Установщик клонирует ветку main, что означает получение самого свежего коммита при каждом запуске. Записывайте git -C /opt/dormice rev-parse HEAD после каждой установки, сохраняйте копии снимков базы данных, которые установщик записывает в /var/lib/dormice/backups/, и храните все ценные данные вне песочниц.
Чем Dormice отличается от предоставления агенту временной виртуальной машины?
Временная виртуальная машина — это инстанс с доступом по SSH, который вы создаете для сессии и удаляете после завершения работы. Dormice — это API для выполнения кода: ваша программа вызывает acquire, затем exec, и получает stdout и код завершения без промежуточной SSH-сессии. Виртуальная машина подходит человеку или агенту, которому на время нужен полноценный компьютер. Dormice подходит приложению, которое многократно запускает сгенерированный код в течение дня и не хочет тратить ресурсы на настройку и удаление машины для каждого запуска.
Действительно ли официальный E2B SDK работает без изменения кода?
Да, при условии изменения конфигурации. Укажите apiUrl и sandboxUrl на /e2b/api и /e2b/envd в вашем демоне, а в качестве API-ключа передайте токен Dormice с префиксом e2b_. Выполнение команд, PTY-сессии, передача файлов, подписанные URL и проксирование портов — все это покрывается сквозными тестами проекта, работающими через официальный пакет. Существенный пробел — сборка шаблонов: e2b template build не реализован, поэтому шаблоном является Docker-образ, который вы собираете и регистрируете с помощью dor template add.
Сколько песочниц поместится на VPS с 4 ГБ оперативной памяти?
Примерно 6 одновременно активных песочниц, если каждая использует 512 МБ, или 3, если каждая использует целый гибибайт, после резервирования примерно 1 ГБ для операционной системы, Docker и демона. Количество замороженных песочниц ограничено объемом swap, поэтому стандартный файл подкачки размером 16 ГБ позволяет разместить около 16 песочниц, каждая из которых занимала гибибайт. Проведите собственные замеры с помощью free -m под реальной нагрузкой, так как песочница, выполняющая набор тестов, потребляет в несколько раз больше ресурсов, чем песочница, выполняющая небольшой скрипт.
Почему для Dormice необходимо устанавливать vm.swappiness равным 100?
Замораживание песочницы означает вытеснение ее неактивной памяти в swap. gVisor хранит память песочницы как разделяемую память (shared memory), а ядро Linux не вытесняет разделяемую память при стандартном значении swappiness. Поэтому при стандартных настройках замораживание ничего не освобождает, и песочница продолжает занимать полный объем памяти. Проект зафиксировал 0 байт освобожденной памяти при стандартных настройках и 99.5 процентов при значении 100. Проверяйте фактическое значение с помощью sysctl vm.swappiness, а не чтением конфигурационных файлов, так как некоторые облачные образы поставляются со значением 0.