DEV Community

Cover image for Docker Sandbox Nedir? Docker, Yapay Zeka Kodlama Ajanlarını Nasıl İzole Ediyor?
Tobias Hoffmann
Tobias Hoffmann

Posted on Originally published at apidog.com

Docker Sandbox Nedir? Docker, Yapay Zeka Kodlama Ajanlarını Nasıl İzole Ediyor?

Kısa yanıt: Docker Sandboxes, Claude Code, Codex ve Cursor gibi yapay zeka kodlama ajanlarını, kendi makinenizde veya Docker'ın bulutunda izole microVM'ler içinde çalıştırır. Her sandbox'ın kendi çekirdeği, dosya sistemi, ağı ve özel Docker Engine'i vardır. Sandbox'ı ücretsiz sbx CLI ile yönetirsiniz ve ajan yalnızca izin verdiğiniz klasörlere ve alan adlarına erişebilir.

Apidog'u bugün deneyin

19 Kasım 2026'da Docker, markasını tek bir cümle etrafında yeniden konumlandırdı: "Konteynerler iş yüklerini izole eder. Ama ajanlar iş yükü değildir. Ajanlar aktördür." Yeniden markalama yazısı ürünün kendisi hakkında pek az şey söylüyor. Okuyucuları Docker Sandboxes ve Docker AI Governance'a yönlendiriyor; bu nedenle bu rehber, gerçekleri doğrudan Docker'ın dokümanlarından derliyor.

Docker Sandboxes nedir?

Docker Sandboxes, otonom yapay zeka kodlama ajanlarını çalıştırmak için tasarlanmış izole microVM ortamlarıdır. Her sandbox kendi çekirdeğine, Docker daemon'ına, dosya sistemine ve ağına sahiptir. İçeride ajan, sudo dahil tam yetkilere sahiptir. Dışarıda ise yalnızca paylaştığınız çalışma alanını ve politikanızın izin verdiği ağ hedeflerini görür.

Sandbox'ları, Docker Desktop veya Docker Engine gerektirmeyen sbx CLI ile yönetirsiniz. Aynı CLI, dizüstü bilgisayarınızdaki yerel sandbox'ları ve Docker tarafından yönetilen işlem gücündeki bulut sandbox'larını çalıştırır ve sbx move komutu bir sandbox'ın dosya sistemini ikisi arasında taşır.

Docker'ın mimari sayfası bu yaklaşımı olağan alternatiflerle karşılaştırır:

