SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor · Zaktualizowano 2026-10-23

Dormice: własny sandbox dla agentów AI na VPS

Uruchom własne środowisko izolowane kompatybilne z E2B na serwerze VPS. Dowiedz się, jak skonfigurować demona Dormice, bezpiecznie wykonywać kod w kontenerach i zarządzać zasobami.

Czym jest, a czym nie jest Dormice

Dormice to samodzielnie hostowane środowisko izolowane (sandbox) dla agentów: jeden demon na posiadanym serwerze Linux VPS, z którym kod agenta komunikuje się przez HTTP w celu uruchamiania niezaufanego kodu w odizolowanym kontenerze. Program żąda środowiska o określonej nazwie, otrzymuje to samo środowisko niezależnie od jego poprzedniego stanu, wykonuje w nim polecenie i odczytuje wynik. Środowisko to zasób programistyczny, a nie maszyna, do której loguje się użytkownik.

Jest to podejście odmienne od udostępniania agentowi całego komputera. Jednorazowa maszyna wirtualna dla agenta programistycznego to środowisko, do którego logujesz się przez SSH, pozwalasz agentowi na jego zniszczenie, a następnie usuwasz. Dormice znajduje się poziom niżej: to API wykonawcze, z którego korzysta program, gdy posiada już kod i potrzebuje bezpiecznego miejsca do jego uruchomienia. Użyj jednorazowej maszyny wirtualnej, gdy jednostką pracy jest cała maszyna. Użyj Dormice, gdy jednostką pracy jest pojedyncze wywołanie exec i chcesz wykonywać ich setki dziennie bez konieczności tworzenia setek maszyn wirtualnych.

Projekt jest kompatybilny z E2B. E2B to hostowana usługa typu sandbox, której biblioteki klienckie są już importowane przez wiele frameworków dla agentów. Dormice obsługuje ten sam protokół pod własnymi prefiksami URL, dzięki czemu aplikacja napisana z użyciem oficjalnego pakietu e2b działa nadal po przekierowaniu jej na własny serwer. Kod aplikacji nie ulega zmianie. Zmieniają się jedynie dwa adresy URL oraz prefiks klucza API.

Co w praktyce oznacza określenie "SQLite dla piaskownic agentów"

SQLite to baza danych, którą się osadza, a nie usługa, którą się zarządza, a Dormice bezpośrednio zapożycza to porównanie. Jeden demon na maszynę, jeden plik SQLite dla jego rejestru, jeden port TCP oraz niewielka bramka zainstalowana obok, która obsługuje konsolę internetową. Brak Kubernetes, brak zewnętrznego serwera bazy danych. Demon zakłada wyłączną blokadę na plik rejestru, więc drugi demon na tej samej maszynie odmawia uruchomienia zamiast po cichu dzielić stan. Każda piaskownica żyje na maszynie, na której została utworzona. Plik README opisuje teraz flotę jako jedną bramkę oraz maszyny w jej sieci prywatnej, ale nadal zaznacza, że jeśli potrzebne są piaskownice przenoszone między maszynami lub flota rozproszona między regionami, należy wybrać inne rozwiązanie i warto posłuchać tej rady.

Druga część tej koncepcji dotyczy kosztów. Hostowana piaskownica jest rozliczana za każdą sekundę istnienia, więc z założenia jest rozwiązaniem tymczasowym. Dormice działa na sprzęcie, za który już płacisz, więc jego piaskownice są trwałe i stają się tańsze, im dłużej pozostają w bezruchu. Piaskownica przechodzi w stan spoczynku stopniowo: aktywna, zamrożona, zatrzymana, zarchiwizowana. Każde wywołanie przywraca ją z poziomu, na którym się znajdowała.

Zamrażanie to kluczowy mechanizm, ponieważ sprawia, że utrzymywanie piaskownicy każdego agenta na stałe jest opłacalne. Poniżej znajdują się opublikowane dane projektu, mierzone na jego własnym sprzęcie, a nie na Twoim.

WykresOne idle sandbox before and after freezing, figures published by the project
Dane, na których opiera się ten wykres
[
  {
    "label": "Active, holding 1 GiB",
    "resident_memory_mib": 1024,
    "wake_ms": 0
  },
  {
    "label": "Frozen",
    "resident_memory_mib": 5,
    "wake_ms": 50
  }
]

