SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-10-23

آموزش راه اندازی Dormice برای اجرای ایزوله کد عامل

با نصب Dormice روی VPS شخصی، محیط sandbox سازگار با E2B برای اجرای کدهای غیرقابل اعتماد بسازید. این راهنما نحوه مدیریت ایزوله و بهینه‌سازی منابع سرور را توضیح می‌دهد.

Dormice چیست و چه چیزی نیست

Dormice یک sandbox عامل (agent) با قابلیت میزبانی شخصی (self-hosted) است: یک daemon روی یک VPS لینوکسی که مالک آن هستید و کد عامل شما از طریق HTTP آن را فراخوانی می‌کند تا کدهای غیرقابل‌اعتماد را درون یک container ایزوله اجرا کند. برنامه شما یک sandbox را با نام درخواست می‌کند، همان sandbox را با هر وضعیتی که داشته باشد تحویل می‌گیرد، دستوری را درون آن اجرا کرده و خروجی را می‌خواند. این sandbox یک منبع برنامه‌نویسی است، نه ماشینی که به آن SSH بزنید.

این مدل با در اختیار گذاشتن یک کامپیوتر کامل به یک عامل متفاوت است. یک ماشین مجازی یک‌بارمصرف برای عامل کدنویسی جعبه‌ای است که به آن SSH می‌زنید، اجازه می‌دهید عامل آن را تخریب کند و سپس آن را حذف می‌کنید. Dormice یک سطح پایین‌تر قرار دارد: این یک API اجرایی است که برنامه شما زمانی که کد را در اختیار دارد و به مکانی امن برای اجرای آن نیاز دارد، فراخوانی می‌کند. زمانی که یک ماشین کامل واحد کاری شماست، از ماشین مجازی یک‌بارمصرف استفاده کنید. زمانی که یک فراخوانی exec واحد کاری شماست و می‌خواهید روزانه صدها مورد از آن را بدون داشتن صدها ماشین مجازی انجام دهید، از Dormice استفاده کنید.

این پروژه خود را با E2B سازگار می‌داند. E2B یک سرویس sandbox میزبانی‌شده است که کتابخانه کلاینت آن توسط بسیاری از فریم‌ورک‌های عامل استفاده می‌شود. Dormice همان پروتکل را تحت پیشوندهای URL اختصاصی خود ارائه می‌دهد، بنابراین برنامه‌ای که برای پکیج رسمی e2b نوشته شده است، هنگام اشاره به سرور شخصی شما همچنان کار می‌کند. کد برنامه تغییری نمی‌کند. فقط دو URL و یک پیشوند API key تغییر می‌کنند.

معنای عملی «SQLite برای sandboxهای عامل» چیست

SQLite یک پایگاه داده است که آن را به جای سرویسی که مدیریت می‌کنید، در برنامه خود تعبیه (embed) می‌کنید؛ Dormice مستقیماً از همین مقایسه وام گرفته است. یک دیمون (daemon) برای هر ماشین، یک فایل SQLite برای دفتر کل آن، و یک پورت TCP، به همراه یک gateway کوچک که در کنار آن نصب شده و کنسول وب را ارائه می‌دهد. بدون Kubernetes، بدون سرور پایگاه داده خارجی. دیمون یک قفل انحصاری در کنار دفتر کل خود ایجاد می‌کند، بنابراین دیمون دوم روی همان ماشین به جای تقسیم بی‌سروصدای وضعیت، از اجرا خودداری می‌کند. هر sandbox روی ماشینی که در آن ایجاد شده، باقی می‌ماند. فایل README اکنون یک ناوگان (fleet) را به عنوان یک gateway به اضافه ماشین‌های موجود در شبکه خصوصی آن توصیف می‌کند، اما همچنان تأکید دارد که اگر به sandboxهایی نیاز دارید که بین ماشین‌ها جابجا شوند یا ناوگانی در مناطق جغرافیایی مختلف داشته باشید، باید گزینه دیگری انتخاب کنید و بهتر است به این توصیه توجه کنید.

