نشر الوكلاء على خادم، بالطريقة البسيطة

الوكيل الذي يعمل على حاسوبك عرض تجريبي. والوكيل الذي يعمل على خادم، ويعيد تشغيل نفسه بعد العطل، ويواصل العمل وأنت نائم، هو نظام. الفرق بينهما هو النشر، وفي 2026 الطريق أبسط بكثير مما يبدو: كل شيء تقريباً يختصر في Docker وملف إعداد واحد. هذا الدليل يبقيه بهذه البساطة.

لماذا Docker هو الأداة الأهم

أقدم مشكلة في البرمجيات هي "يعمل على جهازي أنا". وكيلك يحتاج Python 3.12 وأربع مكتبات وخادم نماذج وقاعدة بيانات، والخادم لا يملك شيئاً منها. Docker يحل هذا بتغليف البرنامج وكل ما يحتاجه في حاوية: صندوق مغلق يعمل بالشكل نفسه في أي مكان فيه Docker. تبني الصندوق مرة واحدة؛ والخادم فقط يشغله. هذه هي الفكرة كلها، ولهذا Docker هو المهارة الأولى قبل أي أداة نشر أخرى.

الأدوات المساعدة

Docker Compose

منظومتك كلها في ملف واحد

وظيفته يصف كل خدمة (الوكيل والنموذج وقاعدة البيانات) في ملف YAML واحد

أهميته أمر واحد يشغل ويوقف ويعيد كل شيء معاً

Portainer

Docker بلا طرفية

وظيفته لوحة في المتصفح لحاوياتك: السجلات وإعادة التشغيل والتحديثات

أهميته يتيح لغير المتخصصين إدارة الخادم بأمان

Ollama

خادم النماذج داخل المنظومة

وظيفته يقدم نموذجك المحلي على المنفذ 11434 لكل الوكلاء

أهميته يعمل كحاوية بجانب الباقي، مع وصول للمعالج الرسومي

n8n (self-hosted)

محرك المسارات، وهو حاوية أيضاً

وظيفته يشغل مسارات وكلائك المرئية على الخادم، بجدول أو بحدث

أهميته طبقة التنظيم الكاملة لغير المبرمج في صورة واحدة

منظومة وكلاء كاملة في ملف واحد

هذا أصغر مثال صادق: خادم نماذج ومحرك مسارات، موصولان معاً، ينجوان من إعادة تشغيل الخادم. احفظه باسم docker-compose.yml على الخادم ونفذ أمراً واحداً. هذا فعلاً حجم قلب النشر كله.

services:
  ollama:
    image: ollama/ollama
    volumes: ["ollama:/root/.ollama"]
    restart: unless-stopped

  n8n:
    image: n8nio/n8n
    ports: ["127.0.0.1:5678:5678"]
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
    volumes: ["n8n:/home/node/.n8n"]
    restart: unless-stopped

volumes:
  ollama:
  n8n:

docker compose up -d

# see what is running
docker compose ps

# read the logs of one service
docker compose logs n8n -f

لاحظ خياري الأمان الهادئين في الملف: restart: unless-stopped يعيد كل خدمة بعد العطل أو إعادة التشغيل، والمنفذ مربوط بـ 127.0.0.1 فلا يصل إليه أحد إلا من الخادم نفسه، لا من الإنترنت. ثم تدخل أنت عبر VPN أو نفق SSH. هذان السطران يمنعان أشهر كارثتين عند المبتدئين.