SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-10-13

Dormice selbst hosten: Agent-Sandboxes auf einem VPS

Betreiben Sie E2B-kompatible Agent-Sandboxes auf einem eigenen Linux-VPS. Installieren Sie Dormice, führen Sie Code isoliert aus, prüfen Sie die Isolation und planen Sie Ressourcen.

Was Dormice ist und was es nicht ist

Dormice ist eine selbst gehostete Agent-Sandbox: ein Daemon auf einem Linux-VPS, den Sie besitzen und den Ihr Agent-Code über HTTP aufruft, um nicht vertrauenswürdigen Code in einem isolierten Container auszuführen. Ihr Programm fordert eine Sandbox anhand ihres Namens an, erhält unabhängig von ihrem vorherigen Zustand dieselbe Sandbox zurück, führt darin einen Befehl aus und liest die Ausgabe. Die Sandbox ist eine programmatisch verwaltete Ressource und kein Rechner, auf dem Sie sich anmelden.

Das unterscheidet sich davon, einem Agenten einen vollständigen Rechner zu überlassen. Eine wegwerfbare VM für einen Coding-Agenten ist ein System, auf das Sie sich per SSH verbinden, das der Agent beschädigen darf und das Sie anschließend löschen. Dormice liegt eine Ebene darunter: Es ist die Ausführungs-API, die Ihr Programm aufruft, wenn bereits Code vorhanden ist und ein sicherer Ausführungsort benötigt wird. Verwenden Sie die wegwerfbare VM, wenn ein vollständiger Rechner die Arbeitseinheit ist. Verwenden Sie Dormice, wenn ein einzelner exec-Aufruf die Arbeitseinheit ist und Sie davon täglich hundert ausführen möchten, ohne hundert VMs zu betreiben.

Das Projekt bezeichnet sich als E2B-kompatibel. E2B ist ein gehosteter Sandbox-Dienst, dessen Client-Bibliothek bereits von vielen Agent-Frameworks importiert wird. Dormice stellt dasselbe Protokoll unter eigenen URL-Präfixen bereit. Dadurch läuft eine Anwendung, die für das offizielle e2b-Paket entwickelt wurde, weiter, wenn Sie sie auf Ihren eigenen Server verweisen. Der Anwendungscode muss nicht geändert werden. Sie ändern zwei URLs und ein Präfix des API-Schlüssels.

Was „die SQLite der Agent-Sandboxes“ in der Praxis bedeutet

SQLite ist eine Datenbank, die Sie einbetten, statt einen Dienst zu betreiben. Dormice übernimmt diesen Vergleich direkt. Pro Maschine gibt es einen Daemon, eine SQLite-Datei für das Ledger und einen TCP-Port. Daneben wird ein kleines Gateway installiert, das die Webkonsole bereitstellt. Es gibt kein Kubernetes und keinen externen Datenbankserver. Der Daemon setzt neben seinem Ledger eine exklusive Sperre. Ein zweiter Daemon auf derselben Maschine wird daher nicht gestartet, statt den Zustand unbemerkt aufzuteilen. Jede Sandbox bleibt auf der Maschine, auf der sie erstellt wurde. Die README beschreibt eine Flotte inzwischen als ein Gateway plus die Maschinen in dessen privatem Netzwerk. Sie weist jedoch weiterhin darauf hin, dass Sie für Sandboxes, die zwischen Maschinen verschoben werden, oder für eine Flotte über mehrere Regionen hinweg etwas anderes auswählen sollten. Außerdem sollten Sie genau zuhören.

Die zweite Hälfte des Konzepts betrifft die Kosten. Bei einer gehosteten Sandbox wird jede Sekunde ihrer Laufzeit abgerechnet. Gehostete Sandboxes sind daher grundsätzlich für eine kurze Lebensdauer ausgelegt. Dormice läuft auf Hardware, für die Sie bereits bezahlen. Seine Sandboxes bleiben deshalb dauerhaft bestehen und werden umso günstiger, je länger sie ungenutzt bleiben. Eine Sandbox fährt stufenweise herunter: aktiv, dann eingefroren, dann gestoppt und anschließend archiviert. Jeder acquire holt sie aus der erreichten Stufe wieder zurück.

Das Einfrieren ist der wichtigste Teil, den Sie verstehen sollten. Dadurch wird es bezahlbar, die Sandbox jedes Agenten dauerhaft aufzubewahren. Die folgenden Werte stammen aus den veröffentlichten Angaben des Projekts. Sie wurden auf dessen Hardware und nicht auf Ihrer gemessen.