نیمه دوم این ایده درباره هزینه است. یک sandbox میزبانی‌شده (hosted) برای هر ثانیه از عمر خود هزینه دریافت می‌کند، بنابراین sandboxهای میزبانی‌شده ذاتاً یک‌بارمصرف هستند. Dormice روی سخت‌افزاری اجرا می‌شود که از قبل برای آن هزینه پرداخت کرده‌اید، بنابراین sandboxهای آن دائمی هستند و هرچه بیشتر بدون استفاده بمانند، ارزان‌تر می‌شوند. یک sandbox مرحله‌به‌مرحله به حالت خنک (cool down) می‌رود: فعال، سپس فریز شده، سپس متوقف شده و در نهایت آرشیو شده. هر درخواست acquire آن را از هر مرحله‌ای که به آن رسیده باشد، دوباره به بالا بازمی‌گرداند.

فریز کردن بخشی است که ارزش درک کردن دارد، زیرا همان چیزی است که نگهداری sandbox هر عامل را برای همیشه مقرون‌به‌صرفه می‌کند. این‌ها ارقام منتشرشده توسط خود پروژه هستند که روی سخت‌افزار آن‌ها اندازه‌گیری شده‌اند و نه روی سخت‌افزار شما.

نمودارOne idle sandbox before and after freezing, figures published by the project
داده‌های پشت این نمودار
[
  {
    "label": "Active, holding 1 GiB",
    "resident_memory_mib": 1024,
    "wake_ms": 0
  },
  {
    "label": "Frozen",
    "resident_memory_mib": 5,
    "wake_ms": 50
  }
]

یک sandbox بیکار که 1024 مگابایت حافظه در اختیار دارد، پس از فریز شدن به 5 مگابایت حافظه مقیم (resident) کاهش می‌یابد و در حدود 50 میلی‌ثانیه دوباره فعال می‌شود. پردازش‌ها در همان وضعیت تعلیق و از سر گرفته می‌شوند، بنابراین یک عامل با عمر طولانی، وضعیت shell و کارهای نیمه‌تمام خود را در طول فرآیند فریز حفظ می‌کند. پیش از برنامه‌ریزی ظرفیت بر اساس این اعداد، آن‌ها را روی میزبان خود بازتولید کنید.

پیش‌نیازهای میزبان پیش از نصب

میزبان باید سیستم‌عامل Ubuntu یا Debian روی معماری x86_64 باشد و نصب‌کننده به دسترسی root نیاز دارد. daemon در زمان اجرا دسترسی root را حفظ می‌کند، زیرا عملیات loop mount انجام داده و در cgroups می‌نویسد.

سندباکس‌ها تحت Docker با استفاده از gVisor اجرا می‌شوند (یک container runtime که یک هسته در فضای کاربری میان کانتینر و هسته میزبان قرار می‌دهد) که runtime مورد نیاز هر سندباکس را از طریق runsc تأمین می‌کند. daemon به Node نسخه 22 یا جدیدتر نیاز دارد. اگر Node سیستم شما از قبل نسخه 22 یا جدیدتر باشد، نصب‌کننده از همان استفاده می‌کند؛ تنها در صورتی که Node موجود نباشد یا قدیمی‌تر باشد، نصب‌کننده نسخه اختصاصی خود را دانلود، checksum آن را تأیید و در مسیر /opt استخراج می‌کند.

وجود Swap الزامی است و مقدار vm.swappiness باید روی 100 تنظیم شود. این یک توصیه برای بهینه‌سازی نیست، بلکه یک الزام عملکردی است. مکانیزم فریز کردن (freezing) با انتقال حافظه یک سندباکس غیرفعال به swap کار می‌کند؛ gVisor حافظه سندباکس را به عنوان حافظه اشتراکی (shared memory) نگه می‌دارد و هسته در مقدار پیش‌فرض swappiness، حافظه اشتراکی را swap نمی‌کند. طبق اندازه‌گیری‌های پروژه، در مقدار پیش‌فرض 0 بایت حافظه آزاد شد، در حالی که در مقدار 100، حدود 99.5 درصد حافظه بازیابی شد. مقداری که هسته واقعاً استفاده می‌کند را بررسی کنید، زیرا برخی ایمیج‌های ابری مقدار vm.swappiness = 0 را در فایلی قرار می‌دهند که احتمالاً هرگز به فکر خواندن آن نخواهید افتاد.

sysctl vm.swappiness
swapon --show

دستور sysctl vm.swappiness باید مقدار vm.swappiness = 100 را چاپ کند و swapon --show باید یک swapfile را فهرست نماید. اگر swappiness مقدار 0 را نشان دهد، هر عملیات فریز کردن بی‌اثر خواهد بود و شما مجبور خواهید بود برای تمام سندباکس‌های غیرفعال، هزینه کامل حافظه را بپردازید.

