كيفية استضافة PrivateGPT على خادم VPS

لماذا تستضيف PrivateGPT ذاتيًا على خادم VPS

فوائد ملموسة للاستضافة الذاتية

• سرّية تامة: المستندات والتضمينات وفهرس Qdrant لا تغادر الخادم أبدًا
• إجابات موثّقة المصدر: كل إجابة تستند إلى مقاطع مستخرجة من ملفاتك، لا إلى الذاكرة العامة للنموذج
• لا تكاليف API عندما يعمل النموذج محليًا عبر Ollama أو llama.cpp
• استيعاب ملفات PDF وDOCX وPPTX وEPUB وCSV وMarkdown وأرشيفات البريد .mbox، بل والصور والملفات الصوتية، مرتّبةً في مجموعات (collections)
• واجهة API من نوع Messages (مستوحاة من مواصفات واجهة Anthropic) لربط PrivateGPT بأدواتك الداخلية
• امتثال أيسر للبيانات الحساسة (RGPD والسرّ المهني): لا معالج ذكاء اصطناعي إضافي

PrivateGPT وOllama: دوران متكاملان

PrivateGPT مقابل Ollama: من يفعل ماذا

مرّر الجدول أفقيًا

المتطلبات المادية والبرمجية

قائمة التحقق قبل التثبيت

• خادم VPS بذاكرة 8 غيغابايت على الأقل (16 غيغابايت لنموذج بتسعة مليارات معامل) و4 وحدات vCPU
• Debian 12 أو Ubuntu 24.04 محدَّث، مع وصول SSH بصلاحيات sudo
• Docker مثبّت (الأمر docker version يستجيب)، وإلا فـ uv مع Python 3.11
• 30 غيغابايت متاحة على القرص، ويُفضَّل NVMe، للنماذج والمجلد local_data/
• نطاق فرعي (مثل docs.your-domain.com) يشير إلى عنوان IP الخاص بالخادم
• جدار حماية مفعَّل: لا يُفتح إلا SSH و80 و443، ويبقى المنفذان 8080 و11434 مغلقين

نشر PrivateGPT في الوضع المحلي

1. 01

   تثبيت Ollama وتنزيل النماذج

   ثبّت Ollama بالسكربت الرسمي، ثم نزّل نموذج LLM مناسبًا للمعالج ونموذج التضمين الموصى به:

   curl -fsSL https://ollama.com/install.sh | sh
   ollama pull qwen3.5:4b
   ollama pull mxbai-embed-large

   افتراضيًا، لا يستمع Ollama إلا على 127.0.0.1:11434: أبقِه كذلك، فـ PrivateGPT وحده يحتاج إلى الوصول إليه. هذه هي الخطوة الوحيدة التي تحتاج إلى الإنترنت؛ فبعد تنزيل النماذج يجري الاستدلال دون اتصال.

2. 02

   تشغيل PrivateGPT عبر Docker

   تتضمن الصورة الرسمية zylonai/private-gpt الحزمة core. على Linux، يجب أن تشارك الحاوية شبكة المضيف لتصل إلى Ollama على localhost، ويجب أن يحفظ مجلدٌ مركَّب (volume) البيانات، وإلا اختفت المستندات المستوعَبة عند إعادة التشغيل:

   mkdir -p /opt/privategpt/local_data
   docker run -d --name privategpt --restart unless-stopped \
     --network host \
     -e OPENAI_API_BASE=http://localhost:11434/v1 \
     -v /opt/privategpt/local_data:/home/worker/app/local_data \
     zylonai/private-gpt:latest

   عند الإقلاع، يستدعي PrivateGPT المسار GET /v1/models على Ollama ويسجّل النماذج التي يجدها تلقائيًا: لا حاجة إلى أي ملف إعدادات. ولا يلزم المتغير OPENAI_EMBEDDING_API_BASE إلا إذا كانت التضمينات تُقدَّم من مكان آخر.

3. 03

   استيعاب مستنداتك حسب المجموعات

   أرسل ملفاتك إلى واجهة الاستيعاب مع تجميعها في مجموعات، كأن تخصّص مجموعة لكل ملف عميل أو لكل قسم:

   curl -X POST http://localhost:8080/v1/artifacts/ingest \
     -F "file=@/srv/documents/contrat-cession.pdf" \
     -F "collection=legal"
   curl "http://localhost:8080/v1/artifacts/list?collection=legal"

   يقطّع PrivateGPT كل ملف ويحوّله إلى متجهات ويفهرسه في Qdrant. أما الصيغ التي لا قارئ مخصّصًا لها فتُقرأ نصًا عاديًا.

4. 04

   الاستعلام عن المجموعة مع ذكر المصادر

   اختبر أولًا في Workbench (http://localhost:8080/ui)، ثم اربط أدواتك بواجهة Messages. يمرّ البحث في المستندات عبر الأداة المدمجة semantic_search_v1 مقصورةً على مجموعة واحدة:

   curl http://localhost:8080/v1/messages \
     -H "Content-Type: application/json" \
     -d '{"model": "qwen3.5:4b",
          "messages": [{"role": "user", "content": "ما الشروط الواقفة في العقد؟"}],
          "tools": [{"name": "search_docs", "type": "semantic_search_v1",
                     "context": [{"type": "ingested_artifact", "context_filter": {"collection": "legal"}}]}]}'

5. 05

   إعداد الوكيل العكسي وشهادة SSL والمصادقة

   لا يملك Workbench أي تحكم في الوصول: والتوثيق يقصره على الاستخدام المحلي. لا تعرضه إلا خلف Nginx أو Caddy، مع شهادة Let's Encrypt ومصادقة أساسية:

   server {
       listen 443 ssl;
       server_name docs.your-domain.com;
       ssl_certificate     /etc/letsencrypt/live/docs.your-domain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/docs.your-domain.com/privkey.pem;
       auth_basic           "Restricted access";
       auth_basic_user_file /etc/nginx/.htpasswd;
       location / { proxy_pass http://127.0.0.1:8080; }
   }

   وإن كان مستخدموه شخصين أو ثلاثة فقط، فإن نفق SSH (ssh -L 8080:127.0.0.1:8080 user@your-vps) يغنيك عن أي عرض علني.

6. 06

   إحكام إغلاق الوصول

   يستمع PrivateGPT افتراضيًا على 0.0.0.0، ولذلك تنشر شبكة المضيف المنفذ 8080 على كل الواجهات. أغلقه في جدار الحماية حتى لا يبقى متاحًا سوى الوكيل العكسي:

   ufw default deny incoming
   ufw allow OpenSSH
   ufw allow 80,443/tcp
   ufw enable

   يمرّ مستخدموك عندها عبر https://docs.your-domain.com ويستعلمون عن المستندات بلغة طبيعية.

النسخ الاحتياطي والتحقق من عدم خروج أي بيانات

ss -tnp state established

استكشاف الأخطاء: الأعطال الأكثر شيوعًا