Cara self-host Dormice untuk sandbox ejen AI
Dormice membolehkan anda menjalankan sandbox ejen serasi E2B pada VPS sendiri. Ketahui cara memasang daemon, mengasingkan kod tidak dipercayai, dan mengurus sumber host.
Apakah itu Dormice, dan apakah ia bukan
Dormice ialah sandbox ejen yang dihoskan sendiri: satu daemon pada VPS Linux milik anda, yang dipanggil oleh kod ejen anda melalui HTTP untuk menjalankan kod yang tidak dipercayai di dalam kontena terasing. Program anda meminta sandbox mengikut nama, mendapatkan semula sandbox yang sama walau apa pun keadaannya, menjalankan arahan di dalamnya, dan membaca outputnya. Sandbox ini merupakan sumber pengaturcaraan, bukan mesin yang anda log masuk.
Ini berbeza daripada memberikan ejen sebuah komputer penuh. VM pakai buang untuk ejen pengekodan ialah kotak yang anda SSH masuk, biarkan ejen merosakkannya, kemudian memadamnya. Dormice berada satu tahap di bawah: ia adalah API pelaksanaan yang dipanggil oleh program anda apabila ia sudah mempunyai kod dan memerlukan tempat yang selamat untuk menjalankannya. Gunakan VM pakai buang apabila satu mesin penuh adalah unit kerja. Gunakan Dormice apabila satu panggilan exec adalah unit kerja, dan anda mahukan seratus daripadanya sehari tanpa perlu menyediakan seratus VM.
Projek ini menggelarkan dirinya sebagai serasi dengan E2B. E2B ialah perkhidmatan sandbox yang dihoskan yang pustaka kliennya sudah diimport oleh banyak rangka kerja ejen. Dormice menyediakan protokol yang sama di bawah awalan URL miliknya sendiri, jadi aplikasi yang ditulis menggunakan pakej e2b rasmi akan terus berfungsi apabila anda menghalakannya ke kotak anda sendiri. Kod aplikasi tidak berubah. Dua URL dan satu awalan kunci API sahaja yang berubah.
Apakah maksud "SQLite bagi sandbox ejen" dalam praktis
SQLite ialah pangkalan data yang anda benamkan dan bukannya servis yang anda kendalikan, dan Dormice meminjam perbandingan tersebut secara langsung. Satu daemon bagi setiap mesin, satu fail SQLite untuk lejar, satu port TCP, dengan gateway kecil dipasang di sebelahnya yang menyediakan konsol web. Tiada Kubernetes, tiada pelayan pangkalan data luaran. Daemon tersebut mengambil kunci eksklusif di sebelah lejar, jadi daemon kedua pada mesin yang sama akan enggan bermula dan bukannya memecahkan status secara senyap. Setiap sandbox hidup pada mesin tempat ia dicipta. README kini menerangkan armada sebagai satu gateway ditambah dengan mesin pada rangkaian peribadinya, tetapi ia masih menyatakan bahawa jika anda memerlukan sandbox yang berpindah antara mesin, atau armada merentasi wilayah, anda harus memilih sesuatu yang lain, dan anda harus mendengar nasihat tersebut.
Separuh kedua idea ini adalah mengenai kos. Sandbox yang dihoskan mengenakan caj bagi setiap saat ia wujud, jadi sandbox yang dihoskan direka untuk dibuang. Dormice berjalan pada perkakasan yang anda sudah bayar, jadi sandboxnya adalah kekal dan menjadi lebih murah semakin lama ia dibiarkan. Sandbox akan menyejuk satu tahap demi satu tahap: aktif, kemudian dibekukan (frozen), kemudian dihentikan, kemudian diarkibkan. Sebarang perolehan (acquire) akan menariknya kembali ke atas dari mana-mana tahap yang telah dicapainya.
Pembekuan (freezing) adalah bahagian yang perlu difahami, kerana ia adalah perkara yang menjadikan penyimpanan sandbox setiap ejen selama-lamanya mampu milik. Ini adalah angka yang diterbitkan oleh projek itu sendiri, diukur pada perkakasannya dan bukan pada perkakasan anda.
Data di sebalik carta ini
[
{
"label": "Active, holding 1 GiB",
"resident_memory_mib": 1024,
"wake_ms": 0
},
{
"label": "Frozen",
"resident_memory_mib": 5,
"wake_ms": 50
}
]Sandbox melahu yang memegang 1024 MiB memori akan turun kepada 5 MiB resident sebaik sahaja dibekukan, dan kembali aktif dalam masa kira-kira 50 ms. Proses digantung dan disambung semula di tempatnya, jadi ejen yang beroperasi lama mengekalkan status shell dan kerja yang separuh siap merentasi proses pembekuan tersebut. Lakukan reproduksi pada hos anda sendiri sebelum anda merancang kapasiti berdasarkan angka ini.
Keperluan hos sebelum pemasangan
Hos mestilah Ubuntu atau Debian pada x86_64, dan pemasang memerlukan akses root. Daemon mengekalkan akses root semasa runtime kerana ia melakukan loop mount dan menulis ke cgroups.
Kotak pasir (sandbox) dijalankan di bawah Docker dengan gVisor (runtime kontena yang meletakkan kernel ruang pengguna antara kontena dan kernel hos), yang membekalkan runtime runsc yang digunakan oleh setiap kotak pasir. Node 22 atau lebih baharu menjalankan daemon tersebut. Jika Node sistem anda sudah versi 22 atau lebih baharu, pemasang akan menggunakannya semula; hanya apabila ia tiada atau lebih lama, pemasang akan memuat turun salinan yang ditetapkan, mengesahkan checksum-nya dan menyahzipnya di bawah /opt.
Swap mesti wujud, dan vm.swappiness mestilah 100. Ini bukan nasihat penalaan, ia adalah keperluan fungsi. Proses pembekuan (freezing) berfungsi dengan menolak memori kotak pasir yang melahu ke dalam swap, gVisor memegang memori kotak pasir sebagai memori kongsi, dan kernel tidak akan melakukan swap pada memori kongsi dengan nilai swappiness lalai. Projek ini merekodkan 0 bait yang diperoleh semula pada nilai lalai dan 99.5 peratus diperoleh semula pada 100. Semak nilai yang sebenarnya digunakan oleh kernel, kerana sesetengah imej awan menghantar vm.swappiness = 0 dalam fail yang anda tidak akan terfikir untuk membacanya.
sysctl vm.swappiness
swapon --showsysctl vm.swappiness sepatutnya mencetak vm.swappiness = 100, dan swapon --show sepatutnya menyenaraikan fail swap. Jika swappiness mencetak 0, setiap pembekuan tidak akan berfungsi dan menyebabkan anda membayar kos memori penuh untuk setiap kotak pasir yang melahu.
Memasang Dormice pada Ubuntu
Pemasangan yang didokumentasikan adalah melalui satu paip ke bash:
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh | bashDapatkan skrip tersebut dan baca kandungannya sebelum anda menjalankannya. Skrip ini berjalan sebagai root dan menyusun semula hos anda: ia memasang Docker jika tiada, memuat turun gVisor dan Caddy dengan pengesahan checksum, mencipta fail swap jika hos tidak mempunyai swap, menulis unit systemd untuk daemon, gateway dan registry imej, serta menambah peraturan firewall.
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 menetapkan saiz fail swap dan nilai lalainya ialah 16, yang merupakan jumlah ruang cakera yang besar untuk diberikan pada VPS kecil. --mirror cn menukar muat turun kepada cermin (mirrors) yang boleh dicapai dari tanah besar China. Menjalankan semula pemasang akan menaik taraf kod dan membaiki hanyutan konfigurasi (drift), dan ia tidak akan menukar token API anda.
Kod disimpan dalam /opt/dormice, konfigurasi dalam /etc/dormice/env (tambah /etc/dormice/gateway.env untuk gateway), data sandbox dalam /var/lib/dormice, dan arahan dormice serta dor dalam /usr/local/bin. Pemasang menjana token API semasa pemasangan dan menulisnya ke /etc/dormice/env dengan mod 600, dan nilai yang sama dimasukkan ke dalam fail gateway.
Tiada keluaran bertag (tagged release) untuk dipasang. Setakat 12 Oktober 2026, repositori tersebut tidak mempunyai tag git dan tiada keluaran GitHub, jadi pemasang mengklon main dan anda mendapat kod terkini pada pagi tersebut. Oleh itu, menetapkan versi (pinning) bermakna mencatat commit yang anda pasang sebenarnya.
git -C /opt/dormice rev-parse HEADSimpan hash tersebut bersama nota penempatan anda, kerana ia memberitahu anda dengan tepat kod yang sedang anda jalankan. Ia bukan cara untuk kembali ke versi asal dengan sendirinya: proses baharu akan menggunakan migrasi pangkalan data semasa ia but, dan dokumen naik taraf menyatakan bahawa migrasi tidak boleh diterbalikkan dengan menjalankan semula pemasang yang lebih lama. Sebelum memulakan semula apa-apa, pemasang menyimpan snapshot kedua-dua pangkalan data ke /var/lib/dormice/backups/ dan menyimpan tiga yang paling terkini. Snapshot tersebut adalah cara yang didokumentasikan untuk kembali selepas naik taraf yang gagal, jadi salin yang paling baharu keluar dari pelayan sebelum anda menaik taraf lagi.
Pemasang berakhir dengan menjalankan dor doctor, pemeriksaan hos baca-sahaja yang memulakan kontena gVisor sebenar untuk membuktikan runtime berfungsi dan bukannya sekadar mempercayai senarai pakej. Jalankan arahan ini semula apabila daemon berkelakuan tidak normal.
sudo dor doctor
systemctl is-active dormicesystemctl is-active dormice sepatutnya mencetak active. Jika ia mencetak failed, journalctl -u dormice -n 50 mengandungi sebabnya, dan kegagalan untuk bermula biasanya disebabkan oleh prasyarat swap atau gVisor dan bukannya daemon itu sendiri.
Pemasang juga meletakkan Caddy pada pelayan, jadi periksa apa yang sedang mendengar (listening) sebelum anda membuat keputusan bahawa kerja firewall telah selesai.
sudo ss -lntpDaemon sentiasa mengikat 127.0.0.1, dan mengikut reka bentuk, tiada tetapan untuk menukar alamat tersebut. Hanya port yang berubah: DORMICE_PORT lalai kepada 3676. Gateway di sebelahnya mengikut peraturan yang sama pada 127.0.0.1:3677, dengan DORMICE_GATEWAY_PORT untuk port dan sengaja tiada tetapan hos. Mencapai mana-mana daripadanya dari komputer riba anda adalah tindakan yang disengajakan, dan cara paling murah ialah menggunakan terowong SSH yang memajukan kedua-dua port tersebut.
ssh -L 3676:127.0.0.1:3676 -L 3677:127.0.0.1:3677 root@your-serverDengan terowong dibuka, http://127.0.0.1:3677/console pada komputer riba anda ialah konsol web yang dihidangkan oleh gateway. Pada lawatan pertama, anda membuktikan anda adalah pengendali dengan menampal token API sekali, kemudian tetapkan nama pengguna dan kata laluan konsol. Log masuk menetapkan kuki sesi httpOnly, sah selama 7 hari, yang tidak boleh dibaca oleh JavaScript halaman, dan konsol tidak akan memaparkan token tersebut semula. Halaman Connect di sana mencetak cebisan kod klien salin-dan-tampal yang sudah dihalakan ke endpoint anda sendiri.
Mencipta sandbox dan melaksanakan kod di dalamnya
Satu operasi mencipta sandbox: acquire. Operasi ini bersifat idempoten, jadi kunci yang sama sentiasa mengembalikan sandbox yang sama, sama ada dengan mencipta, mengejutkan, memulakan atau memulihkannya mengikut keperluan. Setiap kata kerja lain akan memberikan respons 404 bagi kunci yang tidak pernah ditemui. dor CLI tidak mempunyai kata kerja acquire, jadi sandbox pertama anda diperoleh daripada konsol atau pustaka klien.
Laluan konsol adalah yang terpantas. Buka /console melalui tunnel dan cipta sandbox bernama my-agent. CLI kemudiannya akan berfungsi pada sandbox tersebut.
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 menyenaraikan setiap sandbox berserta status kitaran hayatnya, iaitu cara anda memantau peralihan daripada aktif kepada beku. dor sandbox exec mencetak versi Python 3.12, kerana imej stok adalah Ubuntu 24.04 dengan Python 3.12, Node 24, git dan ripgrep yang telah dipasang. Ralat pengesahan sebaliknya bermaksud baris token yang anda salin menyertakan nama pemboleh ubah.
Fail dipindahkan dengan dor sandbox push my-agent ./script.py, yang mendarat di /home/user/script.py, dan dor sandbox pull my-agent notes.txt membawa fail kembali. Kata kerja fail asli dihadkan kepada 16 MiB setiap fail, manakala permukaan fail E2B melakukan penstriman dan membenarkan kuota cakera sandbox menjadi satu-satunya had.
Memusnahkan (destroying) adalah satu-satunya kata kerja yang menyebabkan kehilangan data. dor sandbox destroy my-agent membuang sandbox dan bersifat idempoten, dan README utama, kemahiran ejen yang disertakan serta README pakej CLI semuanya mendokumentasikannya di bawah nama tersebut. Jalankan dor sandbox --help pada binaan anda sendiri walau bagaimanapun, kerana pemasang menjejaki main dan CLI terus berkembang.
Halakan kod E2B sedia ada anda ke pelayan sendiri
Inilah sebab mengapa perkara ini penting. Pakej e2b rasmi daripada npm, tanpa diubah suai, berkomunikasi dengan Dormice. Jalankan arahan ini daripada komputer riba anda dengan terowong SSH dibuka, supaya tiada perkhidmatan baharu yang mendengar pada pelayan.
npm init -y
npm i e2b tsximport { 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.tsJalankan yang berjaya akan memaparkan kod keluar 0 dan 42. Kunci API ialah token Dormice anda dengan awalan e2b_ di hadapannya, iaitu format yang dijangkakan oleh lapisan keserasian.
Keserasian ini bukanlah sekadar stub. Penstriman stdout dan stderr, arahan latar belakang, PTY interaktif, URL muat naik dan muat turun yang ditandatangani, pemantauan direktori serta proksi port semuanya diuji melalui pakej rasmi terhadap daemon Docker dan gVisor sebenar oleh suite hujung-ke-hujung projek ini. Beberapa perbezaan perlu diambil perhatian sebelum anda memindahkan sebarang beban kerja sebenar:
- Binaan templat tidak dilaksanakan. Templat ialah imej Docker yang anda bina sendiri dan daftarkan dengan
dor template add, danSandbox.create('name')akan menyelesaikannya. Nama yang tidak berdaftar akan mengembalikan ralat 404 dan bukannya berpura-pura wujud. - Sandbox yang dicipta melalui antara muka E2B mempunyai tarikh akhir sebenar, kerana semantik E2B memerlukannya. Tarikh akhir tidak pernah dikenakan pada sandbox yang dicipta melalui API asli.
- Sandbox yang dibekukan mengekalkan prosesnya dan menyambungkannya semula di tengah jalan, jadi fungsi jeda dan sambung di sini bukanlah fungsi henti dan mula sejuk (cold start) yang mungkin biasa anda gunakan.
Perkara yang dihalang oleh sandbox, dan perkara yang tidak dihalang
gVisor memintas panggilan sistem (system calls) kontena dalam ruang pengguna (userspace) dan mengendalikannya sendiri, jadi kod dalam sandbox tidak berhubung terus dengan kernel hos anda. Di dalam sandbox, arahan dijalankan sebagai user (uid 1000), tetapi akaun tersebut mempunyai sudo tanpa kata laluan, jadi root di dalam sandbox tersedia kepada mana-mana kod yang memintanya. Jangan anggap uid sebagai perlindungan: projek ini menyatakan dengan jelas bahawa sempadan keselamatan ialah gVisor, bukan uid, dan sandbox yang meningkatkan keistimewaan dirinya masih tidak dapat mencapai kernel hos. Ini menangani kes biasa: skrip yang dijana yang menjalankan rm -rf /, memenuhi cakera, atau melakukan fork sehingga sesuatu terhenti, hanya akan merosakkan sandboxnya sendiri dan terhenti di situ.
Berikut adalah perkara yang tidak dihalang. Setiap perkara ini adalah tanggungjawab anda.
- Sandbox mempunyai rangkaian keluar yang berfungsi. Kod yang dijana boleh memuat turun apa sahaja yang ia suka dan menghantar apa sahaja yang ia temui. Pengukuhan rangkaian (network hardening) pemasang meliputi dua perkara khusus: ia menggugurkan (drop) trafik kontena ke perkhidmatan metadata awan pada 169.254.0.0/16 dan pada 100.100.100.200, alamat yang digunakan oleh Alibaba Cloud, iaitu tempat awan memberikan kelayakan instans kepada sesiapa yang boleh mencapainya, dan ia mematikan trafik antara kontena dengan
"icc": falsedalamdaemon.jsonDocker. Tiada perkara lain yang disekat. Bacasudo iptables -S DOCKER-USERdan tambah peraturan DROP anda sendiri untuk julat peribadi yang tidak sepatutnya dicapai oleh sandbox. - Docker memasukkan peraturannya sendiri mendahului firewall anda, jadi port kontena yang diterbitkan boleh menjawab dari internet walaupun ufw menegaskan bahawa ia ditutup. Baca cara Docker menerbitkan port melepasi ufw dan asas firewall ufw untuk VPS sebelum anda mendedahkan apa-apa pada hos ini.
- gVisor ialah kernel ruang pengguna, bukan hypervisor. Itu adalah pertukaran yang disengajakan, kerana pembekuan (freezing) memerlukan sandbox menjadi proses, dan memerlukan KVM akan menghalang pemasangan perisian ini di mana-mana. Jika model ancaman anda menuntut virtualisasi perkakasan, gunakan pengasingan kelas Firecracker dan terima kos operasi yang datang bersamanya.
- Token API ialah keseluruhan sempadan keselamatan di bahagian klien. Sesiapa yang memegang
DORMICE_API_TOKENboleh mencipta, membaca, dan memusnahkan setiap sandbox pada mesin tersebut. Berikan proses ejen pengguna dengan keistimewaan paling rendah pada VPS miliknya sendiri dan layan token tersebut seperti anda melayan kunci SSH. Tabiat daripada menjalankan Claude Code dengan selamat pada VPS boleh dipindahkan secara terus.
Daemon itu sendiri berjalan sebagai root pada hos anda. gVisor melindungi hos daripada kod di dalam sandbox, dan tiada apa yang melindungi hos daripada daemon atau daripada sesiapa yang memegang tokennya. Jadi, mesin yang menjalankan Dormice mestilah mesin yang hanya melakukan tugas tersebut. Jika ejen anda juga mencapai alatan melalui MCP (model context protocol), simpan pelayan MCP tersebut pada VPS berasingan atas sebab yang sama.
Berapakah jumlah sandbox yang boleh dimuatkan dalam 4 GB dan 8 GB?
Dua perkara menggunakan memori: garis dasar hos itu sendiri, dan set kerja bagi setiap sandbox yang sedang aktif. Peruntukkan kira-kira 1 GB untuk Ubuntu, Docker dan daemon, kemudian bahagikan baki memori dengan penggunaan sebenar satu sandbox anda. Sandbox yang menjalankan skrip Python untuk membaca beberapa fail menggunakan sekitar 200 hingga 300 MiB. Sandbox yang menjalankan pengkompil atau suite ujian penuh boleh melebihi satu gibibyte.
Data di sebalik carta ini
[
{
"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
}
]VPS 4 GB boleh memuatkan kira-kira 6 sandbox yang aktif serentak jika setiap satunya menggunakan 512 MiB, atau 3 jika setiap satunya menggunakan satu gibibyte penuh. VPS 8 GB meningkatkan jumlah tersebut kepada 14 dan 7. Ini adalah had maksimum untuk kerja serentak, dan ia merupakan pengiraan aritmetik bukannya penanda aras, jadi pantau free -m semasa beban kerja anda berjalan.
Sandbox yang dibekukan (frozen) dihadkan oleh swap dan bukannya RAM, yang merupakan tujuan utama reka bentuk ini. Sandbox beku yang asalnya menggunakan satu gibibyte akan mengekalkan jumlah tersebut dalam swap dan hampir tiada data dalam memori residen, jadi fail swap lalai 16 GB pemasang boleh menampung kira-kira 16 sandbox. Melebihi jumlah itu, ia perlu mencapai tahap dihentikan (stopped), di mana ia hanya menggunakan ruang cakera. Cakera adalah had sebenar dalam jangka masa panjang: setiap sandbox mengekalkan sistem failnya sendiri, dan beberapa dozen ejen yang masing-masing membawa direktori node_modules akan memenuhi volum kecil jauh lebih awal sebelum memori menjadi isu utama.
Bekukan, hentikan, arkibkan: kawalan kitaran hayat
Tetapan lalai adalah membekukan selepas 10 minit melahu, menghentikan selepas 3 hari, dan mengarkibkan selepas 7 hari apabila pengarkiban dikonfigurasikan. Menetapkan stopAfterSeconds kepada null memberikan anda ejen residen: ia mungkin membeku apabila melahu, dan ia tidak akan melakukan cold start.
Pengarkiban adalah pilihan, dan daemon akan melaporkannya dengan telus. Konfigurasikan storan yang serasi dengan S3 pada halaman tetapan konsol (empat pemboleh ubah DORMICE_S3_* masih wujud, tetapi hanya sebagai benih untuk but pertama gateway) dan cakera sandbox yang dihentikan akan dimampatkan dengan tar dan zstd, dihantar ke bucket, dan dibebaskan secara setempat. Bucket tersebut boleh menjadi bucket MinIO yang anda hoskan sendiri pada mesin anda yang lain. Biarkan storan tidak dikonfigurasikan dan sandbox akan kekal dalam status dihentikan selama-lamanya, dan polisi yang meminta untuk mengarkib akan ditolak dan bukannya diabaikan secara senyap. Pemulihan adalah kelihatan dan bukannya senyap: acquire seterusnya akan menjawab serta-merta dengan status pemulihan dan nilai kemajuan, kemudian bertukar kepada sedia sebaik sahaja cakera kembali tersedia.
Patutkah anda bergantung padanya sekarang?
Jawapan terus: jangan gunakan untuk apa-apa yang anda tidak boleh bina semula. Repositori ini dicipta pada 8 Julai 2026. Setakat 12 Oktober 2026, ia menunjukkan 1,509 bintang, 109 fork, lesen Apache-2.0, dan tiada sebarang release bertanda. Baris status dalam README sendiri menyatakan tiada apa-apa di situ yang sedia untuk pengeluaran (production).
Gabungan tersebut membawa bentuk risiko yang khusus. Kod berubah di bawah anda kerana pemasang menjejaki main. Antara muka masih belum stabil: dokumentasi kini menerangkan tentang gateway di hadapan daemon, dengan portnya sendiri, fail konfigurasi sendiri, dan pangkalan datanya sendiri. Selain itu, projek yang berusia kira-kira tiga bulan boleh berhenti begitu sahaja, memandangkan tiada klausa lesen yang mewajibkan sesiapa untuk meneruskannya.
Apa yang menjadikan risiko ini boleh ditanggung ialah keserasian E2B. Aplikasi anda berkomunikasi dengan protokol yang mempunyai implementasi terhos di belakangnya, jadi jika Dormice terhenti, anda hanya perlu menukar dua URL dan terus bekerja. Tulis ejen anda berdasarkan permukaan E2B dan bukannya API asli, supaya anda mengekalkan jalan keluar tersebut. Pakej asli @dormice/sdk juga belum ada di npm, jadi menggunakannya bermakna anda perlu membina daripada repositori, yang merupakan sebab kedua untuk bermula dengan laluan yang serasi.
Jalankan ia di tempat yang anda mampu untuk kehilangannya. Bina semula hos daripada skrip, pastikan token tidak berada dalam setiap prompt dan setiap commit, serta ambil apa sahaja yang berharga daripada sandbox mengikut jadual sandaran anda sendiri.
FAQ
Adakah Dormice sedia untuk pengeluaran?
Tidak, dan projek ini sendiri menyatakan perkara tersebut. Baris status dalam README menyatakan bahawa tiada apa-apa di situ yang sedia untuk pengeluaran lagi, dan setakat 12 Oktober 2026 repositori tersebut baru berusia kira-kira tiga bulan tanpa tag git dan tanpa sebarang releases, jadi tiada nombor versi untuk ditetapkan. Pemasang akan mengklon cawangan main, yang bermaksud setiap pelaksanaan memberikan anda commit yang paling baharu. Rekodkan git -C /opt/dormice rev-parse HEAD selepas setiap pemasangan, simpan salinan snapshot pangkalan data yang ditulis oleh pemasang ke /var/lib/dormice/backups/, dan simpan sebarang perkara berharga di luar sandbox.
Bagaimanakah Dormice berbeza daripada memberikan ejen saya VM pakai buang?
VM pakai buang ialah mesin dengan SSH yang anda cipta untuk satu sesi dan dipadamkan selepas itu. Dormice ialah API pelaksanaan: program anda memanggil acquire, kemudian exec, dan mendapatkan stdout serta kod keluar kembali, tanpa sesi shell di tengah-tengahnya. VM sesuai untuk manusia atau ejen yang mahukan keseluruhan komputer untuk seketika. Dormice sesuai untuk aplikasi yang menjalankan kod yang dijana berkali-kali sehari dan tidak mahu proses penyediaan dan pembersihan mesin bagi setiap pelaksanaan.
Adakah SDK E2B rasmi benar-benar berfungsi tanpa perubahan kod?
Ya, dengan perubahan konfigurasi. Halakan apiUrl dan sandboxUrl kepada /e2b/api dan /e2b/envd pada daemon anda, dan berikan token Dormice anda dengan awalan e2b_ sebagai kunci API. Pelaksanaan arahan, sesi PTY, pemindahan fail, URL yang ditandatangani dan proksi port semuanya dilindungi oleh suite hujung-ke-hujung projek yang berjalan melalui pakej rasmi. Pembinaan templat merupakan jurang yang ketara: e2b template build tidak dilaksanakan, jadi templat ialah imej Docker yang anda bina dan daftarkan dengan dor template add.
Berapa banyak sandbox yang muat pada VPS 4 GB?
Kira-kira 6 yang aktif pada masa yang sama jika setiap sandbox menggunakan 512 MiB, atau 3 jika setiap satu menggunakan satu gibibyte penuh, selepas menempah kira-kira 1 GB untuk sistem pengendalian, Docker dan daemon. Sandbox yang dibekukan dihadkan oleh swap sebaliknya, jadi fail swap lalai 16 GB pemasang boleh menampung sekitar 16 sandbox yang setiap satunya memegang satu gibibyte. Ukur sendiri dengan free -m di bawah beban sebenar, kerana sandbox yang menjalankan suite ujian menggunakan beberapa kali ganda daripada apa yang digunakan oleh skrip kecil.
Mengapa Dormice memerlukan vm.swappiness ditetapkan kepada 100?
Membekukan sandbox bermakna menolak memori terbiarnya ke dalam swap. gVisor memegang memori sandbox sebagai memori kongsi, dan kernel Linux tidak akan melakukan swap pada memori kongsi pada tahap swappiness lalai, jadi pada tahap lalai, pembekuan tidak menuntut semula apa-apa dan sandbox terus memakan memori penuh. Projek ini mengukur 0 bait dituntut semula pada tahap lalai dan 99.5 peratus dituntut semula pada 100. Semak nilai berkesan dengan sysctl vm.swappiness dan bukannya membaca fail konfigurasi, kerana sesetengah imej awan menghantar nilai 0.