نصب Dormice روی Ubuntu

روش نصب مستندشده، ارسال یک دستور به bash است:

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

پیش از اجرا، آن را دریافت و مطالعه کنید. این اسکریپت با دسترسی root اجرا می‌شود و میزبان شما را تغییر می‌دهد: اگر Docker نصب نباشد آن را نصب می‌کند، gVisor و Caddy را با بررسی checksum دانلود می‌کند، اگر میزبان swap نداشته باشد یک swapfile می‌سازد، unitهای systemd را برای daemon، درگاه (gateway) و رجیستری ایمیج می‌نویسد و قوانین فایروال را اعمال می‌کند.

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 را تعیین می‌کند و مقدار پیش‌فرض آن 16 است که برای یک VPS کوچک، فضای دیسک زیادی را اشغال می‌کند. --mirror cn دانلودها را به mirrorهایی تغییر می‌دهد که از داخل چین در دسترس هستند. اجرای مجدد نصب‌کننده، کد را به‌روزرسانی کرده و انحرافات پیکربندی را اصلاح می‌کند؛ این کار هرگز API token شما را تغییر نمی‌دهد.

کد در /opt/dormice، پیکربندی در /etc/dormice/env (به‌علاوه /etc/dormice/gateway.env برای درگاه)، داده‌های sandbox در /var/lib/dormice و دستورات dormice و dor در /usr/local/bin قرار می‌گیرند. نصب‌کننده در حین نصب، API token را تولید کرده و با مجوز 600 در /etc/dormice/env می‌نویسد؛ همین مقدار در فایل درگاه نیز قرار می‌گیرد.

هیچ نسخه تگ‌شده‌ای برای نصب وجود ندارد. تا تاریخ 12 اکتبر 2026، مخزن فاقد تگ‌های git و GitHub releases است، بنابراین نصب‌کننده main را clone می‌کند و شما آخرین کدی که همان روز اضافه شده را دریافت می‌کنید. بنابراین، ثابت نگه‌داشتن نسخه (pinning) به معنای یادداشت کردن commitای است که واقعاً نصب کرده‌اید.

git -C /opt/dormice rev-parse HEAD

آن hash را در یادداشت‌های استقرار خود ذخیره کنید، زیرا دقیقاً مشخص می‌کند چه کدی را اجرا می‌کنید. این به تنهایی راه بازگشت نیست: پردازش‌های جدید هنگام شروع، مهاجرت‌های پایگاه داده (database migrations) را اعمال می‌کنند و مستندات ارتقا می‌گویند که مهاجرت با اجرای مجدد یک نصب‌کننده قدیمی معکوس نمی‌شود. پیش از راه‌اندازی مجدد هر چیزی، نصب‌کننده از هر دو پایگاه داده در /var/lib/dormice/backups/ snapshot می‌گیرد و سه مورد اخیر را نگه می‌دارد. این snapshotها راه مستندشده برای بازگشت پس از یک ارتقای ناموفق هستند، بنابراین پیش از ارتقای بعدی، جدیدترین آن‌ها را از سرور کپی کنید.

نصب‌کننده با اجرای dor doctor به پایان می‌رسد؛ یک بررسی میزبان فقط‌خواندنی که کانتینرهای واقعی gVisor را اجرا می‌کند تا به جای اعتماد به لیست بسته‌ها، از عملکرد runtime اطمینان حاصل کند. هر زمان که daemon دچار مشکل شد، دوباره آن را اجرا کنید.

sudo dor doctor
systemctl is-active dormice

systemctl is-active dormice باید active را چاپ کند. اگر failed را چاپ کرد، journalctl -u dormice -n 50 دلیل آن را نشان می‌دهد و شکست در شروع معمولاً به دلیل swap یا پیش‌نیازهای gVisor است، نه خود daemon.

نصب‌کننده همچنین Caddy را روی سیستم قرار می‌دهد، بنابراین پیش از آنکه تصور کنید کار فایروال تمام شده، بررسی کنید چه چیزی در حال گوش دادن (listening) است.

sudo ss -lntp