Yaklaşım İzolasyon Docker erişimi En uygun olduğu durum
Docker Sandboxes (microVM'ler) Tam (hipervizör) İzole daemon Otonom ajanlar
Socket bağlanmış konteyner Kısmi (namespace'ler) Paylaşılan ana makine daemon'ı Güvenilen araçlar
Docker-in-Docker Kısmi (ayrıcalıklı) İç içe daemon CI/CD süreçleri
Ana makinede çalıştırma Yok Ana makine daemon'ı Manuel geliştirme

Buradaki takas, güvenlik karşılığında kaynaklardır: her sandbox bir VM ve kendi daemon'ını çalıştırır ve sandbox'lar imajları paylaşmaz.

Docker Sandboxes bir yapay zeka ajanını nasıl izole eder?

Ana güven sınırı microVM'dir. Docker'ın güvenlik modeli beş katman sıralar:

  1. Hipervizör izolasyonu. Her sandbox'ın ayrı bir çekirdeği vardır; ana makineyle paylaşılan belleği veya süreci yoktur.
  2. Ağ izolasyonu. Giden TCP trafiği, ana makinenizde varsayılan olarak reddeden bir politika altındaki proxy üzerinden geçer. UDP ve ICMP varsayılan olarak engellenir.
  3. Docker Engine izolasyonu. Ajanın konteynerleri, ana makine daemon'ınıza hiçbir yolu olmayan özel bir engine üzerinde çalışır.
  4. Çalışma alanı izolasyonu. Ajanın neyi göreceğini siz seçersiniz: hiçbir şey, özel bir kopya ile salt okunur bir depo veya çalışma ağacınızın okuma-yazma erişimi.
  5. Kimlik bilgisi izolasyonu. API anahtarları asla VM'e girmez. Ajan bir sentinel değer görür ve istek sandbox'tan çıktıktan sonra ana makine proxy'si gerçek kimlik bilgisini yerine koyar.

Docker Sandbox diyagramı: microVM içindeki ajan ve özel Docker Engine'i, sınırı ana makineye geçen yalnızca çalışma alanı bağlantısı, ana makine ağ proxy'si ve MCP geçidi ile

Prompt enjeksiyonuna uğramış bir ajan, hiç sahip olmadığı bir anahtarı yazdıramaz. Yine de bu anahtarı izin verilen istekler aracılığıyla kullanabilir; bu nedenle ağ politikası, kimlik bilgisi hilesi kadar önemlidir.

Docker ayrıca izolasyonun neleri kapsamadığı konusunda da nettir. Doğrudan modda ajan, gerçek dosyalarınızı düzenler; buna daha sonra ana makinenizde çalışacak Git hook'ları, CI yapılandırması ve package.json betikleri de dahildir. Git hook'ları git diff çıktısında görünmez, bu nedenle bunları ayrıca kontrol edin.

Docker Sandboxes hangi ajanları destekler?

Ajanlar sayfası yerel sandbox'lar için şunları listeler:

  • Claude Code
  • Codex
  • Copilot
  • Cursor
  • Devin
  • Docker Agent
  • Droid
  • Kiro
  • OpenCode
  • Shell, manuel kurulum için ajansız bir sandbox

Her ajan bir şablon imajından başlar. Codex, docker/sandbox-templates:codex imajını kullanır ve varsayılan başlangıç komutu codex --dangerously-bypass-approvals-and-sandbox'tır. Docker'ın gerekçesi şudur: microVM, ağ politikası ve kimlik bilgisi izolasyonu, onay istemlerinin koruduğu şeyleri zaten ele alır. Oturum içinde onayları tekrar açabilirsiniz.

Bir kurulum detayı insanların kafasını karıştırıyor. Sandbox'lar ~/.claude veya ~/.codex gibi kullanıcı düzeyindeki yapılandırmayı içeri aktarmaz; yalnızca çalışma dizinindeki proje düzeyindeki yapılandırmayı alır.

Docker Sandboxes nasıl kurulur?

Yerel sandbox'lar, kurulum rehberine göre aşağıdaki ana makinelerden birini gerektirir:

İşletim Sistemi Gereksinimler Kurulum komutu
macOS Sonoma 14 veya üzeri, Apple silicon brew trust docker/tap && brew install docker/tap/sbx
Windows Windows 11, 64-bit Intel veya AMD, Windows Hypervisor Platform açık winget install -h Docker.sbx
Linux Ubuntu 24.04 veya üzeri, KVM açık, kullanıcı kvm grubunda Docker'ın SBX=1 ile kolaylık betiği (aşağıda)

Ubuntu'da bu komut şudur: curl -fsSL https://get.docker.com | sudo SBX=1 sh. Ardından başlarken rehberini izleyin:

  1. sbx login ile oturum açın. Docker her sandbox'ı doğrulanmış bir Docker kimliğine bağlar.
  2. Kimlik bilgilerini ana makinede saklayın. Codex için sbx secret set openai --oauth tarayıcınızda OAuth akışını başlatır ve belirteçleri işletim sisteminizin anahtar zincirinde tutar.
  3. Bir ağ ön ayarı seçin. sbx policy init balanced yapay zeka servisleri ve paket kayıt defterleri dahil tipik geliştirme trafiğine izin verir. Diğer seçenekler deny-all ve allow-all'dır.
  4. Proje klasörünüzden bir ajan çalıştırın:
cd ~/my-project
sbx run --name my-sandbox claude   # or: sbx run codex
Enter fullscreen mode Exit fullscreen mode
  1. İzleyin. sbx ls her sandbox'ın ajanını, durumunu ve çalışma alanını gösterir. Düz sbx komutu canlı bir kontrol paneli açar.
  2. Temizlik yapın. sbx stop my-sandbox paketleri ve imajları bir sonraki sefer için saklar. sbx rm my-sandbox içindeki her şeyi siler; ana makinenizdeki çalışma ağacı yerinde kalır.

Ağ ve dosya sistemi politikası

Ağ politikası, ajanın nereye gidebileceğini belirler. Kuralları listeleyin, ardından yalnızca görevin ihtiyaç duyduğu yerleri açın:

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 etkin politikadan Allowed veya Denied yanıtı verir; böylece ajan başlamadan önce bir sınırı doğrulayabilirsiniz. Docker, varsayılan izin listesinin *.googleapis.com gibi geniş joker karakterler içerdiği konusunda uyarır. İhtiyacınız olmayanları ayıklayın.

Dosya sistemi erişimi, sandbox'ı oluşturduğunuzda ayarlanır:

  • Doğrudan bağlama (sbx run varsayılanı): proje klasörünüz aynı mutlak yolda, okuma-yazma olarak görünür.
  • Kopyalama modu (--clone): deponuz salt okunur olarak bağlanır ve ajan özel bir kopya üzerinde çalışır. Tek bir depo üzerinde birden çok ajan için idealdir.
  • Bağlantısız (yol belirtmeden sbx create): ana makinenizden hiçbir şey paylaşılmaz.

Tekrarlanabilir ekip kurulumları için bir kit, ajanın araçlarını, kimlik bilgilerini, ağ kurallarını ve yapılandırmasını tek bir YAML dosyasında bir araya getirir.

Docker Sandboxes fiyatlandırması

Docker'ın SSS sayfası, sbx CLI'nin ve yerel sandbox işlem gücünün ticari çalışmalar dahil ücretsiz olduğunu söyler. Model sağlayıcı ücretleri bunun dışındadır.

Bulut sandbox'ları bir Docker Agentic Platform aboneliği gerektirir ve saniye bazında ücretlendirilir. Docker Sandboxes ürün sayfası 20 Kasım 2026'da bu fiyatları listeliyordu:

Boyut vCPU Bellek Saat başına
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

Bulut sandbox'ları varsayılan olarak bir saat sonra sona erer ve ana makine klasörünü bağlayamaz. Kuruluş yönetişimi, Docker Satış aracılığıyla satılan ayrı bir ücretli aboneliktir.

Docker AI Governance ve MCP Enterprise Gateway

Docker AI Governance, sandbox'ların üzerindeki ekip katmanıdır. Docker'ın 18 Kasım yazısı bunu üç bölüme ayırır:

  • Sandbox politikaları: alan adlarını, IP aralıklarını ve bağlantı noktalarını izin verin veya engelleyin ve hangi ana makine yollarının bağlanabileceğini kontrol edin. Uygulama, ajan içinde değil, proxy ve bağlama katmanlarında gerçekleşir.
  • MCP araç yönetişimi: yöneticiler hangi MCP sunucularının kaydedilebileceğine ve ajanların hangi araç çağrılarını yapabileceğine karar verir. Politikalar Cedar ile yazılır ve yönetilen istekler, bir politika izin vermediği sürece reddedilir.
  • Denetim ve görünürlük: her politika kararının (asıl, eylem, hedef, karar, zaman) bir SIEM'e aktarılabilecek kaydı. Kayıtlar promptları değil, üst verileri tutar.

İşte o yazıdan, tek bir sunucuda salt okunur araç çağrılarına izin veren Cedar örneği:

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

Kuruluş yönetişimi açık olduğunda, yerel sbx policy izin kuralları dikkate alınmaz; yerel ret kuralları hâlâ geçerlidir.

Docker AI Governance diyagramı: bir yönetici konsolu, sandbox ağ ve dosya sistemi politikalarını, MCP araç politikalarını ve denetim günlüğünü her geliştiricinin yerel sandbox'larına aktarır

MCP kısmı iki boyutta gelir. Her sandbox'ın yerel bir MCP geçidi vardır: bir sunucuyu sbx mcp add notion --url https://mcp.notion.com/mcp ile bir kez kaydedin, ardından --static-mcp notion ile tek bir sandbox'a açın. Yerel stdio sunucuları VM'de değil ana makinede çalışır; bu nedenle onları güvenilen ana makine kodu olarak değerlendirin. Kuruluşlar için Docker, sunucuları onaylayan, araçları gruplara sınırlayan ve her çağrıyı günlüğe kaydeden MCP Enterprise Gateway'i satıyor.

Hatırlanması gereken bir sınır: bir sandbox'ın içinden uzak bir MCP sunucusunu doğrudan çağıran bir ajan, MCP politikasına değil ağ politikasına tabidir.

Apidog CLI ile Docker Sandbox içinden bir API test edin

Sandbox, ajanınızın dizüstü bilgisayarınıza risk oluşturmadan kodu değiştirmesini sağlar. Yine de ajanın değişikliğin gerçek bir API'ye karşı çalıştığını kanıtlaması gerekir. Apidog CLI ona test senaryoları ve çalıştırmalar için komutlar sunar; okuyabileceği JSON çıktısı verir.

Sandbox'ın Apidog'a ve API'nize erişebildiğini kontrol edin, reddediliyorsa izin verin:

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

Ardından sandbox içinde kurun ve oturum açın:

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, sbx secret set komutunun enjekte ettiği servislerden biri değildir; bu nedenle bu belirteç VM içinde yaşar. İptal edebileceğiniz bir belirteç kullanın ve işiniz bittiğinde sandbox'ı sbx rm ile silin.

Ajanınıza tek bir komut verin:

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

Ajan yük şemasını okur, dosyasını doğrular ve senaryoyu çalıştırır:

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

Bir ağ hatası genellikle izin listesinin bir ana makineyi kaçırdığı anlamına gelir: sandbox görevini yapıyor demektir. Ajana özgü kurulum için Claude Code'da Apidog CLI veya Codex'te Apidog CLI yazılarına bakın ve bir CI sürecinde -r cli,json yerine -r junit kullanın. Apidog'un Free planı 4 kullanıcıya kadar kapsar.

Codex'i ana makinenizde tutmayı mı tercih ediyorsunuz? Codex sandbox rehberimiz bu yolu ele alıyor ve CubeSandbox ajanlar için geliştirilmiş başka bir izolasyon seçeneğidir.

SSS

Docker Sandboxes sadece konteyner mi? Hayır. Sandbox başına ayrı çekirdeğe sahip microVM'lerdir. Her biri kendi Docker Engine'ini çalıştırır, böylece ajan ana makine daemon'ınıza dokunmadan konteyner oluşturabilir.

Docker Sandboxes ücretsiz mi? sbx CLI ve yerel işlem gücü ticari çalışmalar dahil ücretsizdir. Bulut sandbox'ları saat başına $0.07'den başlar, model ücretleri ayrıdır ve kuruluş yönetişimi ek ücrete tabidir.

Docker Desktop'a ihtiyacım var mı? Hayır. sbx CLI kendi başına Homebrew, WinGet veya Docker'ın Ubuntu paketleri üzerinden kurulur.

Ajan API anahtarlarımı görebilir mi? OpenAI, Anthropic ve GitHub gibi sbx tarafından yönetilen servisler için göremez. Ana makine proxy'si bu kimlik bilgilerini enjekte eder ve ham değerler VM'e asla girmez. Sandbox içinde kendiniz kurduğunuz her şey ise orada yaşar.

Codex neden bir sandbox içinde onaylar kapalı çalışıyor? sbx run codex varsayılan olarak codex --dangerously-bypass-approvals-and-sandbox'ı başlatır çünkü güvenlik sınırı microVM'dir. Oturum içinde onay istemlerini tekrar açabilirsiniz.

Top comments (0)