Docker Compose لوكلاء الذكاء الاصطناعي: حزمة كاملة ذاتية الاستضافة على VPS واحد

نادراً ما يكون وكيل الذكاء الاصطناعي عملية واحدة. هناك حلقة الوكيل نفسها، ومخزن متجهات للذاكرة، وذاكرة تخزين مؤقت، وعادةً قاعدة بيانات للحالة، وربما لوحة تحكم صغيرة. تشغيل كلٍّ منها يدوياً — بدؤها، إعادة تشغيلها بعد الإقلاع، تذكّر أي منفذ لأي منها — يصبح مملّاً بسرعة. يصف Docker Compose كل ذلك في ملف واحد ويشغّله بأمر واحد. هذه هي الحزمة الجاهزة للنسخ واللصق لوضع وكيل على VPS بطريقة أنيقة.

إن أردت فقط نسخة النشر دون Docker، فإن دليل تشغيل وكيل ذكاء اصطناعي على مدار الساعة يغطّي systemd بدلاً من ذلك. هذه الصفحة هي النسخة الأصلية بالحاويات.

الحزمة

يريد وكيل ذاتي الاستضافة نموذجي أربعة أشياء إلى جانبه: عملية الوكيل، وQdrant (ذاكرة المتجهات)، وRedis (كاش / طوابير)، وPostgres (الحالة). إليك docker-compose.yml يشغّل كل ذلك، مع إبقاء الخدمات الداخلية بعيداً عن الإنترنت العام:

# /opt/agent/docker-compose.yml
services:
  agent:
    build: .                      # your agent image (or image: your/agent:latest)
    restart: unless-stopped
    env_file: [.env]              # OPENAI/ANTHROPIC keys etc. — never in this file
    environment:
      QDRANT_URL: http://qdrant:6333
      REDIS_URL: redis://redis:6379
      DATABASE_URL: postgres://agent:${DB_PASSWORD}@postgres:5432/agent
    depends_on: [qdrant, redis, postgres]
    # no ports: — this agent only makes outbound calls. Publish one only if it serves webhooks.

  qdrant:
    image: qdrant/qdrant:latest
    restart: unless-stopped
    volumes: ["qdrant:/qdrant/storage"]   # internal only — not published

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command: ["redis-server", "--save", "60", "1"]
    volumes: ["redis:/data"]

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: agent
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: agent
    volumes: ["pg:/var/lib/postgresql/data"]

volumes: { qdrant: {}, redis: {}, pg: {} }

تعيش الأسرار في .env، لا في ملف compose:

# /opt/agent/.env  (chmod 600, never committed)
ANTHROPIC_API_KEY=sk-ant-...
DB_PASSWORD=a-long-random-string

شغّلها:

apt update && apt install -y docker.io docker-compose-v2
systemctl enable --now docker
cd /opt/agent && docker compose up -d
docker compose logs -f agent

كل خدمة داخلية (Qdrant وRedis وPostgres) يمكن الوصول إليها فقط على شبكة compose باسم الخدمة — لا شيء منها منشور على الإنترنت. يتحدث الوكيل إليها عبر تلك الشبكة الخاصة، ولا شيء على تلك المنافذ يواجه العالم.

التفاصيل التي تهمّ

• restart: unless-stopped على كل خدمة — هذا ما ينجو من إعادة تشغيل أو تعطل. فعّل Docker عند الإقلاع وتعود الحزمة كاملة من تلقاء نفسها.
• المفاتيح في .env، لا في YAML. أشِر إليها كمتغيرات بيئة؛ أبقِ .env بـ chmod 600 وخارج git. ملف compose مسرَّب بمفتاح حي هو الخطأ الكلاسيكي.
• لا تنشر شيئاً لست مضطراً لنشره. وكيل يستدعي فقط واجهات النماذج وخدماته الخاصة لا يحتاج منفذاً وارداً على الإطلاق — فخطة NAT تعمل. أضِف IP مخصّصاً فقط إن كان يخدم webhooks أو لوحة تحكم.
• حدّد الحجم بالذاكرة لا بالنوى. الوكلاء المدعومون بـ API خفيفون. إن كبر فهرس Qdrant أو أضفت نموذجاً محلياً، فهنا ترتقي — راجع VPS عالي الذاكرة للوكلاء.

الجزء الذي هو لنا فعلاً: الوكيل يستطيع بناء جهازه الخاص

لأن EQVPS يوفّر خادم MCP، يستطيع وكيل يشغّل هذه الحزمة أن يُهيّئ VPS نظيفاً آخر بنفسه — يطلبه، يحصل على root، يهدمه — دافعاً من رصيد عملات مشفّرة مدفوع مسبقاً. حزمة compose تحتاج صندوق رمل جديداً يمكنها إنشاء واحد دون إنسان في الحلقة.

لماذا EQVPS لوكيل مُحوسَب بـ Docker

• صور نظيفة، root في ~60 ثانية. Ubuntu/Debian؛ docker compose up والحزمة تعمل.
• بلا KYC، الدفع بالعملات المشفّرة. بريد إلكتروني للتسجيل، وUSDC/USDT للدفع — لا شيء يربط الجهاز بهويتك.
• NVMe + 1 غيغابت/ث غير محدود، الاتحاد الأوروبي (ألمانيا/فنلندا). سحب الصور وإرسال السجلات لن يُنتج فاتورة مفاجئة.

VPS لوكلاء الذكاء الاصطناعي (النظرة العامة) → · VPS لـ Docker → · استضافة قاعدة بيانات متجهات لذاكرة الوكيل →