SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor · Güncellendi 2026-10-23

Kendi sunucunuzda Dormice ile agent sandbox kurulumu

Dormice kullanarak kendi Linux VPS sunucunuzda E2B uyumlu izole agent sandbox ortamları oluşturun. Güvenli kod yürütme, izolasyon denetimi ve kaynak yönetimi detaylarını inceleyin.

Dormice nedir ve ne değildir

Dormice, self-hosted bir agent sandbox'ıdır: sahip olduğunuz bir Linux VPS üzerinde çalışan ve agent kodunuzun güvenilmeyen kodları izole bir container içinde çalıştırmak için HTTP üzerinden çağrı yaptığı bir daemon'dır. Programınız isimle bir sandbox talep eder, hangi durumda olursa olsun aynı sandbox'ı geri alır, içinde bir komut çalıştırır ve çıktısını okur. Sandbox, giriş yaptığınız bir makine değil, programatik bir kaynaktır.

Bu, bir agent'a tüm bir bilgisayarı vermekten farklı bir yapıdır. Kodlama agent'ı için tek kullanımlık VM, SSH ile bağlandığınız, agent'ın bozmasına izin verdiğiniz ve sonra sildiğiniz bir kutudur. Dormice bir seviye altta yer alır: elinizde zaten kod olduğunda ve onu çalıştırmak için güvenli bir yere ihtiyaç duyduğunuzda programınızın çağırdığı yürütme API'sidir. İş birimi tüm bir makine olduğunda tek kullanımlık VM kullanın. İş birimi tek bir exec çağrısı olduğunda ve günde yüz tane VM yerine yüz tane çağrı yapmak istediğinizde Dormice kullanın.

Proje kendini E2B uyumlu olarak tanımlar. E2B, birçok agent framework'ünün halihazırda istemci kütüphanesini içe aktardığı barındırılan bir sandbox servisidir. Dormice, aynı protokolü kendi URL önekleri altında sunar; bu sayede resmi e2b paketiyle yazılmış bir uygulama, kendi sunucunuza yönlendirdiğinizde çalışmaya devam eder. Uygulama kodunda değişiklik gerekmez. Sadece iki URL ve bir API anahtarı öneki değişir.

"Ajan sandbox'larının SQLite'ı" ifadesi pratikte ne anlama gelir

SQLite, yönetmeniz gereken bir servis yerine içine gömdüğünüz bir veritabanıdır; Dormice de bu benzetmeyi doğrudan ödünç alır. Makine başına bir daemon, kayıt defteri için bir SQLite dosyası, bir TCP portu ve yanında web konsolunu sunan küçük bir ağ geçidi. Kubernetes yok, harici veritabanı sunucusu yok. Daemon, kayıt defterinin yanında özel bir kilit tutar; bu sayede aynı makinedeki ikinci bir daemon, durumu sessizce bölmek yerine başlamayı reddeder. Her sandbox, oluşturulduğu makinede yaşar. README dosyası artık bir filoyu, bir ağ geçidi ve onun özel ağındaki makineler olarak tanımlıyor; ancak yine de sandbox'ların makineler arasında taşınması veya bölgeler arası bir filo gerekirse başka bir çözüm seçmeniz gerektiğini belirtiyor ve bunu dikkate almalısınız.

Fikrin ikinci yarısı maliyetle ilgilidir. Barındırılan (hosted) bir sandbox, var olduğu her saniye için ücretlendirilir; bu nedenle barındırılan sandbox'lar tasarım gereği atılabilir niteliktedir. Dormice, zaten ödemesini yaptığınız donanım üzerinde çalışır; bu yüzden sandbox'ları kalıcıdır ve hareketsiz kaldıkları süre uzadıkça maliyetleri düşer. Bir sandbox her seferinde bir basamak soğur: aktif, dondurulmuş, durdurulmuş ve arşivlenmiş. Herhangi bir edinme (acquire) işlemi, onu ulaştığı basamaktan tekrar yukarı çeker.

