SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor · Na-update 2026-10-15

Paano Mag-self-host ng Dormice para sa Agent Sandbox

Patakbuhin ang E2B-compatible agent sandboxes sa sarili mong VPS. I-install ang Dormice, magpatakbo ng code, suriin ang isolation, at tantiyahin ang host.

Ano ang Dormice, at ano ang hindi ito

Ang Dormice ay isang self-hosted agent sandbox: isang daemon sa Linux VPS na pagmamay-ari mo, na tinatawagan ng agent code mo sa pamamagitan ng HTTP upang magpatakbo ng untrusted code sa loob ng isang isolated container. Humihingi ang program mo ng sandbox ayon sa pangalan, ibinabalik ang parehong sandbox anuman ang dati nitong state, nagpapatakbo ng command sa loob nito, at binabasa ang output. Ang sandbox ay isang programmatic resource, hindi isang machine na nilo-loginan mo.

Iba ito sa pagbibigay sa isang agent ng buong computer. Ang isang pansamantalang VM para sa coding agent ay isang box na nilo-loginan mo gamit ang SSH, hinahayaang sirain ng agent, at pagkatapos ay dine-delete. Isang level sa ibaba ang Dormice: ito ang execution API na tinatawagan ng program mo kapag mayroon na itong code at kailangan nito ng ligtas na lugar para patakbuhin iyon. Gamitin ang throwaway VM kapag buong machine ang unit of work. Gamitin ang Dormice kapag isang exec call ang unit of work at gusto mong magpatakbo ng isang daan sa mga ito bawat araw nang hindi nangangailangan ng isang daang VM.

Tinatawag ng project ang sarili nito na E2B compatible. Ang E2B ay isang hosted sandbox service na ini-import na ng maraming agent framework sa client library ng mga ito. Ibinibigay ng Dormice ang parehong protocol gamit ang sarili nitong URL prefixes, kaya patuloy na gagana ang application na ginawa para sa opisyal na e2b package kapag itinuro mo ito sa sarili mong box. Hindi kailangang baguhin ang application code. Dalawang URL at isang API key prefix lamang ang kailangang baguhin.

Ano ang praktikal na ibig sabihin ng “SQLite ng agent sandboxes”

Ang SQLite ay database na ini-embed mo sa halip na isang service na ikaw ang nagpapatakbo, at direktang ginagamit ng Dormice ang paghahambing na ito. Isang daemon bawat machine, isang SQLite file para sa ledger nito, at isang TCP port, na may maliit na gateway na naka-install sa tabi nito para mag-serve ng web console. Walang Kubernetes at walang external database server. Kumukuha ang daemon ng exclusive lock sa tabi ng ledger nito, kaya tatangging magsimula ang pangalawang daemon sa parehong machine sa halip na tahimik na paghatiin ang state. Bawat sandbox ay nananatili sa machine kung saan ito ginawa. Inilalarawan na ngayon ng README ang isang fleet bilang isang gateway kasama ang mga machine sa private network nito, pero sinasabi pa rin nito na kung kailangan mo ng mga sandbox na lumilipat sa pagitan ng mga machine, o isang fleet na nasa magkakaibang region, dapat kang pumili ng ibang system at makinig sa babalang ito.

Ang ikalawang bahagi ng ideya ay tungkol sa cost. Sinisingil ng hosted sandbox ang bawat segundo na umiiral ito, kaya likas na disposable ang mga hosted sandbox. Tumatakbo ang Dormice sa hardware na binabayaran mo na, kaya permanenteng nananatili ang mga sandbox nito at mas mura habang mas matagal silang hindi gumagalaw. Unti-unting nagco-cool down ang isang sandbox: active, pagkatapos ay frozen, pagkatapos ay stopped, at sa huli ay archived. Anumang acquire ay ibinabalik ito mula sa rung kung saan ito umabot.

Ang freezing ang bahaging kailangang maunawaan, dahil ito ang dahilan kung bakit abot-kayang panatilihin magpakailanman ang sandbox ng bawat agent. Ito ang sariling inilathalang mga figure ng proyekto, na sinukat sa hardware nito at hindi sa iyo.