این daemon همیشه روی 127.0.0.1 متصل می‌شود و طبق طراحی، تنظیمی برای تغییر آن آدرس وجود ندارد. فقط پورت تغییر می‌کند: DORMICE_PORT به‌طور پیش‌فرض 3676 است. درگاه (gateway) در کنار آن، از همین قاعده روی 127.0.0.1:3677 پیروی می‌کند، با DORMICE_GATEWAY_PORT برای پورت و عمداً هیچ تنظیمی برای میزبان ندارد. دسترسی به هر یک از این‌ها از لپ‌تاپ شما یک اقدام آگاهانه است و ارزان‌ترین راه، یک تونل SSH است که هر دو پورت را forward می‌کند.

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

با باز بودن تونل، http://127.0.0.1:3677/console روی لپ‌تاپ شما کنسول وب است که توسط درگاه ارائه می‌شود. در اولین بازدید، با وارد کردن API token ثابت می‌کنید که اپراتور هستید، سپس یک نام کاربری و رمز عبور برای کنسول تعیین می‌کنید. ورود به سیستم یک کوکی session با ویژگی httpOnly ایجاد می‌کند که 7 روز اعتبار دارد، جاوا اسکریپت صفحه نمی‌تواند آن را بخواند و کنسول هرگز token را نمایش نمی‌دهد. صفحه Connect در آنجا، قطعه‌کدهای کلاینت آماده برای کپی و پیست را چاپ می‌کند که از قبل به endpoint خودتان اشاره دارند.

ایجاد یک sandbox و اجرای کد در آن

یک عملیات برای ایجاد sandbox وجود دارد: acquire. این عملیات idempotent است، بنابراین یک کلید مشخص همیشه sandbox یکسانی را برمی‌گرداند و بسته به نیاز، آن را ایجاد، بیدار، راه‌اندازی یا بازیابی می‌کند. هر فعل دیگری برای کلیدی که قبلاً دیده نشده است، خطای 404 برمی‌گرداند. ابزار dor CLI فاقد فعل acquire است، بنابراین اولین sandbox شما از طریق کنسول یا یک client library ایجاد می‌شود.

مسیر کنسول سریع‌ترین روش است. /console را از طریق تونل باز کنید و یک sandbox با نام my-agent بسازید. پس از آن، 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'

دستور dor sandbox ls هر sandbox را به همراه وضعیت چرخهٔ حیات آن فهرست می‌کند؛ این همان روشی است که می‌توانید تغییر وضعیت آن از active به frozen را مشاهده کنید. دستور dor sandbox exec نسخه Python 3.12 را چاپ می‌کند، زیرا image پیش‌فرض، Ubuntu 24.04 است که در آن Python 3.12، Node 24، git و ripgrep از قبل نصب شده‌اند. بروز خطای احراز هویت به این معنی است که خط توکنی که کپی کرده‌اید، شامل نام متغیر نیز بوده است.

فایل‌ها با dor sandbox push my-agent ./script.py منتقل می‌شوند که در مسیر /home/user/script.py قرار می‌گیرند و dor sandbox pull my-agent notes.txt یکی از آن‌ها را بازمی‌گرداند. دستورات بومی فایل، محدودیت 16 MiB برای هر فایل دارند، در حالی که رابط فایل E2B داده‌ها را stream می‌کند و تنها محدودیت موجود، سهمیه دیسک sandbox است.

تخریب (Destroying) تنها عملیاتی است که باعث از دست رفتن داده‌ها می‌شود. دستور dor sandbox destroy my-agent، sandbox را حذف می‌کند و idempotent است. فایل README اصلی، مهارت agent همراه و README بسته CLI، همگی این عملیات را با همین نام مستند کرده‌اند. با این حال، دستور dor sandbox --help را روی build خود اجرا کنید، زیرا installer مسیر main را ردیابی می‌کند و حجم CLI دائماً در حال افزایش است.

هدایت کدهای موجود E2B به سمت سرور شخصی خود

این همان دلیلی است که باید به آن اهمیت دهید. بسته رسمی e2b از npm، بدون هیچ تغییری، با Dormice ارتباط برقرار می‌کند. این دستور را از روی لپ‌تاپ خود در حالی که تونل SSH باز است اجرا کنید تا هیچ سرویس جدیدی روی سرور شما گوش ندهد.

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

یک اجرای موفق، کد خروجی 0 و 42 را چاپ می‌کند. کلید API همان توکن Dormice شماست که پیشوند e2b_ به ابتدای آن اضافه شده است؛ این همان قالبی است که لایه سازگاری انتظار دارد.