Dondurma (freezing) işlemi, her ajanın sandbox'ını sonsuza kadar tutmayı ekonomik kılan şey olduğu için anlaşılması gereken kısımdır. Bunlar, projenin kendi donanımı üzerinde ölçülen ve sizinkinde değil, yayınlanmış rakamlardır.

GrafikOne idle sandbox before and after freezing, figures published by the project
Bu grafiğin arkasındaki veriler
[
  {
    "label": "Active, holding 1 GiB",
    "resident_memory_mib": 1024,
    "wake_ms": 0
  },
  {
    "label": "Frozen",
    "resident_memory_mib": 5,
    "wake_ms": 50
  }
]

1024 MiB bellek tutan boşta bir sandbox, dondurulduğunda 5 MiB yerleşik belleğe düşer ve yaklaşık 50 ms içinde geri döner. Süreçler oldukları yerde askıya alınır ve devam ettirilir; bu sayede uzun ömürlü bir ajan, dondurma işlemi boyunca kabuk durumunu ve yarım kalmış işlerini korur. Kapasite planlaması yapmadan önce bunu kendi sunucunuzda yeniden oluşturun.

Kurulum öncesinde ana makine gereksinimleri

Ana makine x86_64 mimarisinde Ubuntu veya Debian olmalıdır ve kurulum için root yetkisi gerekir. Daemon, loop mount işlemleri yaptığı ve cgroup kayıtları yazdığı için çalışma zamanında root yetkisini korur.

Sandbox ortamları, konteyner ile ana makine çekirdeği arasına bir kullanıcı alanı çekirdeği yerleştiren bir konteyner çalışma zamanı olan gVisor ile Docker üzerinde çalışır. Bu yapı, her sandbox'ın kullandığı runsc çalışma zamanını sağlar. Daemon, Node 22 veya daha yeni bir sürüm gerektirir. Sisteminizdeki Node sürümü zaten 22 veya daha yeniyse, kurulum aracı bunu kullanır; yalnızca sürüm eksikse veya daha eskiyse kurulum aracı kendi sabit kopyasını indirir, sağlama toplamını doğrular ve /opt dizini altına açar.

Swap alanı mevcut olmalı ve vm.swappiness değeri 100 olarak ayarlanmalıdır. Bu bir performans ayarı tavsiyesi değil, işlevsel bir gerekliliktir. Dondurma (freezing) işlemi, boşta kalan bir sandbox'ın belleğini swap alanına aktararak çalışır. gVisor, sandbox belleğini paylaşımlı bellek olarak tutar ve çekirdek, varsayılan swappiness değerinde paylaşımlı belleği swap alanına taşımaz. Proje kapsamında yapılan ölçümlerde, varsayılan değerde 0 bayt geri kazanım sağlanırken, 100 değerinde yüzde 99,5 geri kazanım elde edilmiştir. Çekirdeğin o an kullandığı değeri mutlaka kontrol edin; çünkü bazı bulut imajları, okumayı asla aklınıza getirmeyeceğiniz bir dosyada vm.swappiness = 0 değerini tanımlı olarak sunar.

sysctl vm.swappiness
swapon --show

sysctl vm.swappiness komutu vm.swappiness = 100 çıktısını vermeli ve swapon --show komutu bir swap dosyası listelemelidir. Eğer swappiness değeri 0 olarak görünüyorsa, her dondurma işlemi etkisiz kalacak ve boşta kalan her sandbox için tam bellek maliyeti ödemeye devam edeceksiniz.

Ubuntu üzerinde Dormice kurulumu

Belgelenen kurulum yöntemi, bash içine tek bir boru hattı (pipe) ile gerçekleştirilir:

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

