DEV Community

Cover image for Was sind Docker Sandboxes? So isoliert Docker KI-Coding-Agenten
Emre Demir
Emre Demir

Posted on Originally published at apidog.com

Was sind Docker Sandboxes? So isoliert Docker KI-Coding-Agenten

Kurzantwort: Docker Sandboxes führen KI-Programmieragenten wie Claude Code, Codex und Cursor in isolierten MicroVMs aus – auf Ihrem Rechner oder in Dockers Cloud. Jede Sandbox verfügt über einen eigenen Kernel, ein eigenes Dateisystem, Netzwerk und eine private Docker Engine. Sie steuern sie über die kostenlose sbx-CLI, und der Agent erreicht nur die Ordner und Domains, die Sie freigeben.

Testen Sie Apidog noch heute

Am 19. November 2026 hat Docker seine Marke unter einer Kernaussage neu positioniert: „Containers isolate workloads. But agents aren't workloads. Agents are actors.“ Der Rebranding-Beitrag verrät wenig über das Produkt selbst. Er verweist Leser auf Docker Sandboxes und Docker AI Governance, daher trägt dieser Leitfaden die Fakten aus Dockers Dokumentation zusammen.

Was sind Docker Sandboxes?

Docker Sandboxes sind isolierte MicroVM-Umgebungen, die für die Ausführung autonomer KI-Programmieragenten konzipiert sind. Jede Sandbox erhält einen eigenen Kernel, einen eigenen Docker-Daemon, ein eigenes Dateisystem und Netzwerk. Im Inneren verfügt der Agent über vollständige Rechte, einschließlich sudo. Von außen sieht er nur den Arbeitsbereich, den Sie freigeben, und die Netzwerkziele, die Ihre Richtlinie erlaubt.

Sie verwalten Sandboxes über die sbx-CLI, die weder Docker Desktop noch Docker Engine benötigt. Dieselbe CLI führt lokale Sandboxes auf Ihrem Laptop und Cloud-Sandboxes auf von Docker verwalteter Rechenleistung aus, und sbx move überträgt das Dateisystem einer Sandbox zwischen den beiden.

Dockers Architekturseite vergleicht den Ansatz mit den üblichen Alternativen:

Ansatz Isolation Docker-Zugriff Am besten für
Docker Sandboxes (MicroVMs) Vollständig (Hypervisor) Isolierter Daemon Autonome Agenten
Container mit Socket-Mount Teilweise (Namespaces) Gemeinsamer Host-Daemon Vertrauenswürdige Tools
Docker-in-Docker Teilweise (privilegiert) Verschachtelter Daemon CI/CD-Pipelines
Host-Ausführung Keine Host-Daemon Manuelle Entwicklung

Der Kompromiss lautet Ressourcen gegen Sicherheit: Jede Sandbox betreibt eine VM samt eigenem Daemon, und Sandboxes teilen keine Images.

Wie Docker Sandboxes einen KI-Agenten isolieren

Die MicroVM ist die zentrale Vertrauensgrenze. Dockers Sicherheitsmodell nennt fünf Ebenen:

  1. Hypervisor-Isolation. Jede Sandbox hat einen eigenen Kernel, ohne gemeinsamen Speicher oder gemeinsame Prozesse mit dem Host.
  2. Netzwerkisolation. Ausgehendes TCP läuft über einen Proxy auf Ihrem Host unter einer Deny-by-Default-Richtlinie. UDP und ICMP werden standardmäßig blockiert.
  3. Docker-Engine-Isolation. Die Container des Agenten laufen auf einer privaten Engine ohne Weg zum Host-Daemon.
  4. Arbeitsbereichs-Isolation. Sie entscheiden, was der Agent sieht: nichts, ein schreibgeschütztes Repo mit einem privaten Klon oder Ihren Arbeitsbaum mit Lese-/Schreibzugriff.
  5. Anmeldedaten-Isolation. API-Schlüssel gelangen nie in die VM. Der Agent sieht einen Platzhalterwert, und der Host-Proxy tauscht die echten Anmeldedaten ein, nachdem die Anfrage die Sandbox verlassen hat.

Diagramm einer Docker Sandbox: der Agent und seine private Docker Engine in einer MicroVM, wobei nur der Arbeitsbereich-Mount, der Host-Netzwerkproxy und das MCP-Gateway die Grenze zum Host überschreiten