Bezczynna piaskownica zajmująca 1024 MiB pamięci po zamrożeniu ogranicza zużycie do 5 MiB pamięci rezydentnej i powraca do działania w około 50 ms. Procesy są zawieszane i wznawiane w miejscu, więc długo działający agent zachowuje stan powłoki oraz niedokończoną pracę po zamrożeniu. Przed zaplanowaniem wydajności na podstawie tych danych, należy przeprowadzić testy na własnym hoście.

Wymagania wstępne dla hosta

Hostem musi być system Ubuntu lub Debian na architekturze x86_64, a instalator wymaga uprawnień root. Demon zachowuje uprawnienia root w czasie wykonywania, ponieważ przeprowadza operacje loop mount oraz zapisuje do cgroups.

Piaskownice działają w środowisku Docker z użyciem gVisor (środowisko uruchomieniowe kontenerów, które umieszcza jądro w przestrzeni użytkownika między kontenerem a jądrem hosta), co dostarcza środowisko runsc wykorzystywane przez każdą piaskownicę. Demon wymaga Node 22 lub nowszego. Jeśli systemowy Node jest w wersji 22 lub nowszej, instalator użyje go ponownie; tylko w przypadku jego braku lub starszej wersji instalator pobierze własną, przypisaną kopię, zweryfikuje jej sumę kontrolną i rozpakuje ją w /opt.

Wymagane jest istnienie partycji swap, a wartość vm.swappiness musi wynosić 100. Nie jest to porada dotycząca optymalizacji, lecz wymóg funkcjonalny. Mechanizm zamrażania działa poprzez przenoszenie pamięci bezczynnej piaskownicy do swap; gVisor przechowuje pamięć piaskownicy jako pamięć współdzieloną, a jądro nie przenosi pamięci współdzielonej przy domyślnej wartości swappiness. Pomiary projektu wykazały odzyskanie 0 bajtów przy wartości domyślnej oraz 99,5 procent przy wartości 100. Należy sprawdzić wartość faktycznie używaną przez jądro, ponieważ niektóre obrazy chmurowe dostarczają vm.swappiness = 0 w pliku, którego użytkownik zazwyczaj nie sprawdza.

sysctl vm.swappiness
swapon --show

Polecenie sysctl vm.swappiness powinno zwrócić vm.swappiness = 100, a swapon --show powinno wyświetlić plik wymiany. Jeśli swappiness zwraca 0, każda operacja zamrażania jest bezskuteczna, co powoduje utrzymywanie pełnego zużycia pamięci dla każdej bezczynnej piaskownicy.

Instalacja Dormice na Ubuntu

Zalecana metoda instalacji polega na przekazaniu potoku do bash:

curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh | bash

Pobierz skrypt i przeczytaj go przed uruchomieniem. Skrypt działa z uprawnieniami root i modyfikuje system: instaluje Docker, jeśli go brakuje, pobiera gVisor oraz Caddy z weryfikacją sum kontrolnych, tworzy plik wymiany (swapfile), jeśli host go nie posiada, tworzy jednostki systemd dla demona, bramy (gateway) oraz rejestru obrazów, a także dodaje reguły zapory sieciowej.

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 określa rozmiar pliku wymiany; domyślnie jest to 16, co stanowi znaczną ilość miejsca na dysku w przypadku małych serwerów VPS. --mirror cn przełącza pobieranie na serwery lustrzane dostępne z terenu Chin kontynentalnych. Ponowne uruchomienie instalatora aktualizuje kod i naprawia rozbieżności konfiguracji, nigdy nie zmieniając tokena API.

Kod trafia do /opt/dormice, konfiguracja do /etc/dormice/env (oraz /etc/dormice/gateway.env dla bramy), dane piaskownicy do /var/lib/dormice, a polecenia dormice i dor do /usr/local/bin. Instalator generuje token API podczas instalacji i zapisuje go w /etc/dormice/env z uprawnieniami 600; ta sama wartość trafia do pliku bramy.