این سازگاری یک پیاده‌سازی ناقص (stub) نیست. استریم کردن stdout و stderr، دستورات پس‌زمینه، PTY تعاملی، URLهای امضاشده برای آپلود و دانلود، نظارت بر دایرکتوری و پروکسی پورت، همگی از طریق بسته رسمی و در برابر یک Docker و gVisor واقعی توسط مجموعه تست‌های end-to-end پروژه بررسی می‌شوند. پیش از مهاجرت هر سرویس واقعی، به چند تفاوت توجه کنید:

  • ساخت Templateها پیاده‌سازی نشده است. Template یک ایمیج داکر است که خودتان می‌سازید و با dor template add ثبت می‌کنید، و Sandbox.create('name') آن را شناسایی می‌کند. نام‌های ثبت‌نشده به جای شبیه‌سازی، خطای 404 برمی‌گردانند.
  • Sandboxهایی که از طریق رابط E2B ایجاد می‌شوند دارای مهلت زمانی (deadline) واقعی هستند، زیرا قواعد E2B آن‌ها را الزامی می‌کند. هیچ مهلت زمانی برای Sandboxهایی که از طریق API بومی ایجاد می‌شوند، اعمال نمی‌شود.
  • یک Sandbox منجمد (frozen)، پردازش‌های خود را حفظ کرده و آن‌ها را از همان نقطه میانی از سر می‌گیرد؛ بنابراین pause و resume در اینجا به معنای توقف و cold start که ممکن است به آن عادت داشته باشید، نیست.

آنچه sandbox متوقف می‌کند و آنچه متوقف نمی‌کند

gVisor فراخوانی‌های سیستمی کانتینر را در فضای کاربری (userspace) رهگیری کرده و خود به آن‌ها پاسخ می‌دهد، بنابراین کد موجود در sandbox مستقیماً با هسته (kernel) میزبان شما صحبت نمی‌کند. داخل sandbox، دستورات با کاربر user (uid 1000) اجرا می‌شوند، اما این حساب کاربری دسترسی sudo بدون رمز عبور دارد، بنابراین دسترسی root در داخل sandbox برای هر کدی که آن را درخواست کند، فراهم است. uid را به عنوان یک لایه حفاظتی در نظر نگیرید: مستندات پروژه به‌صراحت بیان می‌کنند که مرز امنیتی، gVisor است نه uid، و sandboxای که خود را ارتقای سطح دسترسی می‌دهد، همچنان نمی‌تواند به هسته میزبان دسترسی پیدا کند. این موضوع موارد عادی را پوشش می‌دهد: اسکریپتی که rm -rf / را اجرا می‌کند، دیسک را پر می‌کند یا با fork کردن باعث از کار افتادن سرویس‌ها می‌شود، فقط به sandbox خود آسیب می‌زند و در همان‌جا متوقف می‌شود.

در اینجا مواردی که متوقف نمی‌شوند آمده است. مدیریت هر یک از این موارد بر عهده شماست.

  • یک sandbox دسترسی شبکه خروجی فعال دارد. کد تولیدشده می‌تواند هر چیزی را دانلود کرده و هر داده‌ای که پیدا می‌کند را ارسال کند. سخت‌سازی شبکه در نصب‌کننده، دو مورد خاص را پوشش می‌دهد: ترافیک کانتینر به سرویس متادیتای ابری در آدرس‌های 169.254.0.0/16 و 100.100.100.200 (آدرسی که Alibaba Cloud استفاده می‌کند و جایی است که سرویس ابری، اعتبارنامه‌های instance را به هر چیزی که به آن دسترسی داشته باشد می‌دهد) را مسدود می‌کند و ترافیک بین کانتینرها را با "icc": false در daemon.json داکر غیرفعال می‌کند. هیچ چیز دیگری مسدود نمی‌شود. sudo iptables -S DOCKER-USER را مطالعه کنید و قوانین DROP خود را برای محدوده‌های خصوصی که sandbox نباید به آن‌ها دسترسی داشته باشد، اضافه کنید.
  • داکر قوانین خود را پیش از فایروال شما اعمال می‌کند، بنابراین یک پورت کانتینر که منتشر (publish) شده باشد، می‌تواند از اینترنت پاسخ دهد، حتی اگر ufw اصرار داشته باشد که آن پورت بسته است. پیش از آنکه هر چیزی را روی این میزبان در معرض دید قرار دهید، نحوه انتشار پورت‌های داکر با دور زدن ufw و اصول اولیه فایروال ufw برای VPS را مطالعه کنید.
  • gVisor یک هسته در فضای کاربری است، نه یک hypervisor. این یک انتخاب آگاهانه است، زیرا قابلیت freeze کردن مستلزم آن است که sandboxها به صورت process باشند و الزام به استفاده از KVM باعث می‌شود که این ابزار در هر جایی قابل نصب نباشد. اگر مدل تهدید شما نیازمند مجازی‌سازی سخت‌افزاری است، از ایزولاسیون در سطح Firecracker استفاده کنید و هزینه‌های عملیاتی آن را بپذیرید.
  • توکن API تنها مرز امنیتی در سمت کلاینت است. هر چیزی که DORMICE_API_TOKEN را در اختیار داشته باشد، می‌تواند تمام sandboxهای موجود روی دستگاه را ایجاد، مشاهده یا نابود کند. برای پردازش agent، یک کاربر با حداقل دسترسی روی VPS ایجاد کنید و با توکن همانند یک کلید SSH رفتار کنید. عادت‌های ذکر شده در اجرای ایمن Claude Code روی VPS مستقیماً در اینجا نیز کاربرد دارند.