DiagrammOne idle sandbox before and after freezing, figures published by the project
Die Daten hinter diesem Diagramm
[
  {
    "label": "Active, holding 1 GiB",
    "resident_memory_mib": 1024,
    "wake_ms": 0
  },
  {
    "label": "Frozen",
    "resident_memory_mib": 5,
    "wake_ms": 50
  }
]

Eine inaktive Sandbox mit 1024 MiB Speicher belegt nach dem Einfrieren resident nur noch 5 MiB und ist nach etwa 50 ms wieder aktiv. Prozesse werden an Ort und Stelle angehalten und fortgesetzt. Ein langlebiger Agent behält daher seinen Shell-Zustand und seine noch nicht abgeschlossene Arbeit über das Einfrieren hinweg. Reproduzieren Sie dieses Verhalten auf Ihrem eigenen Host, bevor Sie darauf Ihre Kapazitätsplanung aufbauen.

Was der Host vor der Installation benötigt

Der Host muss Ubuntu oder Debian auf x86_64 ausführen, und das Installationsprogramm benötigt root. Der Daemon läuft weiterhin als root, weil er Loop-Mounts ausführt und cgroups schreibt.

Die Sandboxes laufen unter Docker mit gVisor (einer Container-Laufzeitumgebung, die einen Kernel im Userspace zwischen den Container und den Host-Kernel setzt). Diese stellt die runsc-Laufzeitumgebung bereit, die jede Sandbox verwendet. Der Daemon benötigt Node 22 oder neuer. Wenn die Systemversion von Node bereits 22 oder neuer ist, verwendet das Installationsprogramm diese Version erneut. Nur wenn Node fehlt oder älter ist, lädt das Installationsprogramm eine eigene, festgelegte Version herunter, prüft deren Prüfsumme und entpackt sie unter /opt.

Es muss Swap vorhanden sein, und vm.swappiness muss auf 100 gesetzt sein. Das ist keine Empfehlung zur Optimierung, sondern eine funktionale Voraussetzung. Beim Einfrieren wird der Speicher einer inaktiven Sandbox in den Swap ausgelagert. gVisor hält den Sandbox-Speicher als Shared Memory, und der Kernel lagert Shared Memory bei der standardmäßigen Swappiness nicht aus. Das Projekt hat beim Standardwert 0 Byte freigegebenen Speicher gemessen, bei 100 dagegen 99,5 Prozent. Prüfen Sie den tatsächlich vom Kernel verwendeten Wert, da manche Cloud-Images vm.swappiness = 0 in einer Datei setzen, die Sie normalerweise nicht lesen würden.

sysctl vm.swappiness
swapon --show

sysctl vm.swappiness sollte vm.swappiness = 100 ausgeben, und swapon --show sollte eine Swap-Datei auflisten. Wenn die Swappiness 0 ausgibt, ist jedes Einfrieren wirkungslos und Sie benötigen weiterhin den vollständigen Speicher für jede inaktive Sandbox.

Dormice unter Ubuntu installieren

Die dokumentierte Installation besteht aus einer Pipe nach bash:

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

Laden Sie das Skript herunter und lesen Sie es, bevor Sie es ausführen. Das Skript läuft als root und verändert Ihren Host: Es installiert Docker, falls Docker fehlt, lädt gVisor und Caddy mit Prüfsummenüberprüfung herunter, erstellt eine Swap-Datei, falls auf dem Host kein Swap vorhanden ist, schreibt systemd-Units für den Daemon, das Gateway und eine Image-Registry und fügt Firewall-Regeln hinzu.

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 legt die Größe der Swap-Datei fest und verwendet standardmäßig 16. Das ist für einen kleinen VPS viel Speicherplatz. --mirror cn stellt die Downloads auf Spiegelserver um, die vom chinesischen Festland aus erreichbar sind. Wenn Sie das Installationsprogramm erneut ausführen, aktualisiert es den Code und korrigiert Abweichungen. Das API-Token wird dabei nie geändert.