Nie istnieją oznaczone wersje (tagged releases) do instalacji. Według stanu na 12 października 2026 r. repozytorium nie posiada tagów git ani wydań GitHub, więc instalator klonuje main, co oznacza pobranie wersji z danego dnia. Przypięcie wersji wymaga zatem zapisania identyfikatora commitu, który został zainstalowany.

git -C /opt/dormice rev-parse HEAD

Zapisz ten hash w notatkach wdrożeniowych, ponieważ wskazuje on dokładnie, jaka wersja kodu jest uruchomiona. Nie jest to jednak samodzielny sposób na powrót do poprzedniej wersji: nowe procesy wykonują migracje bazy danych podczas uruchamiania, a dokumentacja aktualizacji wskazuje, że migracji nie można cofnąć przez ponowne uruchomienie starszego instalatora. Przed restartem czegokolwiek instalator zapisuje migawki obu baz danych w /var/lib/dormice/backups/ i przechowuje trzy najnowsze. Te migawki są oficjalną metodą przywracania systemu po nieudanej aktualizacji, dlatego przed kolejną aktualizacją należy skopiować najnowszą z nich poza serwer.

Instalator kończy działanie, uruchamiając dor doctor – test hosta w trybie tylko do odczytu, który uruchamia rzeczywiste kontenery gVisor, aby zweryfikować działanie środowiska uruchomieniowego, zamiast polegać na liście pakietów. Uruchom to polecenie ponownie, gdy demon zacznie działać nieprawidłowo.

sudo dor doctor
systemctl is-active dormice

systemctl is-active dormice powinno zwrócić active. Jeśli zwróci failed, journalctl -u dormice -n 50 zawiera przyczynę błędu; nieudany start zazwyczaj wynika z problemów z plikiem wymiany lub wymaganiami wstępnymi gVisor, a nie z samego demona.

Instalator instaluje również Caddy, więc sprawdź, co nasłuchuje na portach, zanim uznasz konfigurację zapory sieciowej za zakończoną.

sudo ss -lntp

Demon zawsze wiąże się z 127.0.0.1 i z założenia nie ma ustawienia pozwalającego na zmianę tego adresu. Zmienić można jedynie port: DORMICE_PORT domyślnie przyjmuje wartość 3676. Brama (gateway) działająca obok podlega tej samej zasadzie na 127.0.0.1:3677, z DORMICE_GATEWAY_PORT dla portu i celowym brakiem ustawienia hosta. Dostęp do któregokolwiek z nich z laptopa jest świadomym działaniem, a najprostszą metodą jest tunel SSH przekierowujący oba porty.

ssh -L 3676:127.0.0.1:3676 -L 3677:127.0.0.1:3677 root@your-server

Po otwarciu tunelu http://127.0.0.1:3677/console na laptopie otwiera konsolę internetową obsługiwaną przez bramę. Podczas pierwszej wizyty należy potwierdzić uprawnienia operatora, wklejając jednorazowo token API, a następnie ustawić nazwę użytkownika i hasło do konsoli. Zalogowanie ustawia ciasteczko sesyjne httpOnly, ważne przez 7 dni, którego skrypty JavaScript na stronie nie mogą odczytać; konsola nigdy nie wyświetla tokena ponownie. Strona Connect zawiera gotowe fragmenty kodu dla klienta, już skonfigurowane pod Twój punkt końcowy.

Tworzenie piaskownicy i wykonywanie w niej kodu

Operacja acquire tworzy piaskownicę. Jest ona idempotentna, co oznacza, że ten sam klucz zawsze zwraca tę samą piaskownicę, w razie potrzeby tworząc ją, wybudzając, uruchamiając lub przywracając. Każde inne polecenie zwraca błąd 404 dla nieznanego klucza. Interfejs dor CLI nie posiada polecenia acquire, dlatego pierwszą piaskownicę należy utworzyć za pomocą konsoli lub biblioteki klienckiej.

Najszybszą metodą jest użycie konsoli. Otwórz /console przez tunel i utwórz piaskownicę o nazwie my-agent. Od tego momentu CLI będzie z nią współpracować.

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'