TsartOne idle sandbox before and after freezing, figures published by the project
Ang datos sa likod ng tsart na ito
[
  {
    "label": "Active, holding 1 GiB",
    "resident_memory_mib": 1024,
    "wake_ms": 0
  },
  {
    "label": "Frozen",
    "resident_memory_mib": 5,
    "wake_ms": 50
  }
]

Ang idle sandbox na gumagamit ng 1024 MiB ng memory ay bumababa sa 5 MiB resident memory kapag na-freeze, at bumabalik sa loob ng humigit-kumulang 50 ms. Nasi-suspend at nare-resume ang mga process sa kanilang kasalukuyang state, kaya napapanatili ng matagal nang tumatakbong agent ang shell state nito at ang hindi pa tapos na trabaho sa buong panahon ng freeze. I-reproduce muna ito sa sarili mong host bago ka magplano ng capacity batay rito.

Mga kailangan ng host bago mag-install

Ang host ay dapat Ubuntu o Debian na tumatakbo sa x86_64, at nangangailangan ng root ang installer. Nananatiling root ang daemon habang tumatakbo dahil nagsasagawa ito ng loop mounts at nagsusulat sa cgroups.

Tumatakbo ang mga sandbox sa Docker gamit ang gVisor (isang container runtime na naglalagay ng userspace kernel sa pagitan ng container at host kernel). Ito ang nagbibigay ng runsc runtime na ginagamit ng bawat sandbox. Ang Node 22 o mas bago ang nagpapatakbo sa daemon. Kung Node 22 o mas bago na ang system Node mo, muli itong gagamitin ng installer. Kung wala ito o mas luma, magda-download ang installer ng sarili nitong pinned copy, ibe-verify ang checksum nito, at ia-unpack ito sa ilalim ng /opt.

Dapat may swap, at dapat 100 ang vm.swappiness. Hindi ito payo sa tuning; functional requirement ito. Gumagana ang freezing sa pamamagitan ng pagtulak sa memory ng idle sandbox palabas sa swap. Hinahawakan ng gVisor ang memory ng sandbox bilang shared memory, at hindi isina-swap ng kernel ang shared memory kapag default ang swappiness. Sinukat ng project na 0 bytes ang nare-reclaim sa default na value, habang 99.5 percent ang nare-reclaim kapag 100. Suriin ang aktuwal na value na ginagamit ng kernel, dahil may ilang cloud image na nagse-set ng vm.swappiness = 0 sa isang file na hindi mo karaniwang maiisip basahin.

sysctl vm.swappiness
swapon --show

Dapat mag-print ang sysctl vm.swappiness ng vm.swappiness = 100, at dapat maglista ang swapon --show ng isang swapfile. Kung 0 ang inilalabas na swappiness, walang epekto ang bawat freeze at patuloy mong binabayaran ang buong memory para sa bawat idle sandbox.

I-install ang Dormice sa Ubuntu

Ang dokumentadong paraan ng pag-install ay isang pipe papunta sa bash:

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

Kunin ito at basahin bago patakbuhin. Tumatakbo ang script na ito bilang root at inaayos nito ang host: nag-i-install ito ng Docker kung wala pa ito, nagda-download ng gVisor at Caddy na may checksum verification, gumagawa ng swapfile kung walang swap ang host, nagsusulat ng systemd units para sa daemon, gateway, at image registry, at nagdaragdag ng firewall rules.

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

Itinatakda ng --swap-gb ang laki ng swapfile at ang default nito ay 16, na malaking bahagi ng disk para ilaan sa isang maliit na VPS. Inililipat ng --mirror cn ang mga download sa mga mirror na naaabot mula sa mainland China. Kapag muling pinatakbo ang installer, ina-upgrade nito ang code at inaayos ang drift, at hindi nito kailanman pinapalitan ang iyong API token.

Napupunta ang code sa /opt/dormice, ang configuration sa /etc/dormice/env (kasama ang /etc/dormice/gateway.env para sa gateway), ang sandbox data sa /var/lib/dormice, at ang mga command na dormice at dor sa /usr/local/bin. Ginagawa ng installer ang API token habang nag-i-install at isinusulat ito sa /etc/dormice/env na may mode 600. Inilalagay din ang parehong value sa file ng gateway.