Der Code wird nach /opt/dormice installiert, die Konfiguration nach /etc/dormice/env und zusätzlich nach /etc/dormice/gateway.env für das Gateway. Die Sandbox-Daten liegen in /var/lib/dormice. Die Befehle dormice und dor werden in /usr/local/bin installiert. Das Installationsprogramm erzeugt das API-Token während der Installation und schreibt es mit dem Modus 600 nach /etc/dormice/env. Derselbe Wert wird auch in die Datei des Gateways geschrieben.

Es gibt kein getaggtes Release, auf das Sie die Installation stützen können. Am 12. Oktober 2026 enthält das Repository keine git-Tags und keine GitHub-Releases. Das Installationsprogramm klont daher main, und Sie erhalten den Stand, der an diesem Morgen zuletzt hinzugefügt wurde. Eine Version zu fixieren bedeutet deshalb, den Commit zu notieren, den Sie tatsächlich installiert haben.

git -C /opt/dormice rev-parse HEAD

Speichern Sie diesen Hash zusammen mit Ihren Deployment-Notizen. Er zeigt genau, welchen Code Sie ausführen. Allein ist er jedoch kein Rückweg: Die neuen Prozesse führen beim Start Datenbankmigrationen aus, und laut Upgrade-Dokumentation wird eine Migration nicht rückgängig gemacht, wenn Sie ein älteres Installationsprogramm erneut ausführen. Bevor Sie etwas neu starten, speichert das Installationsprogramm Snapshots beider Datenbanken nach /var/lib/dormice/backups/ und behält die drei neuesten. Diese Snapshots sind nach einem fehlerhaften Upgrade der dokumentierte Rückweg. Kopieren Sie daher den neuesten Snapshot vom Host herunter, bevor Sie erneut aktualisieren.

Zum Abschluss führt das Installationsprogramm dor doctor aus. Dabei handelt es sich um eine schreibgeschützte Host-Prüfung, die echte gVisor-Container startet, um die Funktion der Laufzeitumgebung zu überprüfen, statt einer Paketliste zu vertrauen. Führen Sie die Prüfung erneut aus, wenn sich der Daemon fehlerhaft verhält.

sudo dor doctor
systemctl is-active dormice

systemctl is-active dormice sollte active ausgeben. Gibt der Befehl failed aus, enthält journalctl -u dormice -n 50 den Grund. Ein fehlgeschlagener Start liegt meist an einer Voraussetzung für Swap oder gVisor und nicht am Daemon selbst.

Das Installationsprogramm installiert außerdem Caddy auf dem Host. Prüfen Sie daher zunächst, welche Ports auf dem Host auf Verbindungen warten, bevor Sie die Firewall-Konfiguration als abgeschlossen betrachten.

sudo ss -lntp

Der Daemon bindet immer an 127.0.0.1. Eine Einstellung zum Ändern dieser Adresse gibt es absichtlich nicht. Nur der Port ist änderbar: DORMICE_PORT verwendet standardmäßig 3676. Das daneben laufende Gateway folgt auf 127.0.0.1:3677 derselben Regel. Für den Port wird DORMICE_GATEWAY_PORT verwendet; eine Host-Einstellung gibt es auch dort absichtlich nicht. Der Zugriff von Ihrem Laptop aus muss daher ausdrücklich eingerichtet werden. Die einfache Variante ist ein SSH-Tunnel, der beide Ports weiterleitet.

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

Wenn der Tunnel geöffnet ist, ist http://127.0.0.1:3677/console auf Ihrem Laptop die Webkonsole, die vom Gateway bereitgestellt wird. Beim ersten Aufruf weisen Sie sich durch einmaliges Einfügen des API-Tokens als Betreiber aus. Danach legen Sie einen Benutzernamen und ein Passwort für die Konsole fest. Die Anmeldung setzt ein httpOnly-Session-Cookie, das 7 Tage gültig ist und von JavaScript auf der Seite nicht gelesen werden kann. Die Konsole zeigt das Token später nicht erneut an. Die Connect-Seite gibt Client-Snippets zum Kopieren und Einfügen aus, die bereits auf Ihren eigenen Endpunkt verweisen.

Eine Sandbox erstellen und darin Code ausführen

Mit einem Vorgang wird eine Sandbox erstellt: acquire. Der Vorgang ist idempotent. Derselbe Schlüssel liefert daher immer dieselbe Sandbox. Dabei wird sie bei Bedarf erstellt, aufgeweckt, gestartet oder wiederhergestellt. Jeder andere Verb liefert für einen Schlüssel, den es noch nicht gab, den Status 404. Die dor CLI hat kein acquire-Verb. Ihre erste Sandbox erstellen Sie daher über die Konsole oder eine Clientbibliothek.

Der Weg über die Konsole ist am schnellsten. Öffnen Sie /console über den Tunnel und erstellen Sie eine Sandbox mit dem Namen my-agent. Anschließend arbeitet die CLI damit.

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 listet jede Sandbox mit ihrem Lebenszyklusstatus auf. Damit können Sie beobachten, wie eine Sandbox von active zu frozen wechselt. dor sandbox exec gibt eine Python-3.12-Version aus, weil das Standardimage Ubuntu 24.04 mit bereits installiertem Python 3.12, Node 24, git und ripgrep enthält. Ein Authentifizierungsfehler bedeutet dagegen, dass die kopierte Token-Zeile den Variablennamen enthielt.

Dateien werden mit dor sandbox push my-agent ./script.py übertragen und unter /home/user/script.py abgelegt. dor sandbox pull my-agent notes.txt lädt eine Datei wieder herunter. Die nativen Dateioperationen sind auf 16 MiB pro Datei begrenzt. Die E2B-Dateischnittstelle streamt dagegen die Daten, sodass nur das Festplattenkontingent der Sandbox die Grenze bildet.

Nur das Zerstören einer Sandbox führt zu Datenverlust. dor sandbox destroy my-agent entfernt die Sandbox und ist idempotent. Die zentrale README, der enthaltene Agent-Skill und die README des CLI-Pakets dokumentieren den Vorgang alle unter diesem Namen. Führen Sie dor sandbox --help trotzdem für Ihren eigenen Build aus, weil das Installationsprogramm main verwendet und die CLI fortlaufend erweitert wird.

Ihren vorhandenen E2B-Code auf Ihren eigenen Server ausrichten

Das ist der entscheidende Vorteil. Das offizielle e2b-Paket von npm kommuniziert unverändert mit Dormice. Führen Sie dies bei geöffnetem SSH-Tunnel auf Ihrem Laptop aus. Dadurch lauscht auf dem Server kein zusätzlicher Dienst.

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

Bei einer erfolgreichen Ausführung werden der Exit-Code 0 und 42 ausgegeben. Der API-Schlüssel ist Ihr Dormice-Token mit dem Präfix e2b_. Dieses Format erwartet die Kompatibilitätsschicht.

Die Kompatibilität ist kein Stub. Streaming von stdout und stderr, Hintergrundbefehle, ein interaktives PTY, signierte Upload- und Download-URLs, die Überwachung von Verzeichnissen und ein Port-Proxy werden über das offizielle Paket gegen einen echten Docker- und gVisor-Daemon getestet. Dies geschieht in der End-to-End-Suite des Projekts. Vor einer Migration produktiver Workloads sind einige Abweichungen wichtig:

  • Template-Builds sind nicht implementiert. Ein Template ist ein Docker-Image, das Sie selbst erstellen und mit dor template add registrieren. Sandbox.create('name') löst dieses Image auf. Für einen nicht registrierten Namen wird 404 zurückgegeben, statt ein vorhandenes Template vorzutäuschen.
  • Sandboxes, die über die E2B-Schnittstelle erstellt werden, erhalten echte Deadlines, weil die E2B-Semantik dies voraussetzt. Für Sandboxes, die über die native API erstellt werden, werden niemals Deadlines gesetzt.
  • Eine eingefrorene Sandbox behält ihre Prozesse bei und setzt sie an ihrer bisherigen Ausführungsposition fort. Pause und Resume bedeuten hier daher nicht das Stoppen und den anschließenden Kaltstart, den Sie möglicherweise gewohnt sind.

Was die Sandbox verhindert und was nicht

gVisor fängt die Systemaufrufe des Containers im Userspace ab und verarbeitet sie selbst. Der Sandbox-Code spricht daher nicht direkt mit dem Kernel des Hosts. Innerhalb der Sandbox laufen Befehle als user (uid 1000). Für dieses Konto ist sudo jedoch ohne Passwort möglich. Root innerhalb der Sandbox steht daher jedem Code zur Verfügung, der ihn anfordert. Interpretieren Sie die uid nicht als Schutzmaßnahme: Das Projekt stellt ausdrücklich klar, dass die Sicherheitsgrenze gVisor ist, nicht die uid. Auch eine Sandbox, die ihre Rechte erweitert, kann den Kernel des Hosts weiterhin nicht erreichen. Damit ist der Normalfall abgedeckt: Ein generiertes Script, das rm -rf / ausführt, den Datenträger füllt oder so viele Prozesse erzeugt, bis etwas abstürzt, beschädigt seine eigene Sandbox und bleibt dort.

Das verhindert die Sandbox nicht. Für diese Punkte sind Sie verantwortlich.

  • Eine Sandbox hat funktionierenden ausgehenden Netzwerkverkehr. Generierter Code kann beliebige Inhalte herunterladen und alles, was er findet, versenden. Die Netzwerkschutzmaßnahmen des Installers decken zwei konkrete Punkte ab: Sie verwerfen Containerverkehr zum Cloud-Metadatendienst über 169.254.0.0/16 und über 100.100.100.200, die von Alibaba Cloud verwendete Adresse. Über diesen Dienst stellt eine Cloud Instanzanmeldedaten für alles bereit, was ihn erreichen kann. Außerdem deaktivieren sie den Datenverkehr zwischen Containern mit "icc": false in Docker-daemon.json. Alles andere bleibt erlaubt. Lesen Sie sudo iptables -S DOCKER-USER und ergänzen Sie eigene DROP-Regeln für private Bereiche, die eine Sandbox nicht erreichen darf.
  • Docker fügt eigene Regeln vor Ihrer Firewall ein. Daher kann ein veröffentlichter Container-Port aus dem Internet antworten, obwohl ufw darauf besteht, dass er geschlossen ist. Lesen Sie wie Docker Ports an ufw vorbei veröffentlicht und die Grundlagen der ufw-Firewall für einen VPS, bevor Sie auf diesem Host etwas nach außen öffnen.
  • gVisor ist ein Kernel im Userspace, kein Hypervisor. Das ist eine bewusste Abwägung: Für das Einfrieren müssen Sandboxes Prozesse sein, und eine Voraussetzung von KVM würde verhindern, dass die Software überall installiert werden kann. Wenn Ihr Bedrohungsmodell Hardware-Virtualisierung erfordert, verwenden Sie eine Isolation der Firecracker-Klasse und akzeptieren Sie den damit verbundenen betrieblichen Aufwand.
  • Das API-Token ist auf der Clientseite die gesamte Sicherheitsgrenze. Jeder, der DORMICE_API_TOKEN besitzt, kann jede Sandbox auf dem Rechner erstellen, lesen und löschen. Geben Sie dem Agent-Prozess einen eigenen Benutzer mit den geringsten erforderlichen Rechten auf dem VPS und behandeln Sie das Token wie einen SSH-Key. Die Vorgehensweisen aus Claude Code sicher auf einem VPS ausführen lassen sich direkt übertragen.

Der Daemon selbst läuft als root auf Ihrem Host. gVisor schützt den Host vor dem Code innerhalb einer Sandbox. Den Host vor dem Daemon oder vor Personen, die dessen Token besitzen, schützt jedoch nichts. Der Rechner, auf dem Dormice läuft, sollte daher ausschließlich diese Aufgabe übernehmen. Wenn Ihr Agent außerdem über MCP (model context protocol) auf Tools zugreift, betreiben Sie diese MCP-Server auf einem separaten VPS aus demselben Grund.

Wie viele Sandboxes passen in 4 GB und 8 GB?

Zwei Dinge verbrauchen Speicher: der Grundbedarf des Hosts und der Arbeitssatz jeder Sandbox, die aktuell aktiv ist. Reservieren Sie etwa 1 GB für Ubuntu, Docker und den Daemon. Teilen Sie dann den verbleibenden Speicher durch den tatsächlichen Bedarf einer Sandbox. Eine Sandbox, in der ein Python-Skript einige Dateien liest, benötigt etwa 200 bis 300 MiB. Eine Sandbox, in der ein Compiler oder eine vollständige Testsuite läuft, kann 1 GiB überschreiten.

DiagrammConcurrent sandboxes by host RAM, arithmetic after a 1 GB host reserve
Die Daten hinter diesem Diagramm
[
  {
    "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
  }
]

Ein VPS mit 4 GB hält etwa 6 gleichzeitig aktive Sandboxes, wenn jede 512 MiB verwendet, oder 3, wenn jede ein vollständiges GiB verwendet. Bei einem VPS mit 8 GB sind es 14 und 7. Das sind Obergrenzen für gleichzeitig ausgeführte Arbeiten und keine Benchmarkwerte. Sie ergeben sich aus einer Berechnung. Überwachen Sie daher free -m, während Ihre eigene Last ausgeführt wird.

Eingefrorene Sandboxes werden durch den Swap statt durch den RAM begrenzt. Das ist der zentrale Zweck dieses Designs. Eine eingefrorene Sandbox, die 1 GiB belegt hat, hält ungefähr diese Menge im Swap und fast nichts im Arbeitsspeicher. Die standardmäßige 16-GB-Swapdatei des Installers kann daher etwa 16 solcher Sandboxes aufnehmen. Danach müssen sie in den gestoppten Zustand wechseln, in dem sie nur noch Speicherplatz belegen. Der Speicherplatz ist hier die tatsächliche langfristige Grenze: Jede Sandbox behält ihr Dateisystem. Einige Dutzend Agents, die jeweils ein node_modules-Verzeichnis enthalten, füllen ein kleines Volume lange bevor der Speicherverbrauch relevant wird.

Einfrieren, stoppen, archivieren: die Stellschrauben für den Lebenszyklus

Die Standardwerte sind: nach 10 Minuten Inaktivität einfrieren, nach 3 Tagen stoppen und nach 7 Tagen archivieren, sofern die Archivierung konfiguriert ist. Wenn Sie stopAfterSeconds auf null setzen, erhalten Sie einen residenten Agenten: Er kann bei Inaktivität eingefroren werden und führt niemals einen Kaltstart aus.

Die Archivierung ist optional, und der Daemon verhält sich dabei transparent. Konfigurieren Sie auf der Einstellungsseite der Konsole einen S3-kompatiblen Speicher. Die vier Variablen DORMICE_S3_* sind weiterhin vorhanden, dienen aber nur noch als Ausgangswerte für den ersten Start des Gateways. Die Festplatte einer gestoppten Sandbox wird mit tar und zstd gepackt, in den Bucket übertragen und lokal freigegeben. Der Bucket kann ein von Ihnen selbst gehosteter MinIO-Bucket auf einem anderen Ihrer Rechner sein. Wenn Sie den Speicher nicht konfigurieren, bleiben Sandboxes dauerhaft im Status stopped. Eine Richtlinie, die eine Archivierung anfordert, wird dann abgelehnt und nicht stillschweigend ignoriert. Wiederherstellungen erfolgen sichtbar statt unbemerkt: Der nächste acquire-Aufruf antwortet sofort mit dem Status restoring und einem Fortschrittswert. Sobald die Festplatte wiederhergestellt ist, wechselt der Status zu ready.

Sollten Sie sich jetzt darauf verlassen?

Die klare Antwort lautet: nicht für etwas, das Sie nicht neu erstellen können. Das Repository wurde am 8. Juli 2026 erstellt. Am 12. Oktober 2026 weist es 1,509 Stars, 109 Forks, eine Apache-2.0-Lizenz und überhaupt kein getaggtes Release auf. Die Statuszeile der README sagt selbst, dass nichts davon produktionsbereit ist.

Diese Kombination birgt ein spezifisches Risiko. Der Code kann sich unter Ihnen verändern, weil der Installer main verfolgt. Auch die Schnittstelle ist noch nicht stabil: Die Dokumentation beschreibt inzwischen ein Gateway vor dem Daemon, mit einem eigenen Port, einer eigenen Konfigurationsdatei und einer eigenen Datenbank. Ein Projekt, das etwa drei Monate alt ist, kann außerdem einfach eingestellt werden, da keine Lizenzklausel jemanden zur Weiterentwicklung verpflichtet.

Die E2B-Kompatibilität macht dieses Risiko beherrschbar. Ihre Anwendung kommuniziert mit einem Protokoll, für das es eine gehostete Implementierung gibt. Wenn Dormice ins Stocken gerät, ändern Sie zwei URLs und können weiterarbeiten. Entwickeln Sie Ihren Agenten gegen die E2B-Schnittstelle statt gegen die native API. So bleibt diese Ausweichmöglichkeit erhalten. Das native @dormice/sdk-Paket ist ebenfalls noch nicht auf npm verfügbar. Für seine Verwendung müssen Sie es aus dem Repository bauen. Das ist ein weiterer Grund, zunächst den kompatiblen Pfad zu wählen.

Betreiben Sie es dort, wo Sie einen Verlust verkraften können. Erstellen Sie den Host aus einem Skript neu, halten Sie das Token aus jeder Eingabeaufforderung und jedem Commit heraus und sichern Sie alles, was Sie behalten möchten, nach Ihrem eigenen Backup-Zeitplan aus den Sandboxes.

FAQ

Ist Dormice für den Produktivbetrieb bereit?

Nein. Das Projekt weist selbst darauf hin. Die Statuszeile der README besagt, dass dort noch nichts für den Produktivbetrieb bereit ist. Am 12 October 2026 ist das Repository außerdem etwa drei Monate alt. Es gibt keine Git-Tags und keine Releases. Daher gibt es keine Versionsnummer, auf die Sie festlegen können. Das Installationsprogramm klont den main-Branch. Jeder Durchlauf verwendet daher den neuesten Commit. Notieren Sie git -C /opt/dormice rev-parse HEAD nach jeder Installation. Bewahren Sie eine Kopie der Datenbank-Snapshots auf, die das Installationsprogramm unter /var/lib/dormice/backups/ schreibt. Speichern Sie wichtige Daten außerhalb der Sandboxes.

Worin unterscheidet sich Dormice davon, meinem Agenten eine kurzlebige VM zu geben?

Eine kurzlebige VM ist ein Rechner mit SSH. Sie erstellen ihn für eine Sitzung und löschen ihn anschließend. Dormice ist eine Ausführungs-API: Ihr Programm ruft acquire und danach exec auf und erhält stdout sowie einen Exit-Code zurück. Dazwischen gibt es keine Shell-Sitzung. Eine VM eignet sich für Menschen oder Agenten, die für eine gewisse Zeit einen vollständigen Rechner benötigen. Dormice eignet sich für eine Anwendung, die mehrmals täglich generierten Code ausführt und bei jedem Lauf nicht den Aufwand für Einrichtung und Abbau eines vollständigen Rechners betreiben soll.

Funktioniert das offizielle E2B SDK tatsächlich ohne Codeänderungen?

Ja, mit Konfigurationsänderungen. Setzen Sie apiUrl und sandboxUrl auf Ihrem Daemon auf /e2b/api und /e2b/envd. Übergeben Sie Ihr Dormice-Token mit dem Präfix e2b_ als API-Key. Befehlsausführung, PTY-Sitzungen, Dateiübertragung, signierte URLs und der Port-Proxy werden alle durch die End-to-End-Testsuite des Projekts mit dem offiziellen Paket abgedeckt. Die Erstellung von Templates ist die wesentliche Lücke: e2b template build ist nicht implementiert. Ein Template ist daher ein Docker-Image, das Sie erstellen und mit dor template add registrieren.

Wie viele Sandboxes passen auf eine 4-GB-VPS?

Etwa 6 gleichzeitig aktive Sandboxes, wenn jede Sandbox 512 MiB verwendet. Bei einem vollständigen Gibibyte pro Sandbox sind es 3. Dabei sind ungefähr 1 GB für das Betriebssystem, Docker und den Daemon reserviert. Eingefrorene Sandboxes sind stattdessen durch den Swap begrenzt. Die standardmäßige 16-GB-Swapdatei des Installationsprogramms kann ungefähr 16 Sandboxes aufnehmen, die jeweils ein Gibibyte belegt haben. Messen Sie die Werte unter realer Last mit free -m. Eine Sandbox, die eine Testsuite ausführt, verwendet mehrere Male so viel Speicher wie eine Sandbox, die ein kleines Skript ausführt.

Warum muss bei Dormice vm.swappiness auf 100 gesetzt werden?

Beim Einfrieren einer Sandbox wird ihr nicht verwendeter Speicher in den Swap ausgelagert. gVisor hält den Sandbox-Speicher als Shared Memory. Der Linux-Kernel lagert Shared Memory beim standardmäßigen Swappiness-Wert nicht aus. Beim Standardwert gibt ein Freeze daher keinen Speicher frei, und die Sandbox benötigt weiterhin die vollständige Speichermenge. Das Projekt hat beim Standardwert 0 Bytes freigegebenen Speicher gemessen, bei einem Wert von 100 dagegen 99,5 Prozent. Prüfen Sie den effektiven Wert mit sysctl vm.swappiness, statt Konfigurationsdateien zu lesen. Einige Cloud-Images liefern den Wert 0 aus.

War dieser Artikel hilfreich?