ثبّت Dormice لتشغيل بيئات وكلاء معزولة على VPS
شغّل Dormice على خادم VPS واحد تملكه، مع توافق E2B. تعرّف إلى التثبيت، وتنفيذ الكود، واختبار العزل، وحساب سعة الخادم المطلوبة.
ما هو Dormice وما ليس عليه
Dormice هو sandbox مستضاف ذاتياً للوكلاء: daemon واحد على VPS يعمل بنظام Linux وتملكه أنت، ويستدعيه كود الوكيل عبر HTTP لتشغيل تعليمات برمجية غير موثوقة داخل container معزول. يطلب برنامجك sandbox بالاسم، ويحصل على sandbox نفسه مهما كانت حالته السابقة، ثم يشغّل أمراً داخله ويقرأ الناتج. إنّ sandbox مورد برمجي، وليس جهازاً تسجّل الدخول إليه.
يختلف ذلك عن منح الوكيل حاسوباً كاملاً. إنّ آلة VM مؤقتة لوكيل برمجي هي جهاز تتصل به عبر SSH، وتترك الوكيل يعبث به، ثم تحذفه. يعمل Dormice على مستوى أدنى: إنّه API للتنفيذ يستدعيه برنامجك عندما يكون لديه كود بالفعل ويحتاج إلى مكان آمن لتشغيله. استخدم VM مؤقتة عندما تكون الآلة الكاملة هي وحدة العمل. واستخدم Dormice عندما يكون استدعاء exec واحداً هو وحدة العمل، وتريد تنفيذ مئة استدعاء منه يومياً من دون إنشاء مئة VM.
يصف المشروع نفسه بأنّه متوافق مع E2B. E2B هي خدمة sandbox مستضافة تستورد العديد من أطر عمل الوكلاء مكتبة العميل الخاصة بها. يوفّر Dormice البروتوكول نفسه تحت بادئات URL الخاصة به، لذلك يستمر تطبيق مكتوب باستخدام الحزمة الرسمية e2b في العمل عند توجيهه إلى جهازك الخاص. لا يتغير كود التطبيق. يتغير عنوانا URL وبادئة مفتاح API واحدة.
ما المقصود عملياً بعبارة "SQLite لصناديق الوكلاء المعزولة"
SQLite هي قاعدة بيانات تدمجها في تطبيقك بدلاً من تشغيل خدمة مستقلة، وDormice يستعير هذه المقارنة مباشرة. يعمل daemon واحد لكل جهاز، ويستخدم ملف SQLite واحداً لدفتر حالته، ويستمع على منفذ TCP واحد، مع بوابة صغيرة مثبتة بجانبه وتعرض وحدة التحكم على الويب. لا تحتاج إلى Kubernetes أو خادم قاعدة بيانات خارجي. يضع daemon قفلاً حصرياً بجانب دفتر حالته، لذلك يرفض daemon ثانٍ على الجهاز نفسه البدء بدلاً من تقسيم الحالة بصمت. يعمل كل sandbox على الجهاز الذي أُنشئ عليه. يصف README الآن الأسطول بأنه بوابة واحدة مع الأجهزة الموجودة على شبكته الخاصة، لكنه يذكر أيضاً أنك إذا احتجت إلى صناديق sandbox تنتقل بين الأجهزة، أو إلى أسطول موزع بين المناطق، فعليك اختيار حل آخر، وينبغي أن تستمع إلى هذه التوصية.
يتعلق النصف الثاني من الفكرة بالتكلفة. تفرض sandbox المستضافة رسوماً عن كل ثانية تكون فيها موجودة، لذلك صُممت صناديق sandbox المستضافة لتكون مؤقتة. يعمل Dormice على عتاد تدفع تكلفته مسبقاً، لذلك تكون صناديق sandbox فيه دائمة وتنخفض تكلفتها كلما بقيت دون تغيير مدة أطول. تنتقل sandbox إلى حالة أقل نشاطاً درجة واحدة في كل مرة: نشطة، ثم مجمّدة، ثم متوقفة، ثم مؤرشفة. يعيد أي acquire تشغيلها من الدرجة التي وصلت إليها.
التجميد هو الجزء الذي يستحق الفهم، لأنه ما يجعل الاحتفاظ بـsandbox لكل وكيل إلى أجل غير محدد أمراً ميسور التكلفة. هذه أرقام المشروع المنشورة، وقد قيسَت على عتاده، وليس على عتادك.
البيانات وراء هذا الرسم البياني
[
{
"label": "Active, holding 1 GiB",
"resident_memory_mib": 1024,
"wake_ms": 0
},
{
"label": "Frozen",
"resident_memory_mib": 5,
"wake_ms": 50
}
]تنخفض الذاكرة المقيمة لـsandbox الخاملة التي تستخدم 1024 MiB إلى 5 MiB بعد تجميدها، وتعود للعمل خلال نحو 50 ms. تتوقف العمليات مؤقتاً ثم تستأنف في موضعها، لذلك يحتفظ وكيل طويل التشغيل بحالة shell والعمل غير المكتمل عبر عملية التجميد. أعد إنتاج ذلك على مضيفك قبل أن تبني خطة السعة على أساسه.
ما يحتاج إليه المضيف قبل التثبيت
يجب أن يعمل المضيف بنظام Ubuntu أو Debian على x86_64، ويحتاج برنامج التثبيت إلى root. يحتفظ البرنامج الخدمي بامتيازات root أثناء التشغيل لأنه ينفّذ عمليات loop mount ويكتب في cgroups.
تعمل بيئات العزل داخل Docker باستخدام gVisor، وهو بيئة تشغيل للحاويات تضع نواة في مساحة المستخدم بين الحاوية ونواة المضيف. يوفّر ذلك بيئة التشغيل runsc التي تستخدمها كل بيئة عزل. يشغّل Node 22 أو إصدار أحدث البرنامج الخدمي. إذا كان Node المثبّت على النظام هو 22 أو أحدث، يعيد برنامج التثبيت استخدامه. أما إذا كان مفقوداً أو أقدم، فينزّل برنامج التثبيت نسخته المثبتة، ويتحقق من checksum الخاصة بها، ويفكّها ضمن /opt.
يجب أن تكون swap موجودة، ويجب أن تكون قيمة vm.swappiness هي 100. هذا ليس إعداداً لتحسين الأداء، بل متطلب وظيفي. تعمل عملية التجميد بإخراج ذاكرة بيئة العزل الخاملة إلى swap. يحتفظ gVisor بذاكرة بيئة العزل كذاكرة مشتركة، ولن تنقل النواة الذاكرة المشتركة إلى swap عند قيمة swappiness الافتراضية. قاس المشروع استعادة 0 بايت عند القيمة الافتراضية، واستعادة 99.5 بالمئة عند القيمة 100. تحقّق من القيمة التي تستخدمها النواة فعلياً، لأن بعض صور السحابة تضع vm.swappiness = 0 في ملف لن يخطر لك عادةً أن تقرأه.
sysctl vm.swappiness
swapon --showيجب أن يطبع sysctl vm.swappiness القيمة vm.swappiness = 100، ويجب أن يعرض swapon --show ملف swap. إذا طبع swappiness القيمة 0، فلن تؤدي أي عملية تجميد إلى شيء، وستظل تدفع تكلفة الذاكرة الكاملة لكل بيئة عزل خاملة.
ثبّت Dormice على Ubuntu
التثبيت الموثّق هو تمرير مخرجات أمر واحد إلى bash:
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh | bashنزّل هذا السكربت واقرأه قبل تشغيله. يعمل السكربت بصلاحيات root ويعيد ترتيب إعدادات الخادم: يثبّت Docker إذا لم يكن مثبتاً، وينزّل gVisor وCaddy مع التحقق من checksum، وينشئ swapfile إذا لم يكن للخادم swap، ويكتب وحدات 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 مصادر التنزيل إلى مرايا يمكن الوصول إليها من الصين القارية. تؤدي إعادة تشغيل المثبّت إلى ترقية الكود وإصلاح الاختلافات، لكنها لا تدوّر API token أبداً.
يوضع الكود في /opt/dormice، والإعدادات في /etc/dormice/env، إضافة إلى /etc/dormice/gateway.env الخاص بالـgateway، وبيانات sandbox في /var/lib/dormice، بينما يوضع الأمران dormice وdor في /usr/local/bin. ينشئ المثبّت API token أثناء التثبيت ويكتبه في /etc/dormice/env بالوضع 600، وتُكتب القيمة نفسها في ملف الـgateway.
لا يوجد إصدار موسوم يمكن التثبيت عليه. حتى 12 October 2026، لا يحتوي المستودع على git tags ولا على إصدارات في GitHub، لذلك يستنسخ المثبّت main وتحصل على كل ما أُضيف إلى المستودع في ذلك الصباح. لذلك يعني تثبيت إصدار محدد أن تسجّل commit الذي ثبّتَّه فعلياً.
git -C /opt/dormice rev-parse HEADاحفظ ذلك الهاش مع ملاحظات النشر، لأنه يحدد الكود الذي تشغّله بدقة. لكنه لا يوفّر وحده طريقة للرجوع: تطبّق العمليات الجديدة database migrations عند الإقلاع، وتوضح وثائق الترقية أن إعادة تشغيل مثبّت أقدم لا تعكس migration. قبل إعادة تشغيل أي شيء، يحفظ المثبّت snapshots لقاعدتي البيانات في /var/lib/dormice/backups/ ويحتفظ بأحدث ثلاث نسخ. هذه snapshots هي الطريقة الموثّقة للرجوع بعد ترقية فاشلة، لذلك انسخ أحدث نسخة إلى خارج الخادم قبل إجراء ترقية أخرى.
ينهي المثبّت عمله بتشغيل dor doctor، وهو فحص للـhost للقراءة فقط يشغّل حاويات gVisor فعلية لإثبات عمل بيئة التشغيل، بدلاً من الاعتماد على قائمة الحزم. شغّله مرة أخرى كلما تصرّف الـdaemon بشكل غير سليم.
sudo dor doctor
systemctl is-active dormiceيجب أن يطبع systemctl is-active dormice القيمة active. إذا طبع failed، فإن journalctl -u dormice -n 50 يحتوي على السبب، ويكون فشل البدء عادةً ناتجاً عن متطلب swap أو gVisor، وليس عن الـdaemon نفسه.
يثبّت المثبّت Caddy أيضاً على الخادم، لذلك افحص ما يستمع على المنافذ قبل أن تقرر أن إعدادات جدار الحماية اكتملت.
sudo ss -lntpيربط الـdaemon دائماً بالعنوان 127.0.0.1، ولا يوجد إعداد لتغيير هذا العنوان حسب التصميم. يتغير المنفذ فقط: القيمة الافتراضية لـDORMICE_PORT هي 3676. يتبع الـgateway المجاور القاعدة نفسها على 127.0.0.1:3677، مع استخدام DORMICE_GATEWAY_PORT للمنفذ، ومن دون إعداد للـhost عمداً. الوصول إلى أي منهما من حاسوبك المحمول إجراء مقصود، وأبسط طريقة هي نفق SSH يمرّر المنفذين معاً.
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 على حاسوبك المحمول هو وحدة التحكم على الويب التي يقدّمها الـgateway. عند زيارتها للمرة الأولى، تثبت أنك المشغّل بلصق API token مرة واحدة، ثم تعيّن اسم مستخدم وكلمة مرور لوحدة التحكم. يؤدي تسجيل الدخول إلى تعيين session cookie بخاصية httpOnly، صالحة لمدة 7 أيام، ولا تستطيع JavaScript في الصفحة قراءتها، كما لا تعرض وحدة التحكم الـtoken مرة أخرى. تعرض صفحة Connect هناك مقاطع أوامر للعميل جاهزة للنسخ واللصق ومضبوطة مسبقاً لاستخدام endpoint الخاص بك.
إنشاء بيئة معزولة وتنفيذ التعليمات البرمجية فيها
تنشئ عملية واحدة بيئة معزولة: acquire. هذه العملية idempotent، لذلك يعيد المفتاح نفسه دائماً البيئة المعزولة نفسها، مع إنشائها أو إيقاظها أو تشغيلها أو استعادتها حسب الحاجة. يعيد كل فعل آخر الحالة 404 لمفتاح لم يسبق له رؤيته. لا يحتوي dor CLI على الفعل acquire، لذلك تحصل على بيئتك المعزولة الأولى من وحدة التحكم أو من مكتبة عميل.
مسار وحدة التحكم هو الأسرع. افتح /console عبر النفق وأنشئ بيئة معزولة باسم 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 كل بيئة معزولة مع حالة دورة حياتها، وبذلك يمكنك مراقبة انتقال إحداها من الحالة النشطة إلى الحالة المجمدة. يطبع dor sandbox exec إصدار Python 3.12، لأن الصورة الافتراضية هي 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 التدفق، وتترك حصة القرص في البيئة المعزولة الحد الوحيد.
الإتلاف هو الفعل الوحيد الذي يؤدي إلى فقدان البيانات. يزيل dor sandbox destroy my-agent البيئة المعزولة، وهو idempotent، كما توثقه README الرئيسية ومهارة الوكيل المضمّنة وREADME الخاصة بحزمة CLI جميعاً بهذا الاسم نفسه. شغّل dor sandbox --help على بنيتك الخاصة على أي حال، لأن برنامج التثبيت يتتبع main، ولأن CLI يواصل التوسع.
وجّه شفرة E2B الحالية إلى خادمك
هذا هو سبب أهمية ذلك. تتصل حزمة e2b الرسمية من npm، من دون تعديل، بـDormice. شغّل هذا من حاسوبك المحمول مع إبقاء نفق SSH مفتوحاً، حتى لا يبدأ أي شيء جديد بالاستماع على الخادم.
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.tsتعرض العملية السليمة رمز الخروج 0 و42. مفتاح API هو الرمز المميز الخاص بك في Dormice، مع إضافة البادئة e2b_ إليه. هذه هي الصيغة التي تتوقعها طبقة التوافق.
التوافق ليس مجرد هيكل تجريبي. تختبر مجموعة الاختبارات الشاملة للمشروع بث stdout وstderr، والأوامر التي تعمل في الخلفية، وPTY تفاعلياً، وعناوين URL موقعة للرفع والتنزيل، ومراقبة الأدلة، ووكيل المنافذ، وكل ذلك عبر الحزمة الرسمية وباستخدام Docker وgVisor daemon فعليين. توجد بعض الاختلافات المهمة التي ينبغي فهمها قبل ترحيل أي شيء فعلي:
- إنشاء القوالب غير مطبّق. القالب هو docker image تنشئه بنفسك وتسجله باستخدام
dor template add، ثم يحلSandbox.create('name')اسمه. يعيد الاسم غير المسجل 404 بدلاً من التظاهر بوجوده. - تحصل Sandboxes التي تُنشأ عبر واجهة E2B على مهل زمنية فعلية، لأن دلالات E2B تتطلب ذلك. لا تُفرض المهل الزمنية مطلقاً على Sandboxes التي تُنشأ عبر native API.
- تحتفظ Sandbox المجمّدة بعملياتها وتستأنفها من موضع توقفها. لذلك لا تعني الإيقاف والاستئناف هنا الإيقاف ثم البدء البارد الذي قد تكون معتاداً عليه.
ما الذي يمنعه العزل وما الذي لا يمنعه
يعترض gVisor استدعاءات النظام الصادرة من الحاوية في مساحة المستخدم ويعالجها بنفسه، لذلك لا يتصل الكود المعزول مباشرة بنواة مضيفك. داخل العزل، تعمل الأوامر بصفة user (uid 1000)، لكن هذا الحساب يملك sudo من دون كلمة مرور، لذلك يمكن لأي كود يطلب ذلك الحصول على root داخل العزل. لا تعتبر uid وسيلة حماية؛ يوضح المشروع صراحةً أن حد الأمان هو gVisor وليس uid، وأن العزل الذي يرفع صلاحياته لا يزال عاجزاً عن الوصول إلى نواة المضيف. يعالج ذلك الحالة المعتادة: فالبرنامج النصي المُنشأ الذي يشغّل rm -rf / أو يملأ القرص أو ينشئ عمليات فرعية حتى تتوقف إحداها، يضر بالعزل الخاص به ويتوقف عنده.
لكن هذا لا يمنعه. وهذه الأمور تقع على عاتقك.
- يملك العزل اتصالاً صادراً عاملاً بالشبكة. يمكن للكود المُنشأ تنزيل ما يشاء وإرسال كل ما يعثر عليه. تتعامل تقوية الشبكة في برنامج التثبيت مع أمرين محددين: فهي تمنع حركة الحاويات إلى خدمة البيانات الوصفية السحابية على 169.254.0.0/16 وعلى 100.100.100.200، وهو العنوان الذي تستخدمه Alibaba Cloud، حيث تسلّم السحابة بيانات اعتماد المثيل إلى أي جهة تستطيع الوصول إليه، كما تعطل الاتصال بين الحاويات باستخدام
"icc": falseفيdaemon.jsonالخاص بـDocker. لا شيء آخر محظور. اقرأsudo iptables -S DOCKER-USERوأضف قواعد DROP الخاصة بك للنطاقات الخاصة التي لا ينبغي للعزل الوصول إليها. - يضيف Docker قواعده الخاصة قبل قواعد جدارك الناري، لذلك يمكن لمنفذ حاوية منشور الاستجابة من الإنترنت بينما يصرّ ufw على أنه مغلق. اقرأ كيفية نشر Docker للمنافذ متجاوزاً ufw وأساسيات جدار ufw الناري لخادم VPS قبل كشف أي شيء على هذا المضيف.
- gVisor نواة في مساحة المستخدم، وليس برنامج مراقبة افتراضية. وهذا مقايضة مقصودة، لأن freezing يتطلب أن تكون بيئات العزل عمليات، ولأن اشتراط KVM سيمنع تثبيت البرنامج في أي مكان. إذا كان نموذج التهديد لديك يتطلب المحاكاة الافتراضية العتادية، فاستخدم عزلاً من فئة Firecracker وتقبّل الكلفة التشغيلية المصاحبة لذلك.
- رمز API هو حد الأمان الكامل على جانب العميل. يمكن لأي جهة تملك
DORMICE_API_TOKENإنشاء كل بيئة عزل على الجهاز وقراءتها وتدميرها. امنح عملية الوكيل مستخدماً بصلاحيات أقل على خادم VPS خاصاً بها، وتعامل مع الرمز كما تتعامل مع مفتاح SSH. تنطبق ممارسات تشغيل Claude Code بأمان على خادم VPS هنا مباشرةً.
يعمل البرنامج الخفي نفسه بصفة root على مضيفك. يحمي gVisor المضيف من الكود الموجود داخل العزل، ولا يحمي المضيفَ شيءٌ من البرنامج الخفي أو من أي جهة تملك رمزه. لذلك ينبغي أن يكون الجهاز الذي يشغّل Dormice مخصصاً لهذا الغرض فقط. وإذا كان وكيلك يصل أيضاً إلى أدوات عبر MCP (بروتوكول سياق النموذج)، فأبقِ خوادم MCP على خادم VPS منفصل للسبب نفسه.
كم عدد بيئات العزل التي تتسع لها سعة 4 GB و8 GB؟
يستهلك الذاكرة شيئان: الاستهلاك الأساسي للخادم نفسه، ومجموعة العمل لكل بيئة عزل قيد التشغيل حالياً. خصص نحو 1 GB لـUbuntu وDocker والـdaemon، ثم اقسم السعة المتبقية على ما تستهلكه إحدى بيئات العزل فعلياً. تستهلك بيئة عزل تشغّل نص Python يقرأ بضعة ملفات نحو 200 إلى 300 MiB. أما البيئة التي تشغّل compiler أو مجموعة اختبارات كاملة فقد تتجاوز 1 gibibyte.
البيانات وراء هذا الرسم البياني
[
{
"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 نحو 6 من بيئات العزل قيد التشغيل في الوقت نفسه إذا كانت كل واحدة تستهلك 512 MiB، أو 3 إذا كانت كل واحدة تستهلك gibibyte كاملة. وترفع VPS بسعة 8 GB ذلك إلى 14 و7. هذه حدود للتشغيل المتزامن، وهي ناتجة عن حساب حسابي وليست نتيجة اختبار أداء، لذلك راقب free -m أثناء تشغيل حملك الفعلي.
تُحدَّد بيئات العزل المجمّدة بسعة swap بدلاً من RAM، وهذا هو الهدف الأساسي من التصميم. تحتفظ بيئة عزل مجمّدة كانت تستهلك gibibyte بسعة تقارب ذلك في swap، ولا يبقى منها في الذاكرة الفعلية إلا القليل تقريباً، ولذلك يتيح ملف swap الافتراضي بسعة 16 GB في المُثبّت إيقاف نحو 16 منها. بعد ذلك تحتاج إلى الوصول إلى حالة الإيقاف، حيث لا تستهلك إلا مساحة القرص. مساحة القرص هي الحد الفعلي على المدى الطويل هنا: تحتفظ كل بيئة عزل بنظام ملفاتها، وستملأ بضع عشرات من الوكلاء، يحمل كل منها دليلاً node_modules، وحدة تخزين صغيرة قبل أن تصبح الذاكرة عاملاً مهماً.
التجميد والإيقاف والأرشفة: إعدادات دورة الحياة
الإعدادات الافتراضية هي التجميد بعد 10 دقائق من الخمول، والإيقاف بعد 3 أيام، والأرشفة بعد 7 أيام عند تهيئة الأرشفة. يؤدي ضبط stopAfterSeconds على null إلى إنشاء agent مقيم: قد يتجمد عند الخمول، لكنه لا يبدأ تشغيله من الصفر مطلقاً.
الأرشفة اختيارية، ويعرض daemon حالتها بوضوح. هيّئ مخزناً متوافقاً مع S3 من صفحة الإعدادات في وحدة التحكم (ما تزال متغيرات DORMICE_S3_* الأربعة موجودة، لكنها تُستخدم فقط كبذور للإقلاع الأول لـ gateway)، وعندها يُضغط قرص sandbox متوقف باستخدام tar وzstd، ويُرسل إلى bucket، ثم تُحرَّر مساحته محلياً. ويمكن أن يكون ذلك bucket هو bucket في MinIO تستضيفه بنفسك على جهاز آخر تملكه. إذا تركت المخزن من دون تهيئة، تبقى sandboxes في حالة الإيقاف إلى الأبد، ويُرفض طلب policy الذي يطلب الأرشفة بدلاً من تجاهله بصمت. تظهر عمليات الاستعادة بدلاً من تنفيذها بصمت: يجيب طلب acquire التالي فوراً بحالة restoring وقيمة للتقدم، ثم تتحول الحالة إلى ready عند استعادة القرص.
هل يمكنك الاعتماد عليه الآن؟
الإجابة المباشرة: لا، ليس لأي شيء لا يمكنك إعادة بنائه. أُنشئ المستودع في 8 July 2026. واعتباراً من 12 October 2026، لديه 1,509 نجمة و109 forks وترخيص Apache-2.0، ولا يملك أي إصدار موسوم على الإطلاق. ويذكر سطر الحالة في README نفسه أن أياً من مكوناته ليس جاهزاً للإنتاج.
ينطوي هذا المزيج على نمط محدد من المخاطر. يتغير الكود دون ثبات، لأن برنامج التثبيت يتتبع main. كما أن الواجهة لا تزال قيد الاستقرار: تصف الوثائق الآن gateway أمام daemon، مع منفذ خاص به، وملف إعداد خاص به، وقاعدة بيانات خاصة به. ويمكن لمشروع عمره نحو ثلاثة أشهر أن يتوقف ببساطة، لأن أياً من بنود الترخيص لا يُلزم أحداً بمواصلة تطويره.
ما يجعل هذا الخطر قابلاً للإدارة هو التوافق مع E2B. يتصل تطبيقك ببروتوكول له تطبيق مستضاف خلفه، لذلك إذا توقف Dormice يمكنك تغيير عنواني URL ومواصلة العمل. اكتب agent لديك مقابل واجهة E2B بدلاً من API الأصلية، وستحتفظ بمسار للخروج. كما أن حزمة @dormice/sdk الأصلية ليست متاحة على npm بعد، لذا يتطلب استخدامها بناءها من المستودع، وهذا سبب إضافي للبدء بالمسار المتوافق.
شغّله في بيئة يمكنك تحمل فقدانها. أعد بناء المضيف من script، وأبقِ token خارج كل prompt وكل commit، وانقل أي بيانات تستحق الاحتفاظ بها من sandboxes وفق جدول النسخ الاحتياطي الخاص بك.
FAQ
هل Dormice جاهز للاستخدام في الإنتاج؟
لا، والمشروع يذكر ذلك صراحةً. يوضح سطر الحالة في README أن أياً مما فيه ليس جاهزاً للاستخدام في الإنتاج بعد. وحتى 12 October 2026، يبلغ عمر المستودع نحو ثلاثة أشهر، ولا يحتوي على git tags أو releases، لذلك لا يوجد رقم إصدار يمكنك تثبيته. يستنسخ المثبّت فرع main، ما يعني أن كل تشغيل يحصل على أحدث commit. سجّل git -C /opt/dormice rev-parse HEAD بعد كل عملية تثبيت، واحتفظ بنسخة من لقطات قاعدة البيانات التي يكتبها المثبّت في /var/lib/dormice/backups/، واحفظ أي بيانات مهمة خارج sandboxes.
كيف يختلف Dormice عن منح agent لدي جهاز VM مؤقتاً؟
الـVM المؤقت هو جهاز تنشئه لجلسة واحدة عبر SSH ثم تحذفه. أما Dormice فهو execution API: يستدعي برنامجك acquire ثم exec، ويحصل على stdout ورمز خروج، من دون وجود جلسة shell وسيطة. يناسب الـVM مستخدماً بشرياً أو agent يحتاج إلى جهاز كامل لفترة من الوقت. أما Dormice فيناسب تطبيقاً يشغّل code مُولّداً مرات عديدة يومياً، ولا يريد تنفيذ إعداد جهاز كامل وإزالته مع كل تشغيل.
هل يعمل E2B SDK الرسمي فعلاً من دون تغييرات في code؟
نعم، مع تغييرات في الإعدادات. وجّه apiUrl وsandboxUrl إلى /e2b/api و/e2b/envd في daemon لديك، وأرسل Dormice token مع بادئة e2b_ بوصفه API key. تشمل حزمة الاختبارات الشاملة للمشروع، عند تشغيلها عبر الحزمة الرسمية، تنفيذ الأوامر، وجلسات PTY، ونقل الملفات، وsigned URLs، وport proxy. أما بناء القوالب فهو الفجوة البارزة: لم يُنفَّذ e2b template build، لذلك يكون القالب docker image تنشئه وتسجيله باستخدام dor template add.
كم عدد sandboxes التي يمكن تشغيلها على VPS بسعة 4 GB؟
يمكن تشغيل نحو 6 sandbox في الوقت نفسه إذا كان كل sandbox يستخدم 512 MiB، أو 3 إذا كان كل منها يستخدم gibibyte كاملاً، وذلك بعد حجز نحو 1 GB لنظام التشغيل وDocker وdaemon. أما sandboxes المجمّدة فتقيّدها swap بدلاً من ذلك. لذلك يتيح swapfile الافتراضي بسعة 16 GB الذي ينشئه المثبّت إيقاف نحو 16 sandbox كان كل منها يستخدم gibibyte واحداً. قِس استهلاكك باستخدام free -m تحت حمل فعلي، لأن sandbox الذي يشغّل مجموعة اختبارات يستخدم أضعاف ما يستخدمه sandbox الذي يشغّل script صغيراً.
لماذا يحتاج Dormice إلى ضبط vm.swappiness على 100؟
يعني تجميد sandbox نقل الذاكرة غير النشطة إلى swap. يحتفظ gVisor بذاكرة sandbox بوصفها shared memory، ولا تنقل Linux kernel هذه الذاكرة إلى swap عند قيمة swappiness الافتراضية. لذلك لا يستعيد التجميد أي ذاكرة عند القيمة الافتراضية، ويستمر sandbox في استهلاك الذاكرة كاملة. قاس المشروع استعادة 0 bytes عند القيمة الافتراضية و99.5 percent عند القيمة 100. تحقّق من القيمة الفعلية باستخدام sysctl vm.swappiness بدلاً من قراءة ملفات الإعداد، لأن بعض cloud images تأتي بقيمة 0.