خود daemon با دسترسی root روی میزبان شما اجرا می‌شود. gVisor میزبان را در برابر کد داخل sandbox محافظت می‌کند، اما هیچ چیزی میزبان را در برابر خود daemon یا کسی که توکن آن را در اختیار دارد، محافظت نمی‌کند. بنابراین دستگاهی که Dormice را اجرا می‌کند باید فقط به همین کار اختصاص داشته باشد. اگر agent شما از طریق MCP (پروتکل مدل) به ابزارهایی دسترسی دارد، به همان دلیل، آن سرورهای MCP را روی یک VPS جداگانه نگهداری کنید.

در 4 گیگابایت و 8 گیگابایت رم، چند sandbox جای می‌گیرد؟

دو عامل حافظه را مصرف می‌کنند: پایهٔ سیستم‌عامل میزبان و مجموعهٔ کاری (working set) هر sandbox که در حال حاضر فعال است. حدود 1 گیگابایت را برای Ubuntu، Docker و دیمون رزرو کنید، سپس باقی‌مانده را بر میزان مصرف واقعی یکی از sandboxهای خود تقسیم کنید. یک sandbox که اسکریپت پایتونی را اجرا می‌کند که چند فایل را می‌خواند، حدود 200 تا 300 مگابایت مصرف دارد. موردی که کامپایلر یا یک مجموعه تست کامل را اجرا می‌کند، ممکن است از یک گیبی‌بایت فراتر رود.