Walang tagged release na maaaring pagbatayan ng pag-install. Noong 12 October 2026, walang git tags at GitHub releases ang repository, kaya kino-clone ng installer ang main at makukuha mo ang anumang code na nailagay doon noong umagang iyon. Kaya ang pag-pin ng version ay nangangahulugang itala ang commit na aktuwal mong na-install.

git -C /opt/dormice rev-parse HEAD

Itala ang hash na iyon kasama ng iyong deploy notes, dahil ipinapakita nito kung aling code mismo ang pinapatakbo mo. Hindi ito sapat na paraan para bumalik sa dating estado: nag-a-apply ng database migrations ang mga bagong proseso habang nagbo-boot, at ayon sa upgrade docs, hindi binabaligtad ang migration sa muling pagpapatakbo ng mas lumang installer. Bago mag-restart ng anuman, nagsa-save ang installer ng snapshots ng parehong database sa /var/lib/dormice/backups/ at pinananatili ang tatlong pinakabago. Ang mga snapshot na ito ang dokumentadong paraan para makabalik pagkatapos ng maling upgrade, kaya kopyahin ang pinakabagong snapshot palabas ng server bago muling mag-upgrade.

Nagtatapos ang installer sa pagpapatakbo ng dor doctor, isang read-only host check na nagbo-boot ng mga aktuwal na gVisor container upang patunayang gumagana ang runtime sa halip na umasa sa package list. Patakbuhin itong muli kapag hindi maayos ang paggana ng daemon.

sudo dor doctor
systemctl is-active dormice

Dapat mag-print ang systemctl is-active dormice ng active. Kung mag-print ito ng failed, nasa journalctl -u dormice -n 50 ang dahilan. Karaniwang swap o gVisor prerequisite ang sanhi ng failed start, hindi ang daemon mismo.

Naglalagay din ang installer ng Caddy sa server, kaya tingnan muna kung ano ang listening bago mong ituring na tapos na ang firewall configuration.

sudo ss -lntp

Palaging nagbi-bind ang daemon sa 127.0.0.1, at ayon sa disenyo ay walang setting para baguhin ang address na iyon. Ang port lamang ang maaaring magbago: ang default ng DORMICE_PORT ay 3676. Sumusunod ang gateway nito sa parehong tuntunin sa 127.0.0.1:3677, gamit ang DORMICE_GATEWAY_PORT para sa port at sadyang walang host setting. Ang pag-access sa alinman sa mga ito mula sa iyong laptop ay dapat sinasadyang gawin. Ang pinakamadaling paraan ay isang SSH tunnel na nagfo-forward ng parehong port.

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

Kapag bukas ang tunnel, ang http://127.0.0.1:3677/console sa iyong laptop ang web console na inihahatid ng gateway. Sa unang pagbisita, pinatutunayan mong ikaw ang operator sa pamamagitan ng isang beses na pag-paste ng API token, pagkatapos ay nagtatakda ka ng console username at password. Kapag nag-sign in ka, nagse-set ito ng httpOnly session cookie na valid sa loob ng 7 days at hindi mababasa ng page JavaScript. Hindi kailanman ipinapakita muli ng console ang token. Sa Connect page nito, makikita ang mga client snippet na maaaring i-copy at i-paste at nakaturo na sa sarili mong endpoint.

Gumawa ng sandbox at magpatakbo ng code dito

Isang operation ang gumagawa ng sandbox: acquire. Idempotent ito, kaya palaging ibinabalik ng parehong key ang parehong sandbox. Gagawin, gigisingin, sisimulan, o ire-restore ito kung kinakailangan. Lahat ng iba pang verb ay nagbabalik ng 404 para sa key na hindi pa nito nakita. Walang acquire verb ang dor CLI, kaya manggagaling sa console o client library ang una mong sandbox.