Komutu çalıştırmadan önce içeriğini çekin ve inceleyin. Bu betik root yetkileriyle çalışır ve ana makinenizi yeniden yapılandırır: Docker eksikse kurar, gVisor ve Caddy'yi sağlama toplamı doğrulamasıyla indirir, ana makinede swap alanı yoksa bir swapfile oluşturur, daemon, ağ geçidi ve imge kayıt defteri için systemd birimleri yazar ve güvenlik duvarı kurallarını ekler.

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, swapfile boyutunu belirler; varsayılan değer 16'dır ve bu, küçük bir VPS için ciddi bir disk alanı kullanımıdır. --mirror cn, indirme işlemlerini Çin ana karasından erişilebilir aynalara yönlendirir. Yükleyiciyi tekrar çalıştırmak kodu günceller ve yapılandırma sapmalarını onarır; API anahtarınızı asla değiştirmez.

Kod /opt/dormice dizinine, yapılandırma /etc/dormice/env dizinine (ağ geçidi için ek olarak /etc/dormice/gateway.env), sandbox verileri /var/lib/dormice dizinine yerleşir; dormice ve dor komutları ise /usr/local/bin dizininde bulunur. Yükleyici, kurulum sırasında API anahtarını oluşturur ve 600 izin moduyla /etc/dormice/env dosyasına yazar; aynı değer ağ geçidinin dosyasına da işlenir.

Kurulum için etiketlenmiş bir sürüm bulunmamaktadır. 12 Ekim 2026 itibarıyla depoda herhangi bir git etiketi veya GitHub sürümü yoktur; bu nedenle yükleyici main adresini klonlar ve o sabah depoda ne varsa onu alırsınız. Bir sürümü sabitlemek, fiilen kurduğunuz commit değerini not etmeniz anlamına gelir.

git -C /opt/dormice rev-parse HEAD

Bu hash değerini dağıtım notlarınızla birlikte saklayın; çünkü hangi kod sürümünü çalıştırdığınızı tam olarak bu değer belirtir. Bu tek başına bir geri dönüş yolu değildir: yeni süreçler başlatılırken veritabanı migrasyonlarını uygular ve yükseltme belgeleri, eski bir yükleyiciyi tekrar çalıştırmanın migrasyonu geri almayacağını belirtir. Herhangi bir şeyi yeniden başlatmadan önce yükleyici, her iki veritabanının da anlık görüntüsünü /var/lib/dormice/backups/ dizinine kaydeder ve en son üç tanesini tutar. Bu anlık görüntüler, hatalı bir yükseltme sonrası belgelenen geri dönüş yöntemidir; bu nedenle tekrar yükseltme yapmadan önce en yenisini sunucudan dışarı kopyalayın.

Yükleyici, dor doctor komutunu çalıştırarak sona erer. Bu, paket listesine güvenmek yerine çalışma zamanının çalıştığını kanıtlamak için gerçek gVisor container'larını başlatan salt okunur bir ana makine denetimidir. Daemon düzgün çalışmadığında bu komutu tekrar çalıştırın.

sudo dor doctor
systemctl is-active dormice

systemctl is-active dormice komutu active çıktısını vermelidir. Eğer failed çıktısını veriyorsa, journalctl -u dormice -n 50 dosyası hata nedenini içerir; başarısız bir başlatma genellikle daemon'ın kendisinden ziyade swap veya gVisor ön koşullarıyla ilgilidir.

Yükleyici ayrıca sunucuya Caddy'yi de kurar; bu nedenle güvenlik duvarı işlemlerinin bittiğine karar vermeden önce hangi portların dinlendiğini kontrol edin.

sudo ss -lntp

Daemon her zaman 127.0.0.1 adresine bağlanır ve tasarım gereği bu adresi değiştirecek bir ayar yoktur. Sadece port değiştirilebilir: DORMICE_PORT varsayılan olarak 3676 değerindedir. Yanındaki ağ geçidi de 127.0.0.1:3677 üzerinde aynı kuralı izler, port için DORMICE_GATEWAY_PORT kullanılır ve kasıtlı olarak bir ana makine ayarı bulunmaz. Her ikisine de dizüstü bilgisayarınızdan erişmek bilinçli bir eylemdir; bunun en ucuz yolu her iki portu da ileten bir SSH tüneli kurmaktır.

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