Polecenie dor sandbox ls wyświetla listę wszystkich piaskownic wraz z ich stanem cyklu życia; w ten sposób można monitorować przejście ze stanu aktywnego do zamrożonego. Polecenie dor sandbox exec wyświetla wersję Python 3.12, ponieważ domyślny obraz to Ubuntu 24.04 z preinstalowanym środowiskiem Python 3.12, Node 24, git oraz ripgrep. Błąd uwierzytelniania oznacza, że skopiowana linia z tokenem zawierała nazwę zmiennej.

Pliki przesyła się za pomocą dor sandbox push my-agent ./script.py, które trafiają do /home/user/script.py, a dor sandbox pull my-agent notes.txt pozwala na ich pobranie. Natywne operacje na plikach są ograniczone do 16 MiB na plik, podczas gdy interfejs plików E2B obsługuje strumieniowanie, dzięki czemu jedynym ograniczeniem jest przydział miejsca na dysku piaskownicy.

Zniszczenie piaskownicy to jedyna operacja powodująca utratę danych. Polecenie dor sandbox destroy my-agent usuwa piaskownicę i jest idempotentne; główny plik README, dołączona umiejętność agenta oraz plik README pakietu CLI dokumentują tę operację pod tą właśnie nazwą. Mimo to warto uruchomić dor sandbox --help na własnej kompilacji, ponieważ instalator śledzi main, a CLI stale się rozwija.

Skierowanie istniejącego kodu E2B na własny serwer

To jest główny powód, dla którego warto się tym zainteresować. Oficjalna paczka e2b z npm, bez żadnych modyfikacji, komunikuje się z Dormice. Uruchom to ze swojego laptopa przy otwartym tunelu SSH, aby na serwerze nie nasłuchiwały żadne nowe usługi.