Pinakamabilis ang console route. Buksan ang /console sa pamamagitan ng tunnel at gumawa ng sandbox na pinangalanang my-agent. Pagkatapos, gagana rito ang CLI.

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'

Inililista ng dor sandbox ls ang bawat sandbox kasama ang lifecycle state nito. Sa ganitong paraan, mamomonitor mo ang paglipat nito mula active patungong frozen. Nagpi-print ang dor sandbox exec ng bersyon ng Python 3.12 dahil ang stock image ay Ubuntu 24.04 na may naka-install nang Python 3.12, Node 24, git, at ripgrep. Ang authentication error ay nangangahulugang naisama sa kinopya mong token line ang variable name.

Inililipat ang mga file gamit ang dor sandbox push my-agent ./script.py, na naglalagay sa mga ito sa /home/user/script.py, at ibinabalik naman ng dor sandbox pull my-agent notes.txt ang isang file. May limitasyong 16 MiB bawat file ang native file verbs. Samantala, nag-i-stream ang E2B file surface, kaya sandbox disk quota lamang ang nagiging limitasyon.

Ang pag-destroy lamang ang verb na nagbubura ng data. Inaalis ng dor sandbox destroy my-agent ang sandbox at idempotent ito. Idinodokumento ito ng pangunahing README, ng bundled agent skill, at ng CLI package README gamit ang iisang pangalan. Patakbuhin pa rin ang dor sandbox --help sa sarili mong build dahil sinusubaybayan ng installer ang main at patuloy na nadaragdagan ang CLI.

Ituro ang dati mong E2B code sa sarili mong server

Ito ang dahilan kung bakit ito mahalaga. Ang opisyal na e2b package mula sa npm, na walang binago, ay kumokonekta sa Dormice. Patakbuhin ito mula sa iyong laptop habang bukas ang SSH tunnel, upang walang bagong proseso na makinig sa server.

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

Sa matagumpay na pagtakbo, lalabas ang exit code 0 at 42. Ang API key ay ang iyong Dormice token na may e2b_ prefix sa unahan nito. Ito ang format na inaasahan ng compatibility layer.

Hindi stub ang compatibility. Sinusubukan ng end-to-end suite ng proyekto ang streaming ng stdout at stderr, background commands, interactive PTY, signed upload at download URLs, directory watching, at port proxy sa pamamagitan ng opisyal na package laban sa aktuwal na Docker at gVisor daemon. May ilang pagkakaiba na dapat isaalang-alang bago ka mag-migrate ng anumang aktuwal na workload:

  • Hindi implemented ang template builds. Ang template ay docker image na ikaw mismo ang nagbu-build at nagrerehistro gamit ang dor template add, at nire-resolve ito ng Sandbox.create('name'). Ang hindi rehistradong pangalan ay nagbabalik ng 404 sa halip na magpanggap na umiiral.
  • Ang mga sandbox na ginawa sa pamamagitan ng E2B surface ay nagkakaroon ng aktuwal na deadline dahil kinakailangan ito ng E2B semantics. Hindi kailanman ipinapataw ang deadline sa mga sandbox na ginawa sa pamamagitan ng native API.
  • Pinananatili ng frozen sandbox ang mga proseso nito at ipinagpapatuloy ang mga ito mula sa kalagitnaan ng kanilang pagtakbo. Kaya ang pause at resume dito ay hindi katulad ng stop at cold start na maaaring nakasanayan mo.

Mga pinipigilan ng sandbox, at mga hindi nito pinipigilan

Ini-intercept ng gVisor ang mga system call ng container sa userspace at ito mismo ang nagse-serve sa mga ito. Dahil dito, hindi direktang nakikipag-ugnayan ang sandboxed code sa kernel ng host. Sa loob ng sandbox, tumatakbo ang mga command bilang user (uid 1000), pero walang password ang sudo ng account na iyon. Dahil dito, available ang root sa loob ng sandbox sa anumang code na humihiling nito. Huwag ituring ang uid bilang proteksiyon. Malinaw na sinasabi ng project na ang security boundary ay gVisor, hindi ang uid. Kahit mag-elevate ang sandbox sa sarili nito, hindi pa rin nito maaabot ang kernel ng host. Sapat ito para sa karaniwang sitwasyon: kapag ang generated script ay nagpatakbo ng rm -rf /, pinuno ang disk, o nag-fork nang paulit-ulit hanggang may mag-crash, ang pinsala ay mananatili sa sarili nitong sandbox at doon matatapos.