Tünel açıkken, dizüstü bilgisayarınızdaki http://127.0.0.1:3677/console adresi, ağ geçidi tarafından sunulan web konsoludur. İlk ziyaretinizde API anahtarını bir kez yapıştırarak operatör olduğunuzu kanıtlayın, ardından bir konsol kullanıcı adı ve parolası belirleyin. Giriş yapmak, 7 gün geçerli olan ve sayfa JavaScript'inin okuyamayacağı bir httpOnly oturum çerezi oluşturur; konsol, API anahtarını hiçbir zaman tekrar görüntülemez. Oradaki Connect sayfası, doğrudan kendi uç noktanıza yönlendirilmiş kopyala-yapıştır istemci kod parçacıklarını yazdırır.

Bir sandbox oluşturun ve içinde kod çalıştırın

Bir işlem bir sandbox oluşturur: acquire. Bu işlem eşgüçlüdür (idempotent); yani aynı anahtar her zaman aynı sandbox'ı döndürür; gerektiğinde onu oluşturur, uyandırır, başlatır veya geri yükler. Diğer tüm fiiller, daha önce hiç görmediği bir anahtar için 404 hatası döndürür. dor CLI aracında acquire fiili bulunmaz, bu nedenle ilk sandbox'ınızı konsol veya bir istemci kütüphanesi üzerinden almanız gerekir.

Konsol yolu en hızlı olanıdır. Tünel üzerinden /console adresini açın ve my-agent adında bir sandbox oluşturun. CLI aracı daha sonra bu sandbox üzerinde çalışacaktır.

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 komutu, her sandbox'ı yaşam döngüsü durumuyla birlikte listeler; bir sandbox'ın aktif durumdan donmuş duruma geçişini bu şekilde izleyebilirsiniz. dor sandbox exec komutu Python 3.12 sürümünü yazdırır, çünkü hazır imaj; Ubuntu 24.04 üzerinde Python 3.12, Node 24, git ve ripgrep yüklü olarak gelir. Kimlik doğrulama hatası alıyorsanız, kopyaladığınız token satırı değişken adını da içeriyor demektir.

Dosyalar dor sandbox push my-agent ./script.py ile taşınır ve /home/user/script.py dizinine yerleşir; dor sandbox pull my-agent notes.txt ise bir dosyayı geri getirir. Yerel dosya fiilleri dosya başına 16 MiB ile sınırlıdır, ancak E2B dosya arayüzü akış sağlar ve tek sınırın sandbox disk kotası olmasını sağlar.

Yok etme (destroying), veri kaybına yol açan tek fiildir. dor sandbox destroy my-agent komutu sandbox'ı kaldırır ve eşgüçlüdür; ana README dosyası, paketlenmiş aracı yeteneği ve CLI paketi README dosyası, bu işlemi aynı isim altında belgeler. Yine de kendi derlemeniz üzerinde dor sandbox --help komutunu çalıştırın, çünkü yükleyici main yolunu takip eder ve CLI sürekli büyümeye devam eder.

Mevcut E2B kodunuzu kendi sunucunuza yönlendirin

Bu, konunun neden önemli olduğunun nedenidir. npm üzerindeki resmi e2b paketi, hiçbir değişiklik yapılmadan Dormice ile iletişim kurar. Bunu, SSH tüneli açıkken dizüstü bilgisayarınızdan çalıştırın; böylece sunucuda yeni hiçbir şey dinleme moduna geçmez.

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

Sorunsuz bir çalışma, 0 çıkış kodu ve 42 çıktısını verir. API anahtarı, uyumluluk katmanının beklediği biçim olan, önünde e2b_ öneki bulunan Dormice token'ınızdır.

