لماذا تستضيف Quivr ذاتيًا على خادم VPS
ينظّم Quivr معارفك في وحدات معرفية (تُسمّى brains) ويستخدم خطّ معالجة RAG حديثًا يعتمد على Supabase (PostgreSQL + pgvector) للتخزين المتجهي، وواجهة خلفية بلغة Python (FastAPI)، وواجهة أمامية بـ Next.js. تفرض النسخة السحابية حصصها وتخزّن بياناتك لدى الناشر؛ أما باستضافته على خادم VPS فتحتفظ بالسيطرة على قاعدة Supabase والملفات المرفوعة ومفاتيح نماذج LLM. وهذا وجيه بشكل خاص لوكالة تريد قاعدة معرفة بالذكاء الاصطناعي مشتركة بين المستشارين، مع مصادقة، دون تسليم مستندات العملاء إلى خدمة طرف ثالث ودون سقف استخدام مصطنع.
الفوائد الملموسة للاستضافة الذاتية
- تخزين كل معارفك في نسخة Supabase الخاصة بك
- التنظيم في عدة brains موضوعية مع إدارة دقيقة للأذونات
- استيعاب متنوّع: PDF وDOCX والصوت المُفرَّغ نصيًا وصفحات الويب والملفات النصية
- واجهة REST API قابلة للاستغلال لدمج Quivr في تطبيقاتك الداخلية
- حرية اختيار نموذج LLM (OpenAI أو Anthropic أو Ollama محلي) دون فوترة مفروضة
- لا حصة للأسئلة ولا للتخزين يمليها مزوّد SaaS
المتطلبات العتادية والبرمجية
Quivr حزمة متعددة الخدمات (واجهة أمامية، وواجهة خلفية، وعامل، وSupabase كامل، وRedis). وهو الأداة الأكثر استهلاكًا للموارد في هذه السلسلة من حيث المكوّنات. خصّص 4 أنوية vCPU و8 غيغابايت من ذاكرة RAM كحدّ أدنى، على أن يكون 16 غيغابايت مريحًا إذا أضفت نموذج LLM محليًا، إضافة إلى 20 إلى 30 غيغابايت من القرص لقاعدة Postgres والتضمينات (embeddings) والملفات. أما برمجيًا: فيلزم Docker وDocker Compose حتمًا (الحزمة تعتمد عليهما)، ونطاق مع نطاقات فرعية للواجهة الأمامية وواجهة API، ومفتاح API واحد على الأقل لنموذج LLM إضافة إلى مفتاح للتضمينات. ويسهّل عرض النطاق الترددي الجيد استيعاب الملفات الكبيرة.
نشر Quivr باستخدام Docker Compose
استنساخ البيئة وتهيئتها
على خادم VPS، نفّذ git clone https://github.com/QuivrHQ/quivr && cd quivr. انسخ ملفات الأمثلة: cp .env.example .env واملأ المفاتيح (OPENAI_API_KEY ومفاتيح Supabase وJWT_SECRET_KEY).
تهيئة Supabase
يتضمّن Quivr حزمة Supabase الخاصة به. شغّل هجرة قاعدة البيانات المُرفَقة لإنشاء الجداول وامتدادات pgvector وسياسات RLS اللازمة لتخزين الـ brains والتضمينات.
تشغيل الحزمة الكاملة
شغّل جميع الخدمات بـ docker compose pull && docker compose up -d. تتضمّن الحزمة الواجهة الخلفية FastAPI وعامل الاستيعاب وRedis والواجهة الأمامية Next.js. تحقّق من الحالة بـ docker compose ps.
التحقق من عامل الاستيعاب
تمرّ معالجة الملفات عبر عامل غير متزامن. راقب سجلّاته (docker compose logs -f worker) عند أول رفع للتأكد من أن التقطيع والتحويل المتجهي يكتملان دون خطأ.
تهيئة الوكيل العكسي وSSL
وجّه app.yourdomain.com إلى الواجهة الأمامية وapi.yourdomain.com إلى الواجهة الخلفية عبر Caddy أو Nginx، ولكلٍّ شهادته من Let's Encrypt. تأكّد من أن الواجهة الأمامية تشير فعلاً إلى عنوان URL العام لواجهة API في ملف .env الخاص بها.
إنشاء أول حساب والاختبار
افتح الواجهة الأمامية، وأنشئ حسابًا عبر مصادقة Supabase، وأنشئ brain، وارفع مستندًا واطرح سؤالًا للتحقق من سلسلة RAG من طرف إلى طرف.
راقب ذاكرة عامل الاستيعاب: قد تُشبِع ملفات PDF الكبيرة والملفات الصوتية المطلوب تفريغها ذاكرة RAM وتُفضي إلى قتل الحاوية بواسطة OOM killer. حُدّ من حجم الملفات المرفوعة على مستوى الوكيل العكسي (client_max_body_size في Nginx)، وإذا كنت تستوعب الكثير، فحوّل التضمينات إلى خدمة مخصّصة بدل معالجة كل شيء على العامل الافتراضي.