Narito ang mga hindi nito pinipigilan. Ikaw ang responsable sa bawat isa sa mga ito.

  • May gumaganang outbound network ang sandbox. Maaaring mag-download ang generated code ng kahit ano at i-post ang anumang makita nito. Sinasaklaw ng network hardening ng installer ang dalawang partikular na bagay: bina-block nito ang container traffic papunta sa cloud metadata service sa 169.254.0.0/16 at sa 100.100.100.200, ang address na ginagamit ng Alibaba Cloud, kung saan ibinibigay ng cloud ang instance credentials sa anumang makakaabot dito; at pinapatay nito ang container-to-container traffic gamit ang "icc": false sa daemon.json ng Docker. Wala nang iba pang bina-block. Basahin ang sudo iptables -S DOCKER-USER at magdagdag ng sarili mong DROP rules para sa mga private range na walang dahilan para maabot ng sandbox.
  • Naglalagay ang Docker ng sarili nitong rules bago ang firewall mo. Dahil dito, maaaring sumagot sa internet ang published container port kahit sinasabi ng ufw na sarado ito. Basahin ang kung paano nagpa-publish ang Docker ng mga port lampas sa ufw at ang mga batayan ng ufw firewall para sa isang VPS bago ka mag-expose ng anuman sa host na ito.
  • Ang gVisor ay isang userspace kernel, hindi isang hypervisor. Sadyang ganito ang trade-off dahil kailangang mga process ang sandbox para gumana ang freezing, at hindi maaaring mangailangan ng KVM ang system dahil mapipigilan nitong ma-install ang software kahit saan. Kung nangangailangan ang threat model mo ng hardware virtualisation, gumamit ng isolation na nasa Firecracker class at tanggapin ang operational cost nito.
  • Ang API token ang buong security boundary sa client side. Ang sinumang may hawak ng DORMICE_API_TOKEN ay maaaring gumawa, magbasa, at mag-delete ng bawat sandbox sa machine. Bigyan ang agent process ng sarili nitong least privilege user sa VPS at ituring ang token tulad ng pagtrato mo sa SSH key. Direktang naaangkop dito ang mga kasanayan mula sa ligtas na pagpapatakbo ng Claude Code sa VPS.

Bilang root tumatakbo ang daemon mismo sa host mo. Pinoprotektahan ng gVisor ang host laban sa code sa loob ng sandbox, pero walang nagpoprotekta sa host laban sa daemon o sa sinumang may hawak ng token nito. Kaya ang machine na nagpapatakbo ng Dormice ay dapat isang machine na ito lamang ang ginagawa. Kung gumagamit din ang agent mo ng mga tool sa MCP (model context protocol), panatilihin ang mga iyon sa hiwalay na VPS na may MCP servers sa parehong dahilan.

Ilang sandbox ang kasya sa 4 GB at 8 GB?

Dalawang bagay ang kumokonsumo ng memory: ang baseline ng host mismo at ang working set ng bawat sandbox na kasalukuyang aktibo. Maglaan ng humigit-kumulang 1 GB para sa Ubuntu, Docker, at daemon, pagkatapos ay hatiin ang natitirang memory sa aktuwal na gamit ng isang sandbox. Ang sandbox na nagpapatakbo ng Python script na nagbabasa ng ilang file ay karaniwang nasa 200 hanggang 300 MiB. Ang sandbox na nagpapatakbo ng compiler o buong test suite ay maaaring lumampas sa isang gibibyte.

TsartConcurrent sandboxes by host RAM, arithmetic after a 1 GB host reserve
Ang datos sa likod ng tsart na ito
[
  {
    "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
  }
]