Bu uyumluluk bir taslak değildir. stdout ve stderr akışı, arka plan komutları, etkileşimli PTY, imzalı yükleme ve indirme URL'leri, dizin izleme ve port proxy'si; resmi paket aracılığıyla gerçek bir Docker ve gVisor daemon üzerinde projenin uçtan uca test paketi tarafından doğrulanmıştır. Gerçek bir iş yükünü taşımadan önce şu birkaç farka dikkat edilmelidir:

  • Şablon oluşturma (Template builds) henüz uygulanmamıştır. Şablon, kendi oluşturduğunuz ve dor template add ile kaydettiğiniz bir docker imajıdır; Sandbox.create('name') bunu çözümleyebilir. Kayıtlı olmayan bir isim, varsayımda bulunmak yerine 404 hatası döndürür.
  • E2B arayüzü üzerinden oluşturulan sandbox'lar gerçek zaman sınırlarına (deadlines) sahiptir, çünkü E2B semantiği bunu gerektirir. Yerel API üzerinden oluşturulan sandbox'lara hiçbir zaman zaman sınırı uygulanmaz.
  • Dondurulmuş (frozen) bir sandbox, süreçlerini korur ve kaldığı yerden devam ettirir; bu nedenle buradaki duraklatma ve devam ettirme, alışık olduğunuz durdurma ve soğuk başlatma (cold start) işlemlerinden farklıdır.

Sandbox'ın engelledikleri ve engellemedikleri

gVisor, container sistem çağrılarını kullanıcı alanında (userspace) yakalar ve kendisi karşılar; bu sayede sandbox içindeki kod, ana makine çekirdeğinizle doğrudan iletişim kurmaz. Sandbox içinde komutlar user (uid 1000) olarak çalışır, ancak bu hesap parolasız sudo yetkisine sahiptir; dolayısıyla sandbox içindeki root yetkisi, talep eden her kod için erişilebilirdir. uid değerini bir koruma olarak görmeyin: proje, güvenlik sınırının uid değil gVisor olduğunu açıkça belirtir; kendi yetkilerini yükselten bir sandbox dahi ana makine çekirdeğine ulaşamaz. Bu durum olağan senaryoları kapsar: rm -rf / çalıştıran, diski dolduran veya bir şey çökene kadar fork yapan oluşturulmuş bir betik, yalnızca kendi sandbox'ına zarar verir ve orada durur.

Sandbox'ın engellemedikleri ise şunlardır. Bunların her biri sizin sorumluluğunuzdadır.

  • Bir sandbox'ın çalışan bir dış ağ bağlantısı vardır. Oluşturulan kod, istediği her şeyi indirebilir ve bulduğu her şeyi dışarıya gönderebilir. Yükleyicinin ağ sıkılaştırması iki özel durumu kapsar: container trafiğinin 169.254.0.0/16 ve Alibaba Cloud tarafından kullanılan 100.100.100.200 adresindeki bulut meta veri servisine erişimini engeller (bu adresler, bulut ortamlarında instance kimlik bilgilerinin erişilebilen her şeye sunulduğu noktalardır) ve Docker'ın daemon.json ayarı üzerinden "icc": false ile container'lar arası trafiği kapatır. Bunun dışında hiçbir şey engellenmez. sudo iptables -S DOCKER-USER belgesini okuyun ve sandbox'ın erişmemesi gereken özel IP aralıkları için kendi DROP kurallarınızı ekleyin.
  • Docker, kendi kurallarını güvenlik duvarınızın önüne yerleştirir; bu nedenle ufw kapalı olduğunu belirtse bile, dışarıya açılan bir container portu internetten yanıt verebilir. Herhangi bir şeyi bu ana makinede dışarıya açmadan önce Docker'ın ufw kurallarını aşarak portları nasıl yayınladığı ve VPS için ufw güvenlik duvarı temelleri konularını okuyun.
  • gVisor bir hipervizör değil, kullanıcı alanı çekirdeğidir. Bu bilinçli bir tercihtir; çünkü dondurma (freezing) işlemi sandbox'ların süreç (process) olmasını gerektirir ve KVM zorunluluğu sistemin her yere kurulmasını engeller. Tehdit modeliniz donanım sanallaştırması gerektiriyorsa, Firecracker sınıfı izolasyon kullanın ve bunun getirdiği operasyonel maliyeti kabul edin.
  • API token, istemci tarafındaki tek güvenlik sınırıdır. DORMICE_API_TOKEN değerine sahip olan herhangi bir şey, makinedeki her sandbox'ı oluşturabilir, okuyabilir ve yok edebilir. Agent sürecine kendi VPS üzerinde en düşük yetkili kullanıcı hesabını atayın ve token'ı bir SSH anahtarına davrandığınız gibi koruyun. Claude Code'u bir VPS üzerinde güvenli çalıştırma rehberindeki alışkanlıklar doğrudan buraya aktarılabilir.

