لماذا تستضيف Qdrant ذاتيًا على خادم VPS
تخزّن Qdrant المتجهات (embedding vectors) وتستعلم عنها للعثور على العناصر الأقرب دلاليًا: وهي لبنة البحث في صميم روبوتات المحادثة القائمة على RAG ومحركات التوصية والبحث باللغة الطبيعية. ولأنها مكتوبة بلغة Rust، فهي سريعة ومقتصدة في الموارد، ما يجعلها مثالية للاستضافة على خادم VPS بدلًا من دفع اشتراك خدمة متجهية مُدارة تُحتسب تكلفتها لكل متجه مُخزَّن. الاستضافة الذاتية بالغة الأهمية لتطبيقات الذكاء الاصطناعي التي تعالج بيانات حساسة: فمتجهاتك، المشتقة غالبًا من مستندات داخلية سرية، لا تغادر بنيتك التحتية أبدًا. كما تتحكم في زمن الاستجابة، وهو أمر حاسم عندما يُطلق كل طلب مستخدم عملية بحث متجهي، وتتجنّب حدود المعدل الخاصة بواجهات API الخارجية عند ارتفاع الأحمال.
الفوائد الملموسة للاستضافة الذاتية لـ Qdrant
- بحث سريع عن أقرب الجيران (ANN) بفضل فهرس HNSW، حتى مع ملايين المتجهات.
- الترشيح حسب الحمولة (payload) مقترنًا بالبحث المتجهي للحصول على استعلامات هجينة دقيقة.
- التكميم القياسي (scalar) والثنائي (binary) لتقليل الذاكرة التي تشغلها المتجهات بشكل كبير.
- واجهتا REST وgRPC، بالإضافة إلى حِزم SDK رسمية لـ Python وJavaScript وRust جاهزة للاستخدام.
- الخصوصية: متجهاتك المشتقة من المستندات الداخلية تبقى على خادمك الـVPS.
- لا فوترة لكل متجه ولا لحجم الاستعلامات، على عكس الخدمات المُدارة.
المتطلبات المادية والبرمجية
يعتمد تحجيم Qdrant على عدد المتجهات وأبعادها. للبدء ببضع مئات الآلاف من المتجهات، يكفي 2 غيغابايت من ذاكرة RAM؛ وعند تجاوز المليون متجه ذي أبعاد عالية، استهدف من 4 إلى 8 غيغابايت، لأن فهرس HNSW يقيم في الذاكرة ليبقى سريعًا. ويتيح التكميم تقليل هذه البصمة. ويكفي معالج افتراضي واحد إلى اثنين (vCPU) لحركة مرور معتدلة. خصّص من 20 إلى 50 غيغابايت من قرص SSD لاستمرارية المجموعات واللقطات (snapshots). ستحتاج إلى Docker، وإلى نطاق إن كنت ستعرض واجهة API للعموم، وإلى مفتاح API لا محالة: فـ Qdrant لا تُفعّل أي مصادقة افتراضيًا، وعرض نسخة مفتوحة سيكون ثغرة كبرى.
انشر Qdrant خطوة بخطوة
تجهيز خادم VPS وDocker
ثبّت Docker واضبط جدار الحماية للسماح فقط بالمنفذين 80 و443. أنشئ سجل DNS من نوع A للنطاق vectors.mydomain.com يشير إلى عنوان IP الخاص بالخادم إن كنت تنوي عرض واجهة API عبر HTTPS.
تشغيل Qdrant مع الاستمرارية
استخدم صورة qdrant/qdrant. اربط وحدة تخزين (volume) على /qdrant/storage للحفاظ على مجموعاتك: volumes: - ./qdrant_storage:/qdrant/storage. تعرض Qdrant واجهة REST على 6333 وgRPC على 6334.
تفعيل المصادقة بمفتاح API
عرّف متغير البيئة QDRANT__SERVICE__API_KEY بمفتاح طويل وعشوائي (openssl rand -hex 32). فبدون هذا المفتاح، يمكن لأي شخص يصل إلى المنفذ أن يقرأ مجموعاتك ويحذفها.
إعداد الوكيل العكسي وTLS
ضع Caddy أمام المنفذ 6333: vectors.mydomain.com { reverse_proxy localhost:6333 }. يتولى Caddy إدارة شهادة Let's Encrypt. وإن كنت تستخدم gRPC من عملائك، فاضبط أيضًا توجيه المنفذ 6334 بالبروتوكول الصحيح.
إنشاء مجموعة وإدراج المتجهات
عبر واجهة API أو حزمة Python SDK، أنشئ مجموعة محدّدًا بُعد متجهاتك ونوع المسافة (Cosine أو Dot أو Euclid). فعّل التكميم القياسي منذ الإنشاء إن كانت ذاكرة RAM محدودة، ثم نفّذ upsert لنقاطك مع حمولتها (payload).
إعداد اللقطات والنسخ الاحتياطي
أطلق لقطات (snapshots) منتظمة عبر واجهة API (POST /collections/{name}/snapshots) وانسخها إلى تخزين خارجي. وباقترانها مع استمرارية وحدة التخزين، يضمن ذلك الاستعادة عند وقوع أي عطل.
عندما تصبح الذاكرة هي العامل المحدِّد، فعّل التكميم القياسي (int8) أو الثنائي: إذ يمكنه تقليص بصمة ذاكرة RAM للمتجهات بمقدار 4 إلى 32 ضعفًا، مع قدر يسير من الإفراط في العيّنات (oversampling) وقت الاستعلام للحفاظ على الدقة. اقرنه بالمعامل on_disk للمتجهات الأصلية كي لا تُبقي في الذاكرة سوى الفهرس المُكمَّم. هذا ما يتيح خدمة ملايين المتجهات على خادم VPS لا يملك سوى بضعة غيغابايت من ذاكرة RAM.
