AnythingLLM على VPS: دليل شامل مع أبرز الأخطاء

عبر SSH على خادم VPS، أنشئ دليل العمل ووحدة البيانات:

mkdir -p /opt/anythingllm/storage
cd /opt/anythingllm
chmod -R 777 storage

تعمل الحاوية بمعرّف UID مخصّص (غير root): أذونات 777 على storage ضرورية لكي تتمكن العملية الداخلية من كتابة قاعدة البيانات المتجهية وتحميلات المستندات.

أنشئ /opt/anythingllm/docker-compose.yml. لاحظ وسم الإصدار الثابت — لا تستخدم ‎:latest‎:

services:
  anythingllm:
    image: mintplexlabs/anythingllm:v1.8.4
    container_name: anythingllm
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./storage:/app/server/storage
    env_file:
      - .env
    cap_add:
      - SYS_ADMIN

ثم أنشئ .env في المجلد نفسه بالحد الأدنى:

JWT_SECRET=غيّر-هذا-إلى-سلسلة-عشوائية-طويلة
STORAGE_DIR=/app/server/storage
LLM_PROVIDER=openai
OPEN_AI_KEY=sk-مفتاح-openai-الخاص-بك

استبدل LLM_PROVIDER والمفتاح وفقًا لمزوّدك. للحصول على Ollama المحلي، انظر الخطوة التالية.

إذا كان Ollama يعمل على المضيف نفسه الذي تعمل عليه حاوية AnythingLLM، لا تستخدم localhost — من داخل الحاوية، يشير localhost إلى الحاوية نفسها، وليس إلى المضيف.

عنوان URL الصحيح حسب نظام التشغيل:
- Linux: http://172.17.0.1:11434 (عنوان جسر Docker الافتراضي)
- macOS / Windows: http://host.docker.internal:11434

في ملف .env:

LLM_PROVIDER=ollama
OLLAMA_BASE_PATH=http://172.17.0.1:11434
OLLAMA_MODEL_PREF=llama3.2
EMBEDDING_ENGINE=ollama
EMBEDDING_BASE_PATH=http://172.17.0.1:11434
EMBEDDING_MODEL_PREF=nomic-embed-text

تحقّق من أن Ollama يستمع على 0.0.0.0 (وليس فقط 127.0.0.1) بالتحقّق من OLLAMA_HOST=0.0.0.0 في وحدة systemd أو متغيّر البيئة.

شغّل الخدمة:

docker compose up -d
docker compose logs -f

انتظر السطرين [server] Listening on port 3001 و[database] Migration complete. ثم ادخل إلى http://your-ip:3001 من محطة عملك (وصول مؤقت، يُغلق بعد إعداد الوكيل العكسي). يرشدك معالج الإعداد إلى إنشاء حساب المسؤول واختيار نموذج التضمين ونموذج LLM.

باستخدام Nginx أو Caddy، اعرض AnythingLLM خلف نطاقك.

مثال Caddy (الأبسط، Let's Encrypt تلقائي):

chat.your-domain.com {
    reverse_proxy localhost:3001
    request_body {
        max_size 100MB
    }
}

مثال Nginx (كتلة server):

server {
    listen 443 ssl;
    server_name chat.your-domain.com;
    ssl_certificate /etc/letsencrypt/live/chat.your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/chat.your-domain.com/privkey.pem;
    client_max_body_size 100M;
    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

توجيه client_max_body_size (Nginx) أو max_size (Caddy) ضروري للسماح برفع ملفات PDF الكبيرة أو أرشيفات المستندات.

في الواجهة، انقر '+ مساحة عمل جديدة'، وأعطها اسمًا، ثم اسحب بعض ملفات PDF إلى منطقة الرفع. شغّل عملية التضمين (زر 'حفظ وتضمين'). بعد الانتهاء، اطرح سؤالاً في المحادثة — يجب أن تستشهد الإجابات بالمصادر المستخرجة من ملفاتك.

إذا لم تظهر الاستشهادات، تحقّق في إعدادات مساحة العمل من أن وضع RAG مفعّل (خيار 'وضع المحادثة' → 'استعلام')، وأن عدد القطع المُعادة أكبر من 0.

في الإعدادات → وضع تعدّد المستخدمين، فعّل الوضع متعدد المستخدمين. ادعُ زملاءك بالبريد الإلكتروني وعيّن الأدوار: المسؤول (وصول كامل)، المدير (إدارة مساحات العمل)، الافتراضي (الاستخدام فقط).

قيّد كل مستخدم بمساحات العمل التي تخصّه فقط. من واجهة الإدارة، يمكنك أيضًا تهيئة SSO أو مصادقة خارجية إذا دعم ذلك مزوّد LLM.