Agentbox - صندوق حماية العوامل البرمجية

لا توجد طريقة مثالية حتى الآن لعزل العوامل البرمجية (agents)، لكن الحاويات (containers) تعتبر بداية عملية.

Agentbox هو صندوق حماية للعوامل البرمجية يعتمد على Docker، مستوحى أصلاً من Batrachian Toad، وأصبح الآن معمماً لأدوات أكثر. يوفر بيئة معزولة تعمل بشكل جيد مع webterm لتشغيل جلسات متعددة للعوامل.

الميزات

توفر الحاوية الافتراضية ما يلي:

• بيئة تطوير: Debian Trixie مع أدوات تطوير شائعة
• عوامل برمجية مثبتة مسبقاً: Copilot CLI، Codex، Pi
• أدوات CLI مثبتة مسبقاً: gh، Nushell، lazygit، killall
• مديرو حزم: Homebrew و APT، بالإضافة إلى uv و Bun
• أدوات عوامل اختيارية: يمكن تثبيت toad و opencode و gemini و vibe عبر make -C ~ ...
• التحكم بالخدمات: تشغيل/إيقاف Docker/SSH/RDP باستخدام ENABLE_DOCKER و ENABLE_SSH و ENABLE_RDP
• Docker داخل Docker: متاح عند تشغيل الحاويات في وضع privileged
• الوصول عن بعد: دعم SSH (ENABLE_SSH=true) و mosh
• هيكل مساحة العمل: هيكل مساحة عمل مدمج ومهارات العوامل تحت /home/agent/workspace-skel

خارطة الطريق

• حدود وحدة المعالجة والذاكرة (قيود موارد Docker الأساسية)
• خيارات عزل الشبكة
• تقنيات عزل أخرى (gVisor، Kata Containers، إلخ)

تكوين الخدمات

يستخدم Agentbox متغيرات البيئة للتحكم في الخدمات التي تبدأ عند تشغيل الحاوية:

• ENABLE_DOCKER=true - تشغيل خادم Docker (لدعم Docker-in-Docker)
• ENABLE_SSH=true - تشغيل خادم SSH (المنفذ 22)
• ENABLE_RDP=true - تشغيل خادم RDP (المنفذ 3389)
• AGENTBOX_ENVIRONMENT=cli|gui - علامة البيئة التي توفرها الصورة (cli للبيئات بدون واجهة رسومية/CLI، gui لصور سطح المكتب)

السلوك الافتراضي: جميع الخدمات معطلة ما لم يتم تفعيلها صراحةً.

أمثلة:

# الافتراضي - جميع الخدمات معطلة
docker run -d agentbox

# تفعيل خادم Docker فقط
docker run -d -e ENABLE_DOCKER=true agentbox

# تفعيل Docker و SSH للتطوير
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -p 22:22 agentbox

# تجربة سطح المكتب الكاملة مع جميع الخدمات (صورة GUI)
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -e ENABLE_RDP=true -p 22:22 -p 3389:3389 agentbox:gui

البدء السريع

تثبيت الأدوات الاختيارية

داخل الحاوية، يأتي المستخدم agent مع ملف ~/Makefile يمكنه تثبيت أدوات إضافية.

العوامل البرمجية/واجهات سطر الأوامر التي يمكنك تثبيتها عبر make -C ~ …:

• toad — تثبيت Batrachian Toad (عبر uv tool)
• opencode — تثبيت OpenCode (عبر Bun)
• gemini — تثبيت Gemini CLI (عبر Homebrew)
• vibe — تثبيت mistral-vibe (عبر uv tool)

أهداف مساعدة:

• tools — تثبيت node و go و gemini و vibe
• node و go — تثبيت سلاسل أدوات اللغة (متطلبات مسبقة لبعض العوامل)

هيكل مساحة العمل

يحتوي Agentbox على هيكل مشروع مدمج في /home/agent/workspace-skel.

لنسخه إلى مجلد /workspace الحالي دون الكتابة فوق الملفات الموجودة:

make init-workspace

انظر docs/workspace-skeleton.md للتفاصيل.

صورة GUI

يتم نشر بناء واجهة المستخدم الرسومية تحت الوسم :gui (أيضاً <release>-gui) ويتضمن XFCE و XRDP و VS Code.

Docker Compose

سير العمل الموصى به:

make up
make enter-toad   # أو: make enter-copilot
make down

إذا كنت بحاجة إلى تجاوز الخدمات، أنشئ ملف docker-compose.override.yml:

services:
  toad:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"
  copilot:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"

ثم قم بتشغيل:

docker compose up -d

استخدام Docker مباشرة

# بناء الصورة بدون واجهة رسومية
docker build -t agentbox .

# بناء صورة واجهة المستخدم الرسومية
docker build -t agentbox:gui --target gui .

# تشغيل الحاوية مع خدمات محددة (صورة GUI)
docker run -d \
  --name agentbox \
  --privileged \
  -e ENABLE_DOCKER=true \
  -e ENABLE_SSH=true \
  -e ENABLE_RDP=true \
  -p 22:22 \
  -p 3389:3389 \
  -v $(pwd):/workspace \
  agentbox:gui

استخدام Batrachian Toad

بمجرد الاتصال بالحاوية:

1. تثبيت Toad (إذا لزم الأمر):

make -C ~ toad

2. بدء Toad:

toad

3. أو البدء مع مجلد مشروع محدد:

toad /workspace

4. أو التشغيل مباشرة مع عامل معين:

toad -a open-hands

ملاحظات أمنية

• التحكم بالخدمات: بشكل افتراضي، جميع الخدمات (Docker و SSH و RDP) معطلة. قم بتفعيل ما تحتاجه فقط باستخدام متغيرات البيئة.
• كلمات المرور الافتراضية ضعيفة - قم بتغييرها للاستخدام الإنتاجي
• يجب تشغيل الحاوية في وضع privileged ليتوفر Docker-in-Docker لعوامل البرمجة (أفضل من لا شيء)
• يُفضل استخدام مفاتيح SSH بدلاً من المصادقة بكلمة مرور
• للاستخدام الإنتاجي، يُنصح بتعطيل الخدمات غير الضرورية وتغيير بيانات الاعتماد الافتراضية

الإسناد

هذا المشروع مبني بشكل فضفاض على مشروعي القديم rcarmo/docker-templates/desktop-chrome مع بيئة مستخدم محدثة.

الترخيص

MIT