Ein per Prompt-Injection manipulierter Agent kann einen Schlüssel nicht ausgeben, den er nie hatte. Er kann diesen Schlüssel jedoch weiterhin über erlaubte Anfragen nutzen, daher ist die Netzwerkrichtlinie ebenso wichtig wie der Trick mit den Anmeldedaten.

Docker ist auch klar darüber, was die Isolation nicht abdeckt. Im Direktmodus bearbeitet der Agent Ihre echten Dateien, einschließlich Git-Hooks, CI-Konfiguration und package.json-Skripten, die später auf Ihrem Host ausgeführt werden. Git-Hooks tauchen nicht in git diff auf, prüfen Sie sie daher separat.

Welche Agenten Docker Sandboxes unterstützt

Die Agenten-Seite listet für lokale Sandboxes die folgenden auf:

  • Claude Code
  • Codex
  • Copilot
  • Cursor
  • Devin
  • Docker Agent
  • Droid
  • Kiro
  • OpenCode
  • Shell, eine agentenlose Sandbox für manuelle Einrichtung

Jeder Agent startet aus einem Template-Image. Codex verwendet docker/sandbox-templates:codex, und sein Standard-Startbefehl ist codex --dangerously-bypass-approvals-and-sandbox. Dockers Begründung: MicroVM, Netzwerkrichtlinie und Anmeldedaten-Isolation übernehmen bereits das, wovor Genehmigungsabfragen schützen sollen. Sie können die Genehmigungen innerhalb der Sitzung wieder aktivieren.

Ein Einrichtungsdetail überrascht viele. Sandboxes importieren keine benutzerspezifische Konfiguration wie ~/.claude oder ~/.codex, sondern nur projektbezogene Konfiguration im Arbeitsverzeichnis.

So richten Sie Docker Sandboxes ein

Lokale Sandboxes benötigen laut Installationsanleitung einen dieser Hosts:

Betriebssystem Anforderungen Installationsbefehl
macOS Sonoma 14 oder neuer, Apple Silicon brew trust docker/tap && brew install docker/tap/sbx
Windows Windows 11, 64-Bit Intel oder AMD, Windows Hypervisor Platform aktiviert winget install -h Docker.sbx
Linux Ubuntu 24.04 oder neuer, KVM aktiviert, Benutzer in der Gruppe kvm Dockers Komfortskript mit SBX=1 (siehe unten)

Unter Ubuntu lautet das curl -fsSL https://get.docker.com | sudo SBX=1 sh. Folgen Sie dann der Erste-Schritte-Anleitung:

  1. Anmelden mit sbx login. Docker verknüpft jede Sandbox mit einer verifizierten Docker-Identität.
  2. Anmeldedaten auf dem Host speichern. Für Codex führt sbx secret set openai --oauth den OAuth-Flow in Ihrem Browser aus und speichert die Tokens im Schlüsselbund Ihres Betriebssystems.
  3. Ein Netzwerk-Preset wählen. sbx policy init balanced erlaubt typischen Entwicklungsverkehr, einschließlich KI-Diensten und Paket-Registries. Die anderen Optionen sind deny-all und allow-all.
  4. Einen Agenten ausführen aus Ihrem Projektordner:
cd ~/my-project
sbx run --name my-sandbox claude   # or: sbx run codex
Enter fullscreen mode Exit fullscreen mode
  1. Beobachten. sbx ls zeigt Agent, Status und Arbeitsbereich jeder Sandbox. Ein einfaches sbx öffnet ein Live-Dashboard.
  2. Aufräumen. sbx stop my-sandbox behält Pakete und Images für das nächste Mal. sbx rm my-sandbox löscht alles darin; Ihr Arbeitsbaum auf dem Host bleibt unberührt.

Netzwerk- und Dateisystem-Richtlinie

Die Netzwerkrichtlinie entscheidet, wohin der Agent gelangen darf. Listen Sie die Regeln auf und öffnen Sie nur, was die Aufgabe benötigt:

sbx policy ls
sbx policy allow network registry.npmjs.org
sbx policy check network api.anthropic.com
Enter fullscreen mode Exit fullscreen mode