Ang 4 GB VPS ay kayang magpatakbo ng humigit-kumulang 6 sandbox nang sabay-sabay kung 512 MiB ang gamit ng bawat isa, o 3 kung isang buong gibibyte ang gamit ng bawat isa. Sa 8 GB VPS, magiging 14 at 7 ang mga bilang. Mga ceiling ito para sa concurrent work. Arithmetic ang mga ito, hindi benchmark, kaya i-monitor ang free -m habang tumatakbo ang sarili mong load.

Swap, sa halip na RAM, ang naglilimita sa mga frozen sandbox. Ito ang pangunahing layunin ng disenyo. Ang frozen sandbox na gumagamit ng isang gibibyte ay mananatiling gumagamit ng humigit-kumulang ganoon karaming swap at halos walang resident memory. Kaya ng default na 16 GB swapfile ng installer na mag-park ng humigit-kumulang 16 sandbox. Pag lampas doon, kailangan nilang mapunta sa stopped rung, kung saan disk lang ang ginagamit nila. Ang disk ang tunay na pangmatagalang limitasyon dito: pinananatili ng bawat sandbox ang filesystem nito, at mapupuno ng ilang dosenang agent na may sariling node_modules directory ang maliit na volume bago pa maging mahalaga ang memory.

Freeze, stop, archive: ang mga setting sa lifecycle

Ang mga default ay freeze pagkalipas ng 10 minutong idle, stop pagkalipas ng 3 araw, at archive pagkalipas ng 7 araw kapag naka-configure ang archiving. Kapag itinakda ang stopAfterSeconds sa null, magkakaroon ka ng resident agent: maaari itong mag-freeze kapag idle, at hindi ito kailanman gagawa ng cold start.

Opsyonal ang archiving, at malinaw itong ipinapaalam ng daemon. Mag-configure ng S3-compatible store sa settings page ng console (umiiral pa rin ang apat na DORMICE_S3_* variable, pero ginagamit lamang ang mga ito bilang seeds para sa unang boot ng gateway), at ang disk ng isang stopped sandbox ay ipe-pack gamit ang tar at zstd, ipapadala sa bucket, at aalisin sa lokal na storage. Ang bucket na iyon ay maaaring isang MinIO bucket na ikaw mismo ang nagho-host sa isa mo pang machine. Kapag hindi naka-configure ang store, mananatiling stopped ang mga sandbox, at tatanggihan ang policy na humihiling ng archive sa halip na tahimik itong balewalain. Makikita ang mga restore sa halip na mangyari nang tahimik: sasagot agad ang susunod na acquire ng restoring status at progress value, pagkatapos ay magiging ready kapag naibalik na ang disk.

Maaari mo na ba itong pagkatiwalaan?

Diretsong sagot: huwag muna para sa anumang hindi mo kayang i-rebuild. Nilikha ang repository noong 8 July 2026. Noong 12 October 2026, mayroon itong 1,509 stars, 109 forks, Apache-2.0 licence, at wala pa ring anumang tagged release. Mismong status line ng README ang nagsasabing wala pang handa para sa production.

May partikular na anyo ang panganib na dulot ng kombinasyong ito. Nagbabago ang code habang ginagamit mo ito dahil sinusundan ng installer ang main. Hindi pa stable ang interface: inilalarawan na ngayon ng docs ang isang gateway sa harap ng daemon, na may sarili nitong port, configuration file, at database. Maaari ring biglang huminto ang isang project na humigit-kumulang tatlong buwan pa lamang, dahil walang clause sa licence na nag-oobliga sa sinuman na ipagpatuloy ito.

Ang dahilan kung bakit kayang pamahalaan ang panganib ay ang E2B compatibility. Nakikipag-ugnayan ang application mo sa isang protocol na may hosted implementation, kaya kung huminto ang Dormice, dalawang URL lang ang babaguhin mo at maaari ka pa ring magpatuloy. Isulat ang agent mo laban sa E2B surface sa halip na sa native API upang mapanatili mo ang fallback na iyon. Wala pa rin sa npm ang native @dormice/sdk package, kaya kailangan mo itong i-build mula sa repository. Isa rin itong dahilan para magsimula sa compatible na path.