npm init -y
npm i e2b tsx
import { 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

Poprawne wykonanie kończy się kodem wyjścia 0 oraz komunikatem 42. Kluczem API jest Twój token Dormice z prefiksem e2b_, ponieważ takiej formy oczekuje warstwa kompatybilności.

Ta kompatybilność nie jest jedynie atrapą. Strumieniowanie stdout i stderr, polecenia działające w tle, interaktywny PTY, podpisane adresy URL do przesyłania i pobierania plików, monitorowanie katalogów oraz proxy portów – wszystko to jest obsługiwane przez oficjalną paczkę w oparciu o rzeczywistego demona Docker i gVisor, co potwierdza zestaw testów end-to-end projektu. Przed migracją jakichkolwiek rzeczywistych rozwiązań należy wziąć pod uwagę kilka różnic:

  • Budowanie szablonów nie jest zaimplementowane. Szablon to obraz docker, który budujesz samodzielnie i rejestrujesz za pomocą dor template add, a Sandbox.create('name') dokonuje jego rozpoznania. Niezarejestrowana nazwa zwraca błąd 404 zamiast udawać, że operacja się powiodła.
  • Piaskownice utworzone przez interfejs E2B otrzymują rzeczywiste limity czasowe, ponieważ wymagają tego semantyka E2B. Limity czasowe nigdy nie są narzucane piaskownicom utworzonym przez natywne API.
  • Zamrożona piaskownica zachowuje swoje procesy i wznawia je w miejscu, w którym zostały przerwane, więc pauza i wznowienie w tym przypadku nie oznaczają zatrzymania i zimnego startu, do których możesz być przyzwyczajony.

Co piaskownica blokuje, a czego nie

gVisor przechwytuje wywołania systemowe kontenera w przestrzeni użytkownika i obsługuje je samodzielnie, dzięki czemu kod w piaskownicy nie komunikuje się bezpośrednio z jądrem systemu hosta. Wewnątrz piaskownicy polecenia działają jako user (uid 1000), jednak to konto posiada sudo bez hasła, więc uprawnienia root wewnątrz piaskownicy są dostępne dla każdego kodu, który o nie wystąpi. Nie należy traktować uid jako zabezpieczenia: projekt wyraźnie wskazuje, że granicą bezpieczeństwa jest gVisor, a nie uid, a piaskownica, która podnosi swoje uprawnienia, nadal nie może uzyskać dostępu do jądra hosta. Rozwiązuje to typowe przypadki: wygenerowany skrypt, który uruchamia rm -rf /, zapełnia dysk lub tworzy procesy potomne do momentu awarii, uszkadza jedynie własną piaskownicę i na tym kończy działanie.

Oto czego piaskownica nie blokuje. Każdy z poniższych punktów wymaga samodzielnej konfiguracji.

  • Piaskownica posiada działającą sieć wychodzącą. Wygenerowany kod może pobrać dowolne dane i przesłać wszystko, co znajdzie. Mechanizmy utwardzania sieci w instalatorze obejmują dwie konkretne rzeczy: odrzucają ruch kontenera do usługi metadanych chmury pod adresem 169.254.0.0/16 oraz 100.100.100.200 (adres używany przez Alibaba Cloud), skąd instancje pobierają poświadczenia, oraz wyłączają komunikację między kontenerami za pomocą "icc": false w pliku daemon.json systemu Docker. Żaden inny ruch nie jest blokowany. Należy zapoznać się z sudo iptables -S DOCKER-USER i dodać własne reguły DROP dla zakresów prywatnych, do których piaskownica nie powinna mieć dostępu.
  • Docker wstawia własne reguły przed regułami zapory sieciowej, więc opublikowany port kontenera może odpowiadać na żądania z Internetu, mimo że ufw wskazuje, iż port jest zamknięty. Przed wystawieniem czegokolwiek na tym hoście należy przeczytać jak Docker publikuje porty z pominięciem ufw oraz podstawy zapory ufw dla VPS.
  • gVisor to jądro działające w przestrzeni użytkownika, a nie hypervisor. Jest to świadomy kompromis, ponieważ zamrażanie procesów wymaga, aby piaskownice były procesami, a wymóg użycia KVM uniemożliwiłby instalację na wielu systemach. Jeśli model zagrożeń wymaga wirtualizacji sprzętowej, należy użyć izolacji klasy Firecracker i zaakceptować związane z tym koszty operacyjne.
  • Token API stanowi jedyną granicę bezpieczeństwa po stronie klienta. Każdy, kto posiada DORMICE_API_TOKEN, może tworzyć, odczytywać i niszczyć każdą piaskownicę na maszynie. Procesowi agenta należy przypisać własnego użytkownika z minimalnymi uprawnieniami na VPS i traktować token tak samo, jak klucz SSH. Dobre praktyki z bezpiecznego uruchamiania Claude Code na VPS mają tutaj bezpośrednie zastosowanie.

Sam demon działa jako root na hoście. gVisor chroni hosta przed kodem wewnątrz piaskownicy, ale nic nie chroni hosta przed samym demonem ani przed osobą posiadającą jego token. Maszyna z uruchomionym Dormice powinna być dedykowana wyłącznie do tego celu. Jeśli agent uzyskuje również dostęp do narzędzi przez MCP (model context protocol), należy z tego samego powodu utrzymywać te serwery MCP na oddzielnym VPS.

Ile piaskownic mieści się w 4 GB i 8 GB pamięci RAM?

Pamięć zużywają dwa elementy: bazowe zapotrzebowanie systemu hosta oraz zestaw roboczy każdej aktywnej piaskownicy. Należy zarezerwować około 1 GB na system Ubuntu, Docker oraz demona, a następnie podzielić pozostałą ilość przez rzeczywiste zużycie jednej piaskownicy. Piaskownica uruchamiająca skrypt Python, który odczytuje kilka plików, zajmuje od 200 do 300 MiB. Piaskownica kompilująca kod lub wykonująca pełny zestaw testów może przekroczyć jeden gibibajt.

WykresConcurrent sandboxes by host RAM, arithmetic after a 1 GB host reserve
Dane, na których opiera się ten wykres
[
  {
    "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
  }
]

Serwer VPS z 4 GB pamięci RAM pozwala na utrzymanie jednocześnie 6 aktywnych piaskownic, jeśli każda z nich zużywa 512 MiB, lub 3, jeśli każda zużywa pełny gibibajt. W przypadku serwera VPS z 8 GB pamięci wartości te wzrastają odpowiednio do 14 oraz 7. Są to limity dla pracy współbieżnej, wyliczone matematycznie, a nie na podstawie benchmarków, dlatego należy monitorować free -m podczas rzeczywistego obciążenia.

Zamrożone piaskownice są ograniczone przez przestrzeń wymiany (swap), a nie przez pamięć RAM, co stanowi istotę tego projektu. Zamrożona piaskownica, która zajmowała jeden gibibajt, utrzymuje w pamięci swap mniej więcej taką samą ilość danych, przy niemal zerowym wykorzystaniu pamięci operacyjnej. Domyślny plik swap o rozmiarze 16 GB pozwala na przechowywanie około 16 takich piaskownic. Po przekroczeniu tego limitu piaskownice muszą zostać zatrzymane, co ogranicza ich koszt wyłącznie do zajętego miejsca na dysku. Dysk jest w dłuższej perspektywie głównym ograniczeniem: każda piaskownica przechowuje własny system plików, a kilkadziesiąt agentów, z których każdy posiada katalog node_modules, zapełni mały wolumin znacznie szybciej, niż stanie się to problemem dla pamięci RAM.

Zamrożenie, zatrzymanie, archiwizacja: parametry cyklu życia

Domyślne ustawienia to zamrożenie po 10 minutach bezczynności, zatrzymanie po 3 dniach oraz archiwizacja po 7 dniach, jeśli została skonfigurowana. Ustawienie stopAfterSeconds na null powoduje działanie agenta w trybie rezydentnym: może on zostać zamrożony w stanie bezczynności, ale nigdy nie wykonuje zimnego startu.

Archiwizacja jest opcjonalna, a demon informuje o jej statusie w sposób przejrzysty. Skonfiguruj magazyn zgodny z S3 na stronie ustawień konsoli (cztery zmienne DORMICE_S3_* nadal istnieją, ale służą jedynie jako wartości początkowe przy pierwszym uruchomieniu bramy), a dysk zatrzymanego środowiska sandbox zostanie spakowany za pomocą tar i zstd, wysłany do zasobnika (bucket) i zwolniony lokalnie. Ten zasobnik może być własnym zasobnikiem MinIO, hostowanym na innej maszynie. Jeśli magazyn pozostanie nieskonfigurowany, środowiska sandbox pozostaną w stanie zatrzymania na stałe, a próba zastosowania polityki wymuszającej archiwizację zostanie odrzucona zamiast być cicho ignorowaną. Przywracanie danych jest widoczne, a nie ukryte: kolejne żądanie typu acquire natychmiast zwraca status przywracania wraz z wartością postępu, a po odzyskaniu dysku zmienia status na gotowy.

Czy należy już na tym polegać?

Krótka odpowiedź: nie w przypadku systemów, których nie można odtworzyć od zera. Repozytorium utworzono 8 lipca 2026 roku. Według stanu na 12 października 2026 roku projekt posiada 1,509 gwiazdek, 109 forków, licencję Apache-2.0 i brak jakiegokolwiek otagowanego wydania. Sama sekcja statusu w pliku README wskazuje, że żadna część projektu nie jest gotowa do zastosowań produkcyjnych.

To połączenie cech niesie ze sobą określony rodzaj ryzyka. Kod zmienia się dynamicznie, ponieważ instalator śledzi main. Interfejs wciąż ewoluuje: dokumentacja opisuje obecnie bramę (gateway) działającą przed daemonem, posiadającą własny port, plik konfiguracyjny oraz bazę danych. Projekt mający około trzech miesięcy może zostać w każdej chwili porzucony, gdyż żadna klauzula licencyjna nie zobowiązuje nikogo do kontynuowania prac.

Ryzyko to jest akceptowalne dzięki kompatybilności z E2B. Aplikacja komunikuje się z protokołem, który posiada alternatywną, hostowaną implementację. W przypadku wstrzymania prac nad Dormice, wystarczy zmienić dwa adresy URL, aby zachować ciągłość działania. Należy tworzyć agenta w oparciu o interfejs E2B, a nie natywne API, co pozwala zachować drogę wyjścia. Natywny pakiet @dormice/sdk nie jest jeszcze dostępny w npm, więc korzystanie z niego wymaga budowania ze źródeł repozytorium, co stanowi drugi powód, by rozpocząć pracę od ścieżki kompatybilnej.

Należy uruchamiać to rozwiązanie w środowiskach, w których utrata danych jest dopuszczalna. Host powinien być odtwarzalny ze skryptu, tokeny muszą być przechowywane poza promptami i commitami, a wszelkie istotne dane należy kopiować z piaskownic zgodnie z własnym harmonogramem backupów.

FAQ

Czy Dormice jest gotowe do użycia w środowisku produkcyjnym?

Nie, co potwierdza sama dokumentacja projektu. Status w pliku README wskazuje, że żadna część projektu nie jest jeszcze gotowa do produkcji. Według stanu na 12 października 2026 repozytorium ma około trzech miesięcy, nie posiada tagów git ani wydań, więc nie ma numeru wersji, do którego można przypiąć konfigurację. Instalator klonuje gałąź main, co oznacza, że każde uruchomienie pobiera najnowszy commit. Należy rejestrować git -C /opt/dormice rev-parse HEAD po każdej instalacji, przechowywać kopie migawek bazy danych zapisywanych przez instalator w /var/lib/dormice/backups/ oraz trzymać wszelkie cenne dane poza piaskownicami.

Czym Dormice różni się od udostępnienia agentowi tymczasowej maszyny wirtualnej?

Tymczasowa maszyna wirtualna to instancja z dostępem SSH, tworzona na czas sesji i usuwana po jej zakończeniu. Dormice to API wykonawcze: program wywołuje funkcję acquire, następnie exec, otrzymując w odpowiedzi stdout oraz kod wyjścia, bez pośrednictwa powłoki. Maszyna wirtualna jest odpowiednia dla człowieka lub agenta, który potrzebuje pełnego dostępu do komputera przez dłuższy czas. Dormice jest przeznaczone dla aplikacji, która wielokrotnie w ciągu dnia uruchamia wygenerowany kod i nie wymaga pełnego procesu konfiguracji oraz usuwania środowiska przy każdym uruchomieniu.

Czy oficjalny SDK E2B naprawdę działa bez zmian w kodzie?

Tak, po wprowadzeniu zmian w konfiguracji. Należy skierować apiUrl oraz sandboxUrl na /e2b/api i /e2b/envd w swoim demonie, a jako klucz API przekazać token Dormice z prefiksem e2b_. Wykonywanie poleceń, sesje PTY, przesyłanie plików, podpisane adresy URL oraz proxy portów są obsługiwane przez zestaw testów end-to-end projektu, działający z oficjalnym pakietem. Budowanie szablonów stanowi istotny brak: e2b template build nie jest zaimplementowane, więc szablonem jest obraz docker, który należy zbudować i zarejestrować za pomocą dor template add.

Ile piaskownic mieści się na serwerze VPS z 4 GB pamięci RAM?

Około 6 aktywnych jednocześnie, jeśli każda piaskownica zużywa 512 MiB, lub 3, jeśli każda zużywa pełny gibibajt, po zarezerwowaniu około 1 GB na system operacyjny, Docker oraz demona. Zamrożone piaskownice są ograniczone jedynie przez swap, więc domyślny plik wymiany o rozmiarze 16 GB pozwala na przechowywanie około 16 piaskownic, z których każda zajmowała jeden gibibajt. Należy przeprowadzić własne pomiary za pomocą free -m pod rzeczywistym obciążeniem, ponieważ piaskownica uruchamiająca zestaw testów zużywa wielokrotnie więcej zasobów niż ta wykonująca prosty skrypt.

Dlaczego Dormice wymaga ustawienia vm.swappiness na 100?

Zamrożenie piaskownicy polega na przeniesieniu jej bezczynnej pamięci do pliku wymiany. gVisor przechowuje pamięć piaskownicy jako pamięć współdzieloną, a jądro Linux nie przenosi pamięci współdzielonej do swap przy domyślnych ustawieniach swappiness. W rezultacie przy ustawieniach domyślnych zamrożenie nie odzyskuje żadnych zasobów, a piaskownica nadal zajmuje pełną ilość pamięci. Projekt wykazał 0 bajtów odzyskanej pamięci przy ustawieniach domyślnych oraz 99,5 procent przy wartości 100. Należy sprawdzić efektywną wartość za pomocą sysctl vm.swappiness zamiast polegać na plikach konfiguracyjnych, ponieważ niektóre obrazy chmurowe mają domyślnie ustawioną wartość 0.

Czy ten artykuł był przydatny?