วิธีติดตั้ง Dormice รัน Agent Sandbox บน VPS ของคุณเอง
เรียนรู้วิธีติดตั้ง Dormice เพื่อรัน E2B-compatible sandbox บน VPS ส่วนตัว ช่วยให้คุณประมวลผลโค้ดผ่าน HTTP ได้อย่างปลอดภัยและแยกส่วนการทำงานออกจากระบบหลักอย่างมีประสิทธิภาพ
Dormice คืออะไรและไม่ใช่สิ่งใด
Dormice คือ sandbox สำหรับ agent ที่คุณโฮสต์เอง โดยเป็น daemon ตัวหนึ่งบน Linux VPS ของคุณ ซึ่งโค้ดของ agent จะเรียกใช้งานผ่าน HTTP เพื่อรันโค้ดที่ไม่น่าเชื่อถือภายใน container ที่แยกส่วนออกมา โปรแกรมของคุณจะร้องขอ sandbox โดยระบุชื่อ และจะได้รับ sandbox เดิมกลับมาไม่ว่าสถานะก่อนหน้าจะเป็นอย่างไร จากนั้นจึงรันคำสั่งภายในและอ่านผลลัพธ์ที่ได้ sandbox นี้เป็นทรัพยากรที่เรียกใช้ผ่านโปรแกรม ไม่ใช่เครื่องที่คุณต้องล็อกอินเข้าไปใช้งาน
รูปแบบการทำงานนี้แตกต่างจากการมอบคอมพิวเตอร์ทั้งเครื่องให้กับ agent โดย VM แบบใช้แล้วทิ้งสำหรับ coding agent คือเครื่องที่คุณ SSH เข้าไป ปล่อยให้ agent ทำลายทิ้ง แล้วค่อยลบออก แต่ Dormice อยู่ในระดับที่ต่ำกว่านั้น คือเป็น API สำหรับการประมวลผลที่โปรแกรมของคุณเรียกใช้เมื่อมีโค้ดอยู่แล้วและต้องการพื้นที่ปลอดภัยในการรัน ให้ใช้ VM แบบใช้แล้วทิ้งเมื่อหน่วยของงานคือคอมพิวเตอร์ทั้งเครื่อง และใช้ Dormice เมื่อหน่วยของงานคือการเรียกใช้งาน exec เพียงครั้งเดียว ซึ่งคุณต้องการรันวันละร้อยครั้งโดยไม่ต้องใช้ VM ถึงร้อยเครื่อง
โปรเจกต์นี้เรียกตัวเองว่ารองรับมาตรฐาน E2B โดย E2B เป็นบริการ sandbox แบบโฮสต์ที่ไลบรารีฝั่งไคลเอนต์ของเฟรมเวิร์ก agent หลายตัวรองรับอยู่แล้ว Dormice ให้บริการด้วยโปรโตคอลเดียวกันภายใต้ URL prefix ของตัวเอง ดังนั้นแอปพลิเคชันที่เขียนโดยใช้แพ็กเกจ e2b อย่างเป็นทางการจึงยังคงทำงานได้ตามปกติเมื่อคุณชี้เป้าหมายไปยังเซิร์ฟเวอร์ของคุณเอง โดยไม่ต้องแก้ไขโค้ดของแอปพลิเคชัน เพียงแค่เปลี่ยน URL สองรายการและ prefix ของ API key เท่านั้น
ความหมายของ "SQLite แห่งโลกของ agent sandbox" ในทางปฏิบัติ
SQLite คือฐานข้อมูลที่คุณฝังไว้ในแอปพลิเคชันแทนที่จะเป็นบริการที่คุณต้องคอยดูแล และ Dormice ก็หยิบยืมการเปรียบเทียบนั้นมาใช้โดยตรง โดยมี daemon หนึ่งตัวต่อหนึ่งเครื่อง, ไฟล์ SQLite หนึ่งไฟล์สำหรับบันทึกรายการ, พอร์ต TCP หนึ่งพอร์ต พร้อมด้วย gateway ขนาดเล็กที่ติดตั้งไว้ข้างๆ เพื่อให้บริการเว็บคอนโซล ไม่ต้องใช้ Kubernetes และไม่ต้องใช้เซิร์ฟเวอร์ฐานข้อมูลภายนอก daemon จะทำการล็อกแบบ exclusive ไว้ที่ข้างไฟล์บันทึกรายการ ดังนั้น daemon ตัวที่สองบนเครื่องเดียวกันจะไม่สามารถเริ่มทำงานได้ แทนที่จะเกิดการแยกสถานะโดยไม่รู้ตัว sandbox แต่ละตัวจะอาศัยอยู่บนเครื่องที่มันถูกสร้างขึ้น README ระบุว่า fleet คือ gateway หนึ่งตัวรวมกับเครื่องต่างๆ ในเครือข่ายส่วนตัวของมัน แต่ก็ยังระบุว่าหากคุณต้องการ sandbox ที่ย้ายไปมาระหว่างเครื่องได้ หรือต้องการ fleet ที่ครอบคลุมหลายภูมิภาค คุณควรเลือกใช้โซลูชันอื่น และคุณควรรับฟังคำแนะนำนี้
แนวคิดส่วนที่สองคือเรื่องของต้นทุน sandbox แบบ hosted จะคิดค่าบริการทุกวินาทีที่มันมีอยู่ ดังนั้น sandbox แบบ hosted จึงถูกออกแบบมาให้ใช้แล้วทิ้ง แต่ Dormice ทำงานบนฮาร์ดแวร์ที่คุณจ่ายเงินค่าเช่าหรือซื้อไว้อยู่แล้ว sandbox ของมันจึงเป็นแบบถาวรและมีต้นทุนถูกลงเมื่อมันอยู่นิ่งนานขึ้น sandbox จะค่อยๆ ลดระดับการทำงานลงทีละขั้น ได้แก่ active, frozen, stopped และ archived การเรียกใช้งาน (acquire) ใดๆ จะดึงมันกลับขึ้นมาจากระดับที่มันอยู่
การทำ freezing เป็นส่วนที่ควรทำความเข้าใจ เพราะเป็นสิ่งที่ทำให้การเก็บรักษา sandbox ของ agent ทุกตัวไว้ได้ตลอดไปนั้นมีราคาที่จับต้องได้ นี่คือตัวเลขที่โครงการเผยแพร่เอง ซึ่งวัดผลบนฮาร์ดแวร์ของโครงการ ไม่ใช่บนฮาร์ดแวร์ของคุณ
ข้อมูลเบื้องหลังแผนภูมินี้
[
{
"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 เมื่อถูก freeze และจะกลับมาทำงานได้ในเวลาประมาณ 50 ms กระบวนการต่างๆ จะถูกระงับและกลับมาทำงานต่อในสถานะเดิม ดังนั้น agent ที่มีอายุการใช้งานยาวนานจะยังคงสถานะ shell และงานที่ทำค้างไว้ได้ตลอดช่วงการ freeze คุณควรทดสอบซ้ำบนโฮสต์ของคุณเองก่อนที่จะวางแผนการจัดการทรัพยากรโดยอิงจากตัวเลขนี้
สิ่งที่โฮสต์ต้องมีก่อนการติดตั้ง
โฮสต์ต้องเป็น Ubuntu หรือ Debian บนสถาปัตยกรรม x86_64 และตัวติดตั้งต้องการสิทธิ์ root ตัว daemon จำเป็นต้องใช้สิทธิ์ root ในขณะทำงานเนื่องจากต้องทำ loop mounts และเขียนข้อมูลลงใน cgroups
Sandbox ทำงานภายใต้ Docker ร่วมกับ gVisor (container runtime ที่ทำหน้าที่เป็น kernel ในระดับ userspace คั่นกลางระหว่าง container กับ kernel ของโฮสต์) ซึ่งเป็นตัวจัดหา runsc runtime ที่แต่ละ sandbox ใช้งาน ตัว daemon ต้องใช้ Node 22 หรือใหม่กว่า หาก Node ในระบบของคุณเป็นเวอร์ชัน 22 หรือใหม่กว่าอยู่แล้ว ตัวติดตั้งจะนำมาใช้งานต่อ แต่หากไม่มีหรือเป็นเวอร์ชันที่เก่ากว่า ตัวติดตั้งจะดาวน์โหลด Node เวอร์ชันที่กำหนดไว้ ตรวจสอบ checksum และแตกไฟล์ลงใน /opt
ระบบต้องมี Swap และค่า vm.swappiness ต้องตั้งไว้ที่ 100 นี่ไม่ใช่คำแนะนำในการปรับแต่งประสิทธิภาพ แต่เป็นข้อกำหนดเชิงฟังก์ชัน การทำ freezing ทำงานโดยการผลักหน่วยความจำของ sandbox ที่ไม่ได้ใช้งานออกไปยัง swap โดย gVisor จะเก็บหน่วยความจำของ sandbox ไว้ในรูปแบบ shared memory ซึ่ง kernel จะไม่ยอมทำ swap ให้กับ shared memory หากใช้ค่า swappiness ตามค่าเริ่มต้น จากการวัดผลของโครงการพบว่าที่ค่าเริ่มต้นจะไม่มีการคืนหน่วยความจำเลย (0 bytes) แต่ที่ค่า 100 จะสามารถคืนหน่วยความจำได้ถึง 99.5 เปอร์เซ็นต์ ให้ตรวจสอบค่าที่ kernel ใช้งานจริงเสมอ เนื่องจาก cloud image บางตัวอาจมีการตั้งค่า vm.swappiness = 0 ไว้ในไฟล์ที่คุณอาจคาดไม่ถึง
sysctl vm.swappiness
swapon --showsysctl vm.swappiness ควรแสดงผลลัพธ์เป็น vm.swappiness = 100 และ swapon --show ควรแสดงรายการ swapfile หากค่า swappiness แสดงเป็น 0 การทำ freeze ทุกครั้งจะไม่มีผลใดๆ ทำให้คุณต้องเสียค่าใช้จ่ายสำหรับหน่วยความจำเต็มจำนวนของ sandbox ทุกตัวที่ไม่ได้ใช้งาน
การติดตั้ง Dormice บน Ubuntu
วิธีการติดตั้งที่ระบุไว้คือการใช้คำสั่ง pipe เข้าไปยัง bash:
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh | bashให้ดาวน์โหลดสคริปต์มาตรวจสอบเนื้อหาก่อนดำเนินการ สคริปต์นี้ทำงานด้วยสิทธิ์ root และปรับเปลี่ยนการตั้งค่าโฮสต์ของคุณ โดยจะติดตั้ง Docker หากยังไม่มี, ดาวน์โหลด gVisor และ Caddy พร้อมตรวจสอบ checksum, สร้าง swapfile หากโฮสต์ไม่มี swap, เขียน systemd unit สำหรับ daemon, gateway และ image registry รวมถึงเพิ่มกฎ 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 ใช้กำหนดขนาดของ swapfile โดยค่าเริ่มต้นคือ 16 ซึ่งถือว่าใช้พื้นที่ดิสก์ค่อนข้างมากสำหรับ VPS ขนาดเล็ก ส่วน --mirror cn จะเปลี่ยนแหล่งดาวน์โหลดไปยัง mirror ที่เข้าถึงได้จากจีนแผ่นดินใหญ่ การรันตัวติดตั้งซ้ำจะเป็นการอัปเกรดโค้ดและแก้ไขการตั้งค่าที่คลาดเคลื่อน โดยจะไม่ทำการหมุนเวียน (rotate) 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 ด้วย
ไม่มีการระบุเวอร์ชัน (tagged release) สำหรับการติดตั้ง ณ วันที่ 12 ตุลาคม 2026 repository ไม่มี git tags หรือ GitHub releases ดังนั้นตัวติดตั้งจะทำการ clone จาก main ซึ่งคุณจะได้รับโค้ดเวอร์ชันล่าสุด ณ ขณะนั้น การล็อกเวอร์ชัน (pinning) จึงทำได้โดยการจดบันทึก commit ที่คุณติดตั้งจริงไว้
git -C /opt/dormice rev-parse HEADให้บันทึก hash ดังกล่าวไว้พร้อมกับบันทึกการปรับใช้ (deploy notes) เพราะมันระบุว่าคุณกำลังรันโค้ดเวอร์ชันใดอยู่ แต่นี่ไม่ใช่วิธีการย้อนกลับ (rollback) ในตัวมันเอง เนื่องจากกระบวนการใหม่จะทำการ migration ฐานข้อมูลเมื่อเริ่มทำงาน และเอกสารการอัปเกรดระบุว่าการ migration ไม่สามารถย้อนกลับได้ด้วยการรันตัวติดตั้งเวอร์ชันเก่า ก่อนที่จะรีสตาร์ทบริการใดๆ ตัวติดตั้งจะบันทึก snapshot ของฐานข้อมูลทั้งสองชุดไว้ที่ /var/lib/dormice/backups/ โดยเก็บไว้ 3 ชุดล่าสุด snapshot เหล่านี้เป็นวิธีที่ระบุไว้สำหรับการย้อนกลับหลังจากการอัปเกรดที่ผิดพลาด ดังนั้นควรคัดลอกไฟล์ล่าสุดออกจากเซิร์ฟเวอร์ก่อนทำการอัปเกรดครั้งถัดไป
ตัวติดตั้งจะจบการทำงานด้วยการรัน dor doctor ซึ่งเป็นการตรวจสอบโฮสต์แบบ read-only โดยจะรัน gVisor container จริงเพื่อพิสูจน์ว่า runtime ทำงานได้ แทนที่จะเชื่อเพียงรายการแพ็กเกจ ให้รันคำสั่งนี้อีกครั้งหาก daemon ทำงานผิดปกติ
sudo dor doctor
systemctl is-active dormicesystemctl is-active dormice ควรแสดงผลเป็น active หากแสดงผลเป็น failed ให้ตรวจสอบ journalctl -u dormice -n 50 เพื่อหาสาเหตุ โดยส่วนใหญ่มักเกิดจากปัญหา swap หรือข้อกำหนดเบื้องต้นของ gVisor มากกว่าตัว daemon เอง
ตัวติดตั้งจะติดตั้ง Caddy ลงบนเครื่องด้วย ดังนั้นให้ตรวจสอบว่ามีบริการใดกำลังฟังพอร์ตอยู่บ้างก่อนที่จะสรุปว่าการตั้งค่า firewall เสร็จสมบูรณ์
sudo ss -lntpdaemon จะผูกกับ 127.0.0.1 เสมอ และตามการออกแบบแล้วไม่มีการตั้งค่าใดให้เปลี่ยนที่อยู่นี้ได้ มีเพียงพอร์ตเท่านั้นที่เปลี่ยนได้ โดย DORMICE_PORT มีค่าเริ่มต้นเป็น 3676 ส่วน gateway ที่อยู่ข้างกันจะใช้กฎเดียวกันบน 127.0.0.1:3677 โดยใช้ DORMICE_GATEWAY_PORT เป็นพอร์ต และไม่มีการตั้งค่า host ตามความตั้งใจ การเข้าถึงบริการเหล่านี้จากแล็ปท็อปของคุณต้องทำอย่างตั้งใจ โดยวิธีที่ประหยัดที่สุดคือการใช้ SSH tunnel เพื่อ forward พอร์ตทั้งสอง
ssh -L 3676:127.0.0.1:3676 -L 3677:127.0.0.1:3677 root@your-serverเมื่อเปิด tunnel แล้ว http://127.0.0.1:3677/console บนแล็ปท็อปของคุณจะเป็นเว็บคอนโซลที่ให้บริการโดย gateway ในการเข้าใช้งานครั้งแรก คุณต้องยืนยันตัวตนว่าเป็นผู้ดูแลระบบโดยการวาง API token หนึ่งครั้ง จากนั้นจึงตั้งชื่อผู้ใช้และรหัสผ่านสำหรับคอนโซล การลงชื่อเข้าใช้จะสร้าง httpOnly session cookie ซึ่งมีอายุ 7 วัน โดย JavaScript ในหน้าเว็บจะไม่สามารถอ่านคุกกี้นี้ได้ และคอนโซลจะไม่แสดง API token ออกมาอีก หน้า Connect ในคอนโซลจะแสดงตัวอย่างโค้ดสำหรับ client ที่ชี้ไปยัง endpoint ของคุณให้คัดลอกไปใช้งานได้ทันที
การสร้างแซนด์บ็อกซ์และการรันโค้ดภายใน
การดำเนินการสร้างแซนด์บ็อกซ์มีเพียงคำสั่งเดียวคือ acquire ซึ่งมีคุณสมบัติ idempotent ดังนั้นคีย์เดิมจะส่งคืนแซนด์บ็อกซ์เดิมเสมอ ไม่ว่าจะสร้างใหม่ ปลุกให้ตื่น เริ่มการทำงาน หรือกู้คืนตามความจำเป็น คำสั่งอื่นทั้งหมดจะตอบกลับด้วย 404 หากพบกับคีย์ที่ไม่เคยรู้จักมาก่อน dor CLI ไม่มีคำสั่ง acquire ดังนั้นแซนด์บ็อกซ์แรกของคุณจะต้องสร้างผ่านคอนโซลหรือผ่าน client library
การใช้คอนโซลเป็นวิธีที่รวดเร็วที่สุด ให้เปิด /console ผ่านทาง tunnel แล้วสร้างแซนด์บ็อกซ์ที่ชื่อ 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 จะแสดงรายการแซนด์บ็อกซ์แต่ละรายการพร้อมสถานะวงจรชีวิต ซึ่งเป็นวิธีที่คุณใช้ตรวจสอบเมื่อสถานะเปลี่ยนจาก active เป็น frozen dor sandbox exec จะแสดงเวอร์ชัน Python 3.12 เนื่องจากอิมเมจมาตรฐานคือ Ubuntu 24.04 ซึ่งติดตั้ง Python 3.12, Node 24, git และ ripgrep ไว้เรียบร้อยแล้ว หากเกิดข้อผิดพลาดด้านการยืนยันตัวตน แสดงว่าบรรทัด token ที่คุณคัดลอกมานั้นรวมชื่อตัวแปรติดมาด้วย
การย้ายไฟล์ทำได้ด้วย dor sandbox push my-agent ./script.py ซึ่งจะไปเก็บไว้ที่ /home/user/script.py และ dor sandbox pull my-agent notes.txt ใช้สำหรับดึงไฟล์กลับมา คำสั่งจัดการไฟล์แบบเนทีฟจำกัดขนาดไว้ที่ 16 MiB ต่อไฟล์ ในขณะที่ E2B file surface รองรับการสตรีมข้อมูลและให้โควตาพื้นที่ดิสก์ของแซนด์บ็อกซ์เป็นข้อจำกัดเพียงอย่างเดียว
การทำลายแซนด์บ็อกซ์เป็นคำสั่งเดียวที่ทำให้ข้อมูลสูญหาย dor sandbox destroy my-agent จะลบแซนด์บ็อกซ์และมีคุณสมบัติ idempotent โดยใน README หลัก, agent skill ที่มาพร้อมกัน และ README ของแพ็กเกจ CLI ต่างระบุไว้ภายใต้ชื่อนี้ทั้งสิ้น อย่างไรก็ตาม ควรเรียกใช้ dor sandbox --help กับบิลด์ของคุณเองด้วย เนื่องจากตัวติดตั้งจะติดตาม main และ CLI จะมีการขยายตัวอยู่ตลอดเวลา
ชี้โค้ด E2B ที่มีอยู่ของคุณไปยังเซิร์ฟเวอร์ของคุณเอง
นี่คือเหตุผลที่คุณควรให้ความสนใจ แพ็กเกจ e2b อย่างเป็นทางการจาก npm ที่ไม่ได้ผ่านการแก้ไขจะสื่อสารกับ Dormice ให้รันคำสั่งนี้จากแล็ปท็อปของคุณในขณะที่เปิด SSH tunnel ไว้ เพื่อไม่ให้มีบริการใหม่ใดๆ เปิดพอร์ตรับการเชื่อมต่อบนเซิร์ฟเวอร์
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การทำงานที่สมบูรณ์จะแสดง exit code 0 และ 42 API key คือ Dormice token ของคุณที่มีคำนำหน้าเป็น e2b_ ซึ่งเป็นรูปแบบที่เลเยอร์ความเข้ากันได้ (compatibility layer) ต้องการ
ความเข้ากันได้นี้ไม่ใช่แค่ส่วนประกอบจำลอง (stub) การสตรีม stdout และ stderr, การรันคำสั่งเบื้องหลัง, PTY แบบโต้ตอบ, URL สำหรับอัปโหลดและดาวน์โหลดที่มีการลงลายเซ็น, การเฝ้าดูไดเรกทอรี และพอร์ตพร็อกซี ทั้งหมดนี้ถูกทดสอบผ่านแพ็กเกจอย่างเป็นทางการโดยทำงานร่วมกับ Docker และ gVisor daemon จริงๆ ด้วยชุดทดสอบ end-to-end ของโปรเจกต์ มีข้อแตกต่างเล็กน้อยที่คุณควรทราบก่อนย้ายงานจริง:
- การ build template ยังไม่ถูกนำมาใช้งาน Template คือ docker image ที่คุณสร้างขึ้นเองและลงทะเบียนด้วย
dor template addโดยที่Sandbox.create('name')จะทำหน้าที่แก้ไขชื่อเหล่านั้น หากชื่อที่ระบุไม่ได้ลงทะเบียนไว้ ระบบจะส่งค่า 404 กลับมาแทนที่จะทำงานแบบจำลอง - Sandbox ที่สร้างผ่านอินเทอร์เฟซของ E2B จะมีกำหนดเวลา (deadline) จริง เนื่องจากข้อกำหนดของ E2B จำเป็นต้องมีสิ่งนี้ แต่จะไม่มีการกำหนด deadline สำหรับ sandbox ที่สร้างผ่าน native API
- Sandbox ที่ถูกแช่แข็ง (frozen) จะคงสถานะของกระบวนการไว้และกลับมาทำงานต่อจากจุดเดิม ดังนั้นการหยุดและเริ่มทำงานต่อในที่นี้จึงไม่ใช่การสั่ง stop และ cold start แบบที่คุณอาจคุ้นเคย
สิ่งที่ sandbox ป้องกันและสิ่งที่ไม่สามารถป้องกันได้
gVisor จะดักจับ system call ของ container ในระดับ userspace และประมวลผลด้วยตัวเอง ดังนั้นโค้ดที่อยู่ใน sandbox จึงไม่ได้สื่อสารกับ host kernel โดยตรง ภายใน sandbox คำสั่งต่างๆ จะรันในฐานะ user (uid 1000) แต่บัญชีดังกล่าวมีสิทธิ์ sudo แบบไม่ต้องใช้รหัสผ่าน ดังนั้นโค้ดใดก็ตามที่ต้องการสิทธิ์ root ภายใน sandbox สามารถเรียกใช้ได้ทันที อย่ามองว่า uid เป็นมาตรการป้องกัน เพราะทางโครงการระบุไว้อย่างชัดเจนว่าขอบเขตความปลอดภัยคือ gVisor ไม่ใช่ uid และ sandbox ที่ยกระดับสิทธิ์ตัวเองก็ยังไม่สามารถเข้าถึง host kernel ได้ ซึ่งนั่นครอบคลุมกรณีทั่วไป เช่น สคริปต์ที่ถูกสร้างขึ้นมาแล้วรัน rm -rf /, การเขียนข้อมูลจนเต็มดิสก์ หรือการทำ fork จนระบบล่ม จะสร้างความเสียหายได้เพียงภายใน sandbox ของตัวเองเท่านั้น
ต่อไปนี้คือสิ่งที่ gVisor ไม่สามารถป้องกันได้ ซึ่งเป็นหน้าที่ของคุณที่ต้องจัดการเอง
- sandbox สามารถเชื่อมต่อเครือข่ายขาออกได้ โค้ดที่ถูกสร้างขึ้นสามารถดาวน์โหลดสิ่งที่ต้องการและส่งข้อมูลออกไปได้ การตั้งค่า network hardening ของตัวติดตั้งครอบคลุมเพียงสองเรื่องคือ การดรอปทราฟฟิกจาก container ที่มุ่งหน้าไปยัง cloud metadata service ที่ 169.254.0.0/16 และ 100.100.100.200 ซึ่งเป็นที่อยู่ที่ Alibaba Cloud ใช้สำหรับส่ง instance credentials ให้กับสิ่งที่เข้าถึงได้ และการปิดกั้นการสื่อสารระหว่าง container ด้วย
"icc": falseในdaemon.jsonของ Docker นอกเหนือจากนี้ไม่มีการบล็อกใดๆ โปรดอ่านsudo iptables -S DOCKER-USERและเพิ่มกฎ DROP ของคุณเองสำหรับช่วง IP ภายในที่ sandbox ไม่ควรเข้าถึง - Docker จะแทรกกฎของตัวเองไว้หน้า firewall ของคุณ ดังนั้นพอร์ตของ container ที่ถูกเผยแพร่ (published) อาจตอบสนองต่ออินเทอร์เน็ตได้แม้ว่า ufw จะแสดงสถานะว่าปิดอยู่ก็ตาม โปรดอ่าน วิธีที่ Docker เผยแพร่พอร์ตผ่าน ufw และ พื้นฐาน ufw firewall สำหรับ VPS ก่อนที่คุณจะเปิดเผยบริการใดๆ บนโฮสต์นี้
- gVisor เป็น kernel ในระดับ userspace ไม่ใช่ hypervisor นี่เป็นการแลกเปลี่ยนที่ตั้งใจไว้ เพราะการทำ freezing จำเป็นต้องให้ sandbox เป็น process และการบังคับใช้ KVM จะทำให้ไม่สามารถติดตั้งในสภาพแวดล้อมทั่วไปได้ หากโมเดลภัยคุกคามของคุณต้องการการทำ hardware virtualization ให้ใช้การแยกส่วนระดับ Firecracker และยอมรับต้นทุนการดำเนินงานที่ตามมา
- API token คือขอบเขตความปลอดภัยทั้งหมดในฝั่งไคลเอนต์ สิ่งใดก็ตามที่ถือครอง
DORMICE_API_TOKENสามารถสร้าง อ่าน และทำลาย sandbox ทุกตัวบนเครื่องได้ โปรดกำหนดให้กระบวนการของ agent ใช้ ผู้ใช้ที่มีสิทธิ์น้อยที่สุดบน VPS และปฏิบัติต่อ token เช่นเดียวกับที่คุณปฏิบัติต่อ SSH key แนวทางปฏิบัติจาก การรัน Claude Code บน VPS อย่างปลอดภัย สามารถนำมาปรับใช้ได้โดยตรง
ตัว daemon เองรันในฐานะ root บนโฮสต์ของคุณ gVisor ปกป้องโฮสต์จากโค้ดภายใน sandbox แต่ไม่มีสิ่งใดปกป้องโฮสต์จากตัว daemon หรือจากผู้ที่ถือครอง token ของมัน ดังนั้นเครื่องที่รัน Dormice ควรเป็นเครื่องที่ทำหน้าที่นี้เพียงอย่างเดียว หาก agent ของคุณเข้าถึงเครื่องมือผ่าน MCP (model context protocol) ด้วย ให้แยก MCP servers ไปไว้บน VPS อื่น ด้วยเหตุผลเดียวกัน
Sandbox จำนวนเท่าใดที่รองรับได้ในหน่วยความจำ 4 GB และ 8 GB?
มีปัจจัยสองประการที่ใช้หน่วยความจำ คือ ค่าพื้นฐานของโฮสต์เอง และชุดข้อมูลการทำงาน (working set) ของ sandbox แต่ละตัวที่กำลังทำงานอยู่ ให้สำรองหน่วยความจำไว้ประมาณ 1 GB สำหรับ Ubuntu, Docker และ daemon จากนั้นให้นำส่วนที่เหลือหารด้วยปริมาณการใช้งานจริงของ sandbox หนึ่งตัว Sandbox ที่รันสคริปต์ Python ซึ่งอ่านไฟล์เพียงไม่กี่ไฟล์จะใช้หน่วยความจำประมาณ 200 ถึง 300 MiB ส่วน sandbox ที่รันคอมไพเลอร์หรือชุดทดสอบเต็มรูปแบบอาจใช้หน่วยความจำเกิน 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 สามารถรองรับ sandbox ที่ทำงานพร้อมกันได้ประมาณ 6 ตัว หากแต่ละตัวใช้หน่วยความจำ 512 MiB หรือ 3 ตัว หากแต่ละตัวใช้หน่วยความจำเต็ม 1 gibibyte สำหรับ VPS ขนาด 8 GB จะรองรับได้เพิ่มขึ้นเป็น 14 และ 7 ตัวตามลำดับ ค่าเหล่านี้เป็นขีดจำกัดสำหรับการทำงานพร้อมกันและเป็นการคำนวณเชิงคณิตศาสตร์ไม่ใช่ผลการทดสอบประสิทธิภาพ ดังนั้นควรตรวจสอบ free -m ในขณะที่โหลดงานของคุณกำลังทำงานอยู่
Sandbox ที่ถูกแช่แข็ง (frozen) จะถูกจำกัดด้วย swap แทนที่จะเป็น RAM ซึ่งเป็นจุดประสงค์หลักของการออกแบบนี้ Sandbox ที่ถูกแช่แข็งซึ่งเคยใช้หน่วยความจำ 1 gibibyte จะคงข้อมูลไว้ใน swap ในปริมาณใกล้เคียงกันและแทบไม่ใช้หน่วยความจำหลัก ดังนั้น swapfile ขนาด 16 GB ตามค่าเริ่มต้นของตัวติดตั้งจึงสามารถรองรับ sandbox เหล่านี้ได้ประมาณ 16 ตัว หากเกินกว่านั้น sandbox จำเป็นต้องเข้าสู่สถานะหยุดทำงาน (stopped) ซึ่งจะใช้เพียงพื้นที่ดิสก์เท่านั้น พื้นที่ดิสก์คือข้อจำกัดที่แท้จริงในระยะยาว เนื่องจาก sandbox แต่ละตัวจะเก็บระบบไฟล์ของตนเองไว้ และ agent จำนวนหลายสิบตัวที่แต่ละตัวมีไดเรกทอรี node_modules จะทำให้พื้นที่จัดเก็บข้อมูลขนาดเล็กเต็มก่อนที่หน่วยความจำจะกลายเป็นประเด็นสำคัญเสียอีก
การหยุดชั่วคราว การหยุดทำงาน และการจัดเก็บถาวร: ตัวควบคุมวงจรชีวิต
ค่าเริ่มต้นคือการหยุดชั่วคราว (freeze) หลังจากไม่มีการใช้งาน 10 นาที, หยุดทำงาน (stop) หลังจาก 3 วัน และจัดเก็บถาวร (archive) หลังจาก 7 วันหากมีการตั้งค่าการจัดเก็บถาวรไว้ การตั้งค่า stopAfterSeconds ให้เป็น null จะทำให้คุณได้ resident agent ซึ่งอาจหยุดชั่วคราวเมื่อไม่มีการใช้งาน แต่จะไม่เริ่มทำงานแบบ cold start อีกเลย
การจัดเก็บถาวรเป็นทางเลือกเสริม และ daemon จะแจ้งสถานะตามจริง คุณสามารถตั้งค่าที่เก็บข้อมูลที่รองรับ S3 ได้ที่หน้าการตั้งค่าของคอนโซล (ตัวแปร DORMICE_S3_* ทั้งสี่ตัวยังคงมีอยู่ แต่ใช้เป็นเพียงค่าเริ่มต้นสำหรับการบูตครั้งแรกของ gateway เท่านั้น) จากนั้นดิสก์ของ sandbox ที่หยุดทำงานจะถูกบีบอัดด้วย tar และ zstd แล้วส่งไปยัง bucket ก่อนที่จะลบข้อมูลออกจากเครื่องในพื้นที่ bucket ดังกล่าวสามารถเป็น MinIO bucket ที่คุณโฮสต์เอง บนเครื่องอื่นของคุณได้ หากไม่ตั้งค่าที่เก็บข้อมูลไว้ sandbox จะอยู่ในสถานะหยุดทำงานตลอดไป และนโยบายที่ร้องขอให้จัดเก็บถาวรจะถูกปฏิเสธแทนที่จะถูกละเลยโดยไม่มีการแจ้งเตือน การกู้คืนข้อมูลจะแสดงสถานะให้เห็นชัดเจนแทนที่จะทำงานเงียบๆ โดยการเรียกใช้งานครั้งถัดไปจะตอบกลับทันทีด้วยสถานะกำลังกู้คืนและค่าความคืบหน้า จากนั้นจะเปลี่ยนเป็นสถานะพร้อมใช้งานเมื่อดิสก์ถูกกู้คืนกลับมาเรียบร้อยแล้ว
ควรเริ่มใช้งานแล้วหรือยัง?
คำตอบตรงไปตรงมาคือ: อย่าใช้กับงานใดก็ตามที่คุณไม่สามารถสร้างใหม่ได้ Repository นี้ถูกสร้างขึ้นเมื่อวันที่ 8 กรกฎาคม 2026 ณ วันที่ 12 ตุลาคม 2026 มีผู้ให้ดาว 1,509 ครั้ง มีการ fork 109 ครั้ง ใช้สัญญาอนุญาตแบบ Apache-2.0 และยังไม่มีการทำ tagged release ใดๆ ทั้งสิ้น บรรทัดสถานะใน README ระบุชัดเจนว่ายังไม่มีส่วนใดที่พร้อมสำหรับการใช้งานจริง (production)
สถานการณ์ดังกล่าวมีความเสี่ยงในรูปแบบเฉพาะ โค้ดมีการเปลี่ยนแปลงอยู่ตลอดเวลาเนื่องจากตัวติดตั้งติดตาม main อินเทอร์เฟซยังอยู่ในช่วงปรับเปลี่ยน โดยเอกสารปัจจุบันอธิบายถึง gateway ที่อยู่หน้า daemon ซึ่งมีพอร์ตของตัวเอง ไฟล์คอนฟิกูเรชันของตัวเอง และฐานข้อมูลของตัวเอง นอกจากนี้ โครงการที่มีอายุเพียงสามเดือนอาจยุติการพัฒนาลงได้ทุกเมื่อ เนื่องจากไม่มีข้อกำหนดในสัญญาอนุญาตใดที่บังคับให้ผู้พัฒนาต้องทำโครงการต่อ
สิ่งที่ทำให้ความเสี่ยงนี้ยังพอรับได้คือความเข้ากันได้กับ E2B แอปพลิเคชันของคุณสื่อสารผ่านโปรโตคอลที่มีการใช้งานแบบ hosted รองรับอยู่เบื้องหลัง ดังนั้นหาก Dormice หยุดชะงัก คุณเพียงแค่เปลี่ยน URL สองจุดก็สามารถทำงานต่อได้ ให้เขียน agent ของคุณโดยอิงกับพื้นผิวของ E2B แทนที่จะใช้ native API เพื่อรักษาทางเลือกในการย้ายออกไว้ นอกจากนี้แพ็กเกจ @dormice/sdk แบบ native ยังไม่มีบน npm ดังนั้นการใช้งานจึงหมายถึงการ build จาก repository โดยตรง ซึ่งเป็นเหตุผลประการที่สองที่ควรเริ่มต้นด้วยแนวทางที่เข้ากันได้
จงรันมันในสภาพแวดล้อมที่คุณสามารถยอมรับความเสียหายได้ ให้สร้าง host ขึ้นใหม่จากสคริปต์ เก็บ token ไว้ภายนอกทุก prompt และทุก commit และสำรองข้อมูลใดๆ ที่มีค่าออกจาก sandbox ตามตารางการสำรองข้อมูลของคุณเอง
FAQ
Dormice พร้อมสำหรับการใช้งานจริง (production) หรือยัง?
ยังไม่พร้อม และตัวโครงการเองก็ได้ระบุไว้เช่นนั้น สถานะใน README ระบุว่าไม่มีส่วนใดที่พร้อมสำหรับใช้งานจริง และ ณ วันที่ 12 ตุลาคม 2026 ตัว repository มีอายุเพียงประมาณสามเดือน โดยยังไม่มีการทำ git tags หรือ releases ใดๆ จึงไม่มีหมายเลขเวอร์ชันให้ล็อกไว้ ตัวติดตั้งจะทำการ clone สาขา main ซึ่งหมายความว่าการรันแต่ละครั้งคุณจะได้ commit ล่าสุดเสมอ ให้บันทึก git -C /opt/dormice rev-parse HEAD หลังการติดตั้งทุกครั้ง เก็บสำเนาของ database snapshots ที่ตัวติดตั้งเขียนไว้ที่ /var/lib/dormice/backups/ และเก็บข้อมูลที่มีค่าไว้นอก sandbox เสมอ
Dormice แตกต่างจากการให้ VM แบบใช้แล้วทิ้งแก่ agent อย่างไร?
VM แบบใช้แล้วทิ้งคือเครื่องที่เข้าถึงผ่าน SSH ซึ่งคุณสร้างขึ้นมาเพื่อใช้งานในเซสชันหนึ่งแล้วลบทิ้ง ส่วน Dormice เป็น execution API: โปรแกรมของคุณจะเรียกใช้ acquire ตามด้วย exec แล้วรับค่า stdout และ exit code กลับมา โดยไม่มี shell session คั่นกลาง VM เหมาะสำหรับมนุษย์หรือ agent ที่ต้องการใช้งานคอมพิวเตอร์ทั้งเครื่องในช่วงเวลาหนึ่ง ส่วน Dormice เหมาะสำหรับแอปพลิเคชันที่รันโค้ดที่สร้างขึ้นใหม่หลายครั้งต่อวัน และไม่ต้องการขั้นตอนการตั้งค่าหรือลบเครื่องทิ้งในทุกครั้งที่รัน
E2B SDK อย่างเป็นทางการใช้งานได้โดยไม่ต้องแก้ไขโค้ดจริงหรือไม่?
ใช้งานได้จริง แต่ต้องมีการปรับเปลี่ยนการตั้งค่า ให้ชี้ apiUrl และ sandboxUrl ไปที่ /e2b/api และ /e2b/envd บน daemon ของคุณ และส่ง Dormice token โดยมี prefix เป็น e2b_ เพื่อใช้เป็น API key การรันคำสั่ง, PTY sessions, การโอนย้ายไฟล์, signed URLs และ port proxy ทั้งหมดนี้ครอบคลุมโดยชุดทดสอบ end-to-end ของโครงการที่รันผ่านแพ็กเกจอย่างเป็นทางการ ส่วนการสร้าง template เป็นจุดที่ยังขาดอยู่: e2b template build ยังไม่ได้ถูกพัฒนา ดังนั้น template จึงเป็น docker image ที่คุณต้องสร้างและลงทะเบียนด้วย dor template add
VPS ขนาด 4 GB สามารถรองรับ sandbox ได้กี่รายการ?
รองรับได้ประมาณ 6 รายการพร้อมกันหากแต่ละ sandbox ใช้หน่วยความจำ 512 MiB หรือ 3 รายการหากแต่ละรายการใช้ 1 gibibyte หลังจากสำรองพื้นที่ประมาณ 1 GB สำหรับระบบปฏิบัติการ, Docker และ daemon แล้ว สำหรับ sandbox ที่ถูก freeze จะถูกจำกัดด้วย swap แทน ดังนั้น swapfile ขนาด 16 GB ที่ตัวติดตั้งกำหนดไว้เป็นค่าเริ่มต้นจะรองรับ sandbox ที่ใช้หน่วยความจำ 1 gibibyte ได้ประมาณ 16 รายการ ให้วัดค่าด้วยตัวคุณเองโดยใช้ free -m ภายใต้ภาระงานจริง เนื่องจาก sandbox ที่รัน test suite จะใช้ทรัพยากรมากกว่า sandbox ที่รันสคริปต์ขนาดเล็กหลายเท่า
ทำไม Dormice ถึงต้องการให้ตั้งค่า vm.swappiness เป็น 100?
การ freeze sandbox คือการผลักหน่วยความจำที่ไม่ได้ใช้งานออกไปยัง swap โดย gVisor จะเก็บหน่วยความจำของ sandbox ไว้ในรูปแบบ shared memory และ Linux kernel จะไม่ทำ swap ข้อมูลที่เป็น shared memory หากใช้ค่า swappiness เริ่มต้น ดังนั้นที่ค่าเริ่มต้น การ freeze จะไม่สามารถคืนพื้นที่หน่วยความจำได้เลยและ sandbox จะยังคงใช้หน่วยความจำเต็มจำนวน โครงการได้วัดผลแล้วพบว่าที่ค่าเริ่มต้นจะคืนพื้นที่ได้ 0 bytes แต่ที่ค่า 100 จะคืนพื้นที่ได้ถึง 99.5 เปอร์เซ็นต์ ให้ตรวจสอบค่าที่ใช้งานจริงด้วย sysctl vm.swappiness แทนการอ่านจากไฟล์ config เนื่องจาก cloud image บางตัวอาจตั้งค่าเริ่มต้นไว้ที่ 0