نمودارConcurrent sandboxes by host RAM, arithmetic after a 1 GB host reserve
داده‌های پشت این نمودار
[
  {
    "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 گیگابایت رم می‌تواند 6 sandbox را به‌طور همزمان فعال نگه دارد، اگر هر کدام 512 مگابایت مصرف کنند، یا 3 اگر هر کدام یک گیبی‌بایت کامل مصرف کنند. یک VPS با 8 گیگابایت رم این تعداد را به 14 و 7 می‌رساند. این‌ها سقف‌های کاری همزمان هستند و محاسباتی‌اند، نه یک بنچمارک؛ بنابراین هنگام اجرای بار کاری خود، free -m را مانیتور کنید.

sandboxهای فریز شده (Frozen) به‌جای رم، توسط swap محدود می‌شوند که هدف اصلی این طراحی است. یک sandbox فریز شده که یک گیبی‌بایت را اشغال کرده بود، تقریباً همان مقدار را در swap نگه می‌دارد و تقریباً هیچ فضای residentای اشغال نمی‌کند؛ بنابراین فایل swap پیش‌فرض 16 گیگابایتی نصب‌کننده، حدود 16 از آن‌ها را در خود جای می‌دهد. فراتر از آن، آن‌ها باید به وضعیت متوقف (stopped) برسند که در آن فقط فضای دیسک را اشغال می‌کنند. در اینجا دیسک محدودیت واقعی در بلندمدت است: هر sandbox سیستم فایل خود را حفظ می‌کند و چند ده agent که هر کدام یک دایرکتوری node_modules دارند، یک حجم کوچک را بسیار زودتر از آنکه حافظه به چالش تبدیل شود، پر خواهند کرد.

انجماد، توقف، آرشیو: تنظیمات چرخه حیات

مقادیر پیش‌فرض عبارتند از: انجماد پس از 10 دقیقه بیکاری، توقف پس از 3 روز، و آرشیو پس از 7 روز در صورت پیکربندی آرشیو. تنظیم stopAfterSeconds روی null به شما یک agent مقیم می‌دهد: ممکن است هنگام بیکاری منجمد شود، اما هرگز cold start نمی‌شود.

آرشیو کردن اختیاری است و daemon در این مورد صادقانه عمل می‌کند. یک فضای ذخیره‌سازی سازگار با S3 را در صفحه تنظیمات کنسول پیکربندی کنید (چهار متغیر DORMICE_S3_* همچنان وجود دارند، اما فقط به عنوان مقادیر اولیه برای اولین بوت gateway عمل می‌کنند)؛ در این صورت دیسک یک sandbox متوقف‌شده با tar و zstd فشرده شده، به bucket ارسال می‌شود و فضای آن به‌صورت محلی آزاد می‌گردد. آن bucket می‌تواند یک bucket MinIO باشد که خودتان میزبانی می‌کنید و ممکن است روی دستگاه دیگری از شما قرار داشته باشد. اگر فضای ذخیره‌سازی را پیکربندی نکنید، sandboxها برای همیشه در وضعیت متوقف باقی می‌مانند و سیاستی که درخواست آرشیو داشته باشد، به جای نادیده گرفته شدن بی‌سروصدا، رد می‌شود. بازیابی‌ها به جای حالت بی‌صدا، قابل مشاهده هستند: درخواست acquire بعدی بلافاصله با وضعیت restoring و یک مقدار progress پاسخ می‌دهد و پس از بازگشت دیسک، به وضعیت ready تغییر حالت می‌دهد.

آیا باید در حال حاضر به آن تکیه کرد؟

پاسخ صریح: برای هیچ چیزی که نتوانید دوباره آن را بازسازی کنید، از آن استفاده نکنید. این مخزن در تاریخ 8 ژوئیه 2026 ایجاد شده است. تا تاریخ 12 اکتبر 2026، این پروژه 1,509 ستاره، 109 فورک، مجوز Apache-2.0 و هیچ نسخه تگ‌گذاری‌شده‌ای ندارد. در خط وضعیت فایل README نیز ذکر شده که هیچ بخشی از آن برای محیط عملیاتی (production) آماده نیست.

این ترکیب، نوع خاصی از ریسک را به همراه دارد. کدها دائماً در حال تغییر هستند، زیرا نصب‌کننده، main را دنبال می‌کند. رابط کاربری هنوز در حال تثبیت است: مستندات اکنون یک gateway را در مقابل daemon توصیف می‌کنند که پورت، فایل پیکربندی و پایگاه داده مخصوص به خود را دارد. همچنین پروژه‌ای که حدود سه ماه از عمر آن می‌گذرد ممکن است به سادگی متوقف شود، زیرا هیچ بند قانونی در مجوز پروژه، کسی را ملزم به ادامه توسعه نمی‌کند.

آنچه این ریسک را قابل‌تحمل می‌کند، سازگاری با E2B است. برنامه شما با پروتکلی صحبت می‌کند که یک پیاده‌سازی میزبانی‌شده (hosted) در پشت آن قرار دارد؛ بنابراین اگر Dormice متوقف شود، می‌توانید دو URL را تغییر دهید و به کار خود ادامه دهید. عامل (agent) خود را بر اساس سطح دسترسی E2B بنویسید و نه API بومی (native)، تا بتوانید این مسیر خروج را حفظ کنید. بسته بومی @dormice/sdk نیز هنوز در npm قرار نگرفته است، بنابراین استفاده از آن به معنای ساختن بسته از روی مخزن است که این خود دلیل دوم برای شروع کار با مسیر سازگار است.

آن را در جایی اجرا کنید که از دست رفتن آن برایتان هزینه‌ای نداشته باشد. میزبان را با استفاده از اسکریپت بازسازی کنید، توکن‌ها را از تمامی پرامپت‌ها و commitها دور نگه دارید و هر چیزی که ارزش نگهداری دارد را طبق برنامه پشتیبان‌گیری خودتان، از محیط‌های sandbox خارج کنید.

FAQ

آیا Dormice برای محیط عملیاتی (production) آماده است؟

خیر، و خود پروژه نیز به این موضوع اشاره کرده است. در خط وضعیت فایل README ذکر شده که هیچ‌کدام از بخش‌های آن هنوز برای محیط عملیاتی آماده نیستند. تا تاریخ 12 October 2026، این مخزن حدود سه ماه قدمت دارد، فاقد git tag و release است، بنابراین هیچ شماره نسخه‌ای برای ثابت نگه‌داشتن (pin) وجود ندارد. نصب‌کننده، شاخه main را کلون می‌کند، به این معنی که هر بار اجرا، جدیدترین commit را دریافت می‌کنید. پس از هر بار نصب، رکورد git -C /opt/dormice rev-parse HEAD را ثبت کنید، از snapshotهای دیتابیس که نصب‌کننده در /var/lib/dormice/backups/ می‌نویسد نسخه پشتیبان تهیه کنید و هر داده ارزشمندی را خارج از sandboxها نگهداری کنید.

تفاوت Dormice با در اختیار قرار دادن یک VM یک‌بارمصرف به agent من چیست؟

یک VM یک‌بارمصرف، ماشینی با دسترسی SSH است که برای یک نشست (session) ایجاد کرده و پس از آن حذف می‌کنید. Dormice یک API برای اجرا است: برنامه شما acquire و سپس exec را فراخوانی می‌کند و stdout و کد خروجی را بدون نیاز به نشست shell در میان، دریافت می‌کند. VM برای انسان یا agentای مناسب است که می‌خواهد برای مدتی یک کامپیوتر کامل در اختیار داشته باشد. Dormice برای برنامه‌ای مناسب است که کدهای تولیدشده را چندین بار در روز اجرا می‌کند و نمی‌خواهد در هر بار اجرا، درگیر تنظیمات و پاک‌سازی‌های مربوط به یک ماشین کامل شود.

آیا SDK رسمی E2B واقعاً بدون تغییر کد کار می‌کند؟

بله، با تغییرات در پیکربندی. apiUrl و sandboxUrl را به سمت /e2b/api و /e2b/envd در daemon خود هدایت کنید و توکن Dormice خود را با پیشوند e2b_ به عنوان API key ارسال کنید. اجرای دستورات، نشست‌های PTY، انتقال فایل، URLهای امضاشده و port proxy همگی توسط مجموعه تست‌های end-to-end پروژه که از طریق پکیج رسمی اجرا می‌شوند، پوشش داده شده‌اند. ساخت template شکاف قابل‌توجهی است: e2b template build پیاده‌سازی نشده است، بنابراین یک template در واقع یک docker image است که شما می‌سازید و با dor template add ثبت می‌کنید.

چند sandbox روی یک VPS با 4 GB رم جای می‌گیرد؟

اگر هر sandbox از 512 MiB استفاده کند، حدود 6 عدد به‌طور همزمان فعال می‌مانند، یا اگر هر کدام از یک گیگابایت کامل استفاده کنند، 3 عدد؛ این محاسبات پس از رزرو حدود 1 GB برای سیستم‌عامل، Docker و daemon انجام شده است. sandboxهای فریز شده (frozen) توسط swap محدود می‌شوند، بنابراین فایل swap پیش‌فرض 16 GB در نصب‌کننده، حدود 16 sandbox که هر کدام یک گیگابایت اشغال کرده‌اند را در خود جای می‌دهد. ظرفیت خود را با free -m تحت بار واقعی اندازه‌گیری کنید، زیرا sandboxای که یک مجموعه تست را اجرا می‌کند، چندین برابر بیشتر از sandboxای که یک اسکریپت کوچک را اجرا می‌کند، منابع مصرف می‌کند.

چرا Dormice نیاز دارد که vm.swappiness روی 100 تنظیم شود؟

فریز کردن یک sandbox به معنای انتقال حافظه غیرفعال آن به swap است. gVisor حافظه sandbox را به صورت shared memory نگه می‌دارد و هسته Linux در حالت swappiness پیش‌فرض، shared memory را swap نمی‌کند. بنابراین در حالت پیش‌فرض، فریز کردن هیچ فضایی را بازیابی نمی‌کند و sandbox همچنان هزینه حافظه کامل را تحمیل می‌کند. این پروژه در حالت پیش‌فرض 0 بایت بازیابی و در حالت 100، حدود 99.5 درصد بازیابی را اندازه‌گیری کرده است. مقدار مؤثر را به جای خواندن فایل‌های پیکربندی، با sysctl vm.swappiness بررسی کنید، زیرا برخی از imageهای ابری با مقدار 0 عرضه می‌شوند.

آیا این مقاله مفید بود؟