Daemon'ın kendisi ana makinenizde root olarak çalışır. gVisor, ana makineyi sandbox içindeki koddan korur; ancak daemon'ı veya token'a sahip olan kişiyi ana makineden koruyan bir mekanizma yoktur. Bu nedenle Dormice çalıştıran makine, yalnızca bu iş için ayrılmış bir makine olmalıdır. Eğer agent'ınız MCP (model context protocol) üzerinden araçlara da erişiyorsa, aynı nedenden dolayı bu MCP sunucularını ayrı bir VPS üzerinde tutun.

4 GB ve 8 GB bellek kapasitesine kaç adet sandbox sığar?

Bellek tüketimini iki unsur belirler: ana makinenin temel bellek kullanımı ve o an aktif olan her bir sandbox'ın çalışma seti. Ubuntu, Docker ve daemon süreçleri için yaklaşık 1 GB ayırın, ardından kalan miktarı bir sandbox'ın gerçek kullanım değerine bölün. Birkaç dosya okuyan Python betiği çalıştıran bir sandbox 200 ila 300 MiB civarında bellek kullanır. Derleyici veya kapsamlı bir test paketi çalıştıran bir sandbox ise bir gibibyte değerini aşabilir.

GrafikConcurrent sandboxes by host RAM, arithmetic after a 1 GB host reserve
Bu grafiğin arkasındaki veriler
[
  {
    "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
  }
]

4 GB kapasiteli bir VPS, her biri 512 MiB kullanıyorsa aynı anda yaklaşık 6 sandbox'ı, her biri bir tam gibibyte kullanıyorsa 3 sandbox'ı aktif tutabilir. 8 GB kapasiteli bir VPS'te bu sayılar sırasıyla 14 ve 7 değerlerine ulaşır. Bunlar eşzamanlı çalışma için üst sınırlardır ve kıyaslama testinden ziyade aritmetik hesaplamalardır; bu nedenle kendi iş yükünüzü çalıştırırken free -m değerini izleyin.

Dondurulmuş (frozen) sandbox'lar RAM yerine swap alanıyla sınırlıdır; tasarımın temel amacı da budur. Bir gibibyte bellek kullanan dondurulmuş bir sandbox, swap alanında yaklaşık o kadar yer kaplar ve RAM'de neredeyse hiç yer tutmaz; bu nedenle yükleyicinin varsayılan 16 GB swap dosyası yaklaşık 16 adet sandbox'ı barındırabilir. Bu sınır aşıldığında sandbox'ların durdurulmuş (stopped) aşamaya geçmesi gerekir; bu aşamada sadece disk alanı tüketirler. Uzun vadede asıl kısıtlayıcı faktör disktir: her sandbox kendi dosya sistemini korur ve her biri node_modules dizini içeren birkaç düzine aracı, bellek sorunu oluşmadan çok önce küçük bir disk bölümünü dolduracaktır.

Dondurma, durdurma, arşivleme: yaşam döngüsü ayarları

Varsayılan değerler, 10 dakika boşta kaldıktan sonra dondurma, 3 gün sonra durdurma ve arşivleme yapılandırılmışsa 7 gün sonra arşivlemedir. stopAfterSeconds değerini null olarak ayarlamak size yerleşik bir aracı sağlar: boşta kaldığında donabilir ancak asla soğuk başlatma yapmaz.

Arşivleme isteğe bağlıdır ve daemon bu konuda şeffaftır. Konsolun ayarlar sayfasında S3 uyumlu bir depo yapılandırın (dört adet DORMICE_S3_* değişkeni hala mevcuttur ancak bunlar yalnızca gateway'in ilk açılışı için başlangıç değerleri olarak kullanılır). Bu işlemden sonra durdurulan bir sandbox'ın diski tar ve zstd ile paketlenir, bucket'a gönderilir ve yerel diskten silinir. Söz konusu bucket, başka bir makinenizde kendi barındırdığınız bir MinIO bucket'ı olabilir. Depoyu yapılandırmadan bırakırsanız sandbox'lar sonsuza kadar durdurulmuş durumda kalır; arşivleme talep eden bir politika ise sessizce göz ardı edilmek yerine reddedilir. Geri yükleme işlemleri sessiz değil, görünürdür: bir sonraki acquire isteği hemen geri yükleniyor durumu ve bir ilerleme değeri ile yanıt verir, disk geri geldiğinde ise durum hazır olarak değişir.

Henüz güvenmeli misiniz?

Net cevap: Yeniden oluşturamayacağınız hiçbir şey için güvenmeyin. Depo 8 Temmuz 2026 tarihinde oluşturuldu. 12 Ekim 2026 itibarıyla 1.509 yıldız, 109 fork, Apache-2.0 lisansı ve henüz etiketlenmiş hiçbir sürümü bulunmuyor. README dosyasının kendi durum satırı, hiçbir şeyin üretime hazır olmadığını belirtiyor.

Bu kombinasyon, belirli bir risk yapısına sahiptir. Yükleyici main sürümünü takip ettiği için kod sürekli değişmektedir. Arayüz henüz oturmamıştır: belgeler artık daemon'ın önünde kendi portuna, kendi yapılandırma dosyasına ve kendi veritabanına sahip bir ağ geçidini tarif etmektedir. Yaklaşık üç aylık bir proje, hiçbir lisans maddesi kimseyi devam etmeye zorlamadığı için aniden durabilir.

Riski yönetilebilir kılan şey E2B uyumluluğudur. Uygulamanız, arkasında barındırılan bir uygulaması olan bir protokol ile iletişim kurar; bu nedenle Dormice durursa iki URL'yi değiştirerek çalışmaya devam edebilirsiniz. Aracınızı yerel API yerine E2B yüzeyine göre yazarsanız bu çıkış yolunu korumuş olursunuz. Yerel @dormice/sdk paketi henüz npm üzerinde bulunmamaktadır, bu nedenle onu kullanmak depodan derlemeyi gerektirir; bu da uyumlu yoldan başlamak için ikinci bir nedendir.

Sistemi, kaybetmeyi göze alabileceğiniz yerlerde çalıştırın. Sunucuyu bir betik ile yeniden oluşturun, token'ı her komut isteminden ve her commit işleminden uzak tutun ve saklamaya değer her şeyi kendi yedekleme planınıza göre sandbox ortamlarından dışarı aktarın.

FAQ

Dormice üretime hazır mı?

Hayır, proje bunu açıkça belirtmektedir. README dosyasındaki durum satırı, hiçbir bileşenin henüz üretime hazır olmadığını ifade eder. 12 Ekim 2026 itibarıyla depo yaklaşık üç aylıktır; herhangi bir git etiketi veya sürümü bulunmadığından sabitlenecek bir sürüm numarası yoktur. Yükleyici main dalını klonlar, bu da her çalıştırmada en güncel commit'i alacağınız anlamına gelir. Her kurulumdan sonra git -C /opt/dormice rev-parse HEAD kaydını tutun, yükleyicinin /var/lib/dormice/backups/ dizinine yazdığı veritabanı anlık görüntülerini yedekleyin ve değerli verilerinizi sandbox ortamlarının dışında saklayın.

Dormice, ajanıma geçici bir VM vermekten ne kadar farklı?

Geçici bir VM, bir oturum için oluşturup sonrasında sildiğiniz, SSH erişimli bir makinedir. Dormice ise bir yürütme API'sidir: programınız acquire ve ardından exec çağrısı yapar; arada bir kabuk oturumu olmadan standart çıktı ve çıkış kodunu alır. VM, bir süreliğine tam bir bilgisayara ihtiyaç duyan insan veya ajanlar için uygundur. Dormice ise günde birçok kez üretilmiş kod çalıştıran ve her çalıştırma için makine kurulumu ve temizliğiyle uğraşmak istemeyen uygulamalar için tasarlanmıştır.

Resmi E2B SDK gerçekten kod değişikliği olmadan çalışıyor mu?

Evet, yapılandırma değişiklikleriyle çalışır. apiUrl ve sandboxUrl değerlerini daemon üzerindeki /e2b/api ve /e2b/envd adreslerine yönlendirin ve Dormice token'ınızı e2b_ ön ekiyle API anahtarı olarak kullanın. Komut yürütme, PTY oturumları, dosya aktarımı, imzalı URL'ler ve port proxy'si, resmi paket üzerinden çalışan projenin uçtan uca test takımı tarafından desteklenmektedir. Şablon oluşturma önemli bir eksikliktir: e2b template build henüz uygulanmamıştır, bu nedenle şablon, oluşturup dor template add ile kaydettiğiniz bir Docker imajıdır.

4 GB RAM'li bir VPS üzerinde kaç sandbox çalışabilir?

Her sandbox 512 MiB kullanıyorsa aynı anda yaklaşık 6, her biri tam bir gibibyte kullanıyorsa 3 sandbox çalışabilir. Bu hesaplama; işletim sistemi, Docker ve daemon için yaklaşık 1 GB ayrıldıktan sonra yapılmıştır. Dondurulmuş sandbox'lar swap alanıyla sınırlıdır; bu nedenle yükleyicinin varsayılan 16 GB swap dosyası, her biri bir gibibyte tutan yaklaşık 16 sandbox'ı barındırabilir. Kendi değerlerinizi gerçek yük altında free -m ile ölçün; çünkü bir test takımı çalıştıran sandbox, küçük bir betik çalıştıran sandbox'a göre çok daha fazla kaynak tüketir.

Dormice neden vm.swappiness değerinin 100 olmasını gerektiriyor?

Bir sandbox'ı dondurmak, boşta duran belleğini swap alanına aktarmak anlamına gelir. gVisor, sandbox belleğini paylaşımlı bellek olarak tutar ve Linux çekirdeği varsayılan swappiness değerinde paylaşımlı belleği swap alanına taşımaz. Bu nedenle varsayılan ayarlarda dondurma işlemi hiçbir bellek geri kazanımı sağlamaz ve sandbox tam bellek maliyetiyle çalışmaya devam eder. Proje, varsayılan ayarlarda 0 bayt, 100 değerinde ise yüzde 99,5 oranında geri kazanım ölçmüştür. Bazı bulut imajları 0 değeriyle geldiğinden, yapılandırma dosyalarını okumak yerine sysctl vm.swappiness ile geçerli değeri kontrol edin.

Bu yazı işinize yaradı mı?