Patakbuhin ito kung saan kaya mong mawalan ng data o environment. I-rebuild ang host mula sa isang script, huwag ilagay ang token sa anumang prompt o commit, at ilipat sa labas ng sandboxes ang anumang kailangang itago ayon sa sarili mong backup schedule.

FAQ

Handa na ba ang Dormice para sa production?

Hindi, at malinaw itong sinasabi ng proyekto. Nakasaad sa status line ng README na wala pa roong handa para sa production. Noong 12 October 2026, humigit-kumulang tatlong buwan pa lamang ang repository, wala itong git tags at releases, kaya walang version number na maaaring i-pin. Kino-clone ng installer ang main branch, kaya pinakabagong commit ang nakukuha sa bawat run. Itala ang git -C /opt/dormice rev-parse HEAD pagkatapos ng bawat install. Magtabi ng kopya ng database snapshots na sinusulat ng installer sa /var/lib/dormice/backups/. Panatilihin ang anumang mahalagang data sa labas ng mga sandbox.

Paano naiiba ang Dormice sa pagbibigay sa agent ko ng disposable VM?

Ang disposable VM ay isang machine na may SSH na ginagawa mo para sa isang session at dine-delete pagkatapos. Ang Dormice ay isang execution API: tumatawag ang program mo sa acquire, pagkatapos ay sa exec, at ibinabalik nito ang stdout at exit code nang walang shell session sa pagitan. Ang VM ay angkop sa human user o agent na nangangailangan ng buong computer sa loob ng ilang panahon. Ang Dormice ay angkop sa application na maraming beses nagpapatakbo ng generated code bawat araw at ayaw ng setup at teardown na kasinglaki ng isang machine sa bawat run.

Talaga bang gumagana ang official E2B SDK nang walang pagbabago sa code?

Oo, basta may mga pagbabago sa configuration. Ituro ang apiUrl at sandboxUrl sa /e2b/api at /e2b/envd sa iyong daemon. Ipasa ang Dormice token na may e2b_ prefix bilang API key. Saklaw ng end-to-end suite ng proyekto, na tumatakbo sa pamamagitan ng official package, ang command execution, PTY sessions, file transfer, signed URLs, at port proxy. Ang template building ang pangunahing hindi pa saklaw: hindi ipinatupad ang e2b template build, kaya ang template ay isang docker image na bina-build at nire-rehistro mo gamit ang dor template add.

Ilang sandbox ang kasya sa isang 4 GB VPS?

Humigit-kumulang 6 ang maaaring sabay-sabay na gising kung 512 MiB ang gamit ng bawat sandbox. Humigit-kumulang 3 naman kung isang buong gibibyte ang gamit ng bawat isa. Kasama sa pagtatantya ang paglalaan ng humigit-kumulang 1 GB para sa operating system, Docker, at daemon. Swap naman ang naglilimita sa mga frozen sandbox. Sa default na 16 GB swapfile ng installer, nasa 16 sandbox ang maaaring ma-park kung tig-iisang gibibyte ang hawak ng bawat isa. Sukatin ang sarili mong workload gamit ang free -m sa ilalim ng aktuwal na load. Ang sandbox na nagpapatakbo ng test suite ay maaaring gumamit ng ilang ulit ng memory na ginagamit ng sandbox na nagpapatakbo lamang ng maliit na script.

Bakit kailangang itakda ang vm.swappiness sa 100 ng Dormice?

Ang pag-freeze ng sandbox ay nangangahulugang itinutulak sa swap ang idle memory nito. Hinahawakan ng gVisor ang memory ng sandbox bilang shared memory. Hindi ise-swap ng Linux kernel ang shared memory kapag default ang swappiness. Dahil dito, walang nare-reclaim na memory kapag nag-freeze sa default na value, at patuloy na kumokonsumo ng buong memory ang sandbox. Nakapagtala ang proyekto ng 0 bytes na na-reclaim sa default at 99.5 percent na na-reclaim sa 100. Suriin ang effective value gamit ang sysctl vm.swappiness sa halip na basahin ang config files, dahil may ilang cloud image na may value na 0.

Nakatulong ba ang artikulong ito?