sbx policy check antwortet mit Allowed oder Denied aus der aktiven Richtlinie, sodass Sie eine Grenze bestätigen können, bevor der Agent startet. Docker warnt, dass die standardmäßige Allow-List breite Wildcards wie *.googleapis.com enthält. Beschneiden Sie, was Sie nicht benötigen.

Die Dateisystem-Freigabe wird beim Erstellen der Sandbox festgelegt:

  • Direkt-Mount (Standard bei sbx run): Ihr Projektordner erscheint unter demselben absoluten Pfad mit Lese-/Schreibzugriff.
  • Klon-Modus (--clone): Ihr Repo wird schreibgeschützt eingebunden, und der Agent arbeitet an einem privaten Klon. Gut für mehrere Agenten an einem Repo.
  • Ohne Mount (sbx create ohne Pfad): Nichts von Ihrem Host wird geteilt.

Für reproduzierbare Team-Setups bündelt ein Kit die Tools, Anmeldedaten, Netzwerkregeln und Konfiguration eines Agenten in einer einzigen YAML-Datei.

Docker Sandboxes Preise

Dockers FAQ besagt, dass die sbx-CLI und lokale Sandbox-Rechenleistung kostenlos sind, auch für kommerzielle Arbeit. Kosten des Modellanbieters fallen separat an.

Cloud-Sandboxes erfordern ein Abonnement der Docker Agentic Platform und werden sekundengenau abgerechnet. Die Produktseite von Docker Sandboxes listete am 20. November 2026 diese Tarife auf:

Größe vCPUs Arbeitsspeicher Pro Stunde
Micro 1 2 GB 0,07 $
Small 2 4 GB 0,14 $
Medium 4 8 GB 0,28 $
Large 8 16 GB 0,56 $
XL 16 32 GB 1,12 $

Cloud-Sandboxes laufen standardmäßig nach einer Stunde ab und können keinen Host-Ordner einbinden. Organisations-Governance ist ein separates kostenpflichtiges Abonnement, das über Docker Sales vertrieben wird.

Docker AI Governance und das MCP Enterprise Gateway

Docker AI Governance ist die Team-Ebene über den Sandboxes. Dockers Beitrag vom 18. November unterteilt sie in drei Teile:

  • Sandbox-Richtlinien: Domains, IP-Bereiche und Ports erlauben oder blockieren und steuern, welche Host-Pfade eingebunden werden können. Die Durchsetzung erfolgt auf den Proxy- und Mount-Ebenen, nicht im Agenten.
  • MCP-Tool-Governance: Administratoren entscheiden, welche MCP-Server registriert werden dürfen und welche Tool-Aufrufe Agenten tätigen dürfen. Richtlinien werden in Cedar geschrieben, und verwaltete Anfragen werden abgelehnt, sofern keine Richtlinie sie erlaubt.
  • Audit und Sichtbarkeit: ein Protokoll jeder Richtlinienentscheidung (Prinzipal, Aktion, Ziel, Entscheidung, Zeit), das in ein SIEM eingespeist werden kann. Die Einträge enthalten Metadaten, keine Prompts.

Hier ist das Cedar-Beispiel aus diesem Beitrag, das schreibgeschützte Tool-Aufrufe auf einem Server erlaubt:

permit (principal, action == MCP::Action::"invokeTool", resource)
when {
  resource in MCP::Server::"example" &&
  resource.readOnly == true
};
Enter fullscreen mode Exit fullscreen mode

Wenn Organisations-Governance aktiviert ist, zählen lokale sbx policy-Allow-Regeln nicht mehr; lokale Deny-Regeln gelten weiterhin.

Diagramm von Docker AI Governance: eine Admin-Konsole überträgt Sandbox-Netzwerk- und Dateisystem-Richtlinien, MCP-Tool-Richtlinien und Audit-Logging an die lokalen Sandboxes jedes Entwicklers

Der MCP-Teil kommt in zwei Größen. Jede Sandbox hat ein lokales MCP-Gateway: Registrieren Sie einen Server einmal mit sbx mcp add notion --url https://mcp.notion.com/mcp und legen Sie ihn dann für eine Sandbox mit --static-mcp notion offen. Lokale stdio-Server laufen auf dem Host, nicht in der VM, behandeln Sie sie daher als vertrauenswürdigen Host-Code. Für Organisationen verkauft Docker das MCP Enterprise Gateway, das Server genehmigt, Tools auf Gruppen beschränkt und jeden Aufruf protokolliert.

Eine Grenze gilt es zu bedenken: Ein Agent, der einen entfernten MCP-Server direkt aus einer Sandbox heraus aufruft, unterliegt der Netzwerkrichtlinie, nicht der MCP-Richtlinie.

Testen Sie eine API von innerhalb einer Docker Sandbox mit der Apidog CLI

Eine Sandbox ermöglicht es Ihrem Agenten, Code ohne Risiko für Ihren Laptop zu ändern. Er muss jedoch noch nachweisen, dass die Änderung gegen eine echte API funktioniert. Die Apidog CLI stellt ihm Befehle für Testfälle und Testläufe mit lesbarer JSON-Ausgabe bereit.

Prüfen Sie, ob die Sandbox Apidog und Ihre API erreichen kann, und erlauben Sie sie, falls sie abgelehnt werden:

sbx policy check network api.apidog.com
sbx policy allow network api.apidog.com
sbx policy allow network api.example.com
Enter fullscreen mode Exit fullscreen mode

Installieren Sie dann und melden Sie sich in der Sandbox an:

sbx exec -it my-sandbox bash
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Enter fullscreen mode Exit fullscreen mode

Apidog ist keiner der Dienste, die sbx secret set einfügt, daher lebt dieses Token in der VM. Verwenden Sie eines, das Sie widerrufen können, und führen Sie sbx rm für die Sandbox aus, wenn Sie fertig sind.

Geben Sie Ihrem Agenten einen Prompt:

Using Apidog CLI, create a test case in project <projectId> for
POST /orders on endpoint <endpointId> that asserts a 201 status and an
"id" field in the body. Run it against environment <envId> and
summarize any failures.
Enter fullscreen mode Exit fullscreen mode

Der Agent liest das Payload-Schema, validiert seine Datei und führt den Testfall aus:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog test-case run --project <projectId> --endpoint <endpointId> -e <envId> -r cli,json
Enter fullscreen mode Exit fullscreen mode

Ein Netzwerkfehler bedeutet meist, dass die Allow-List einen Host verpasst hat: Die Sandbox tut ihre Arbeit. Zur agentenspezifischen Einrichtung lesen Sie Apidog CLI in Claude Code oder Apidog CLI in Codex und ersetzen Sie -r cli,json durch -r junit in einer CI-Pipeline. Der Free-Tarif von Apidog deckt bis zu 4 Benutzer ab.

Sie möchten Codex lieber auf Ihrem Host behalten? Unser Leitfaden zur Codex-Sandbox behandelt diesen Weg, und CubeSandbox ist eine weitere Isolationsoption, die für Agenten entwickelt wurde.

FAQ

Sind Docker Sandboxes einfach Container? Nein. Es sind MicroVMs mit einem separaten Kernel pro Sandbox. Jede betreibt eine eigene Docker Engine, sodass der Agent Container bauen kann, ohne Ihren Host-Daemon zu berühren.

Sind Docker Sandboxes kostenlos? Die sbx-CLI und lokale Rechenleistung sind kostenlos, auch für kommerzielle Arbeit. Cloud-Sandboxes beginnen bei 0,07 $ pro Stunde, Modellkosten fallen separat an, und Organisations-Governance kostet extra.

Brauche ich Docker Desktop? Nein. Die sbx-CLI lässt sich eigenständig über Homebrew, WinGet oder Dockers Ubuntu-Pakete installieren.

Kann der Agent meine API-Schlüssel sehen? Nicht bei Diensten, die sbx verwaltet, wie OpenAI, Anthropic und GitHub. Der Host-Proxy fügt diese Anmeldedaten ein, und die Rohwerte gelangen nie in die VM. Alles, was Sie selbst in der Sandbox installieren, lebt dort.

Warum läuft Codex in einer Sandbox ohne Genehmigungen? sbx run codex startet standardmäßig codex --dangerously-bypass-approvals-and-sandbox, weil die MicroVM die Sicherheitsgrenze ist. Sie können die Genehmigungsabfragen innerhalb der Sitzung wieder aktivieren.

Top comments (0)