التطوير

Typesense

Typesense — محرك بحث C++، متسامح مع الأخطاء، ذو واجهات وبحث متجهي عبر REST API. حاوية واحدة، أقل من 150 MB ذاكرة، رخصة GPLv3.

الوثائق الرسمية

حول Typesense

Typesense (GPLv3، 26 ألف نجمة+ على GitHub، v29.0) محرك بحث مفتوح المصدر مكتوب بلغة C++. يوفر REST API واضحًا للفهرسة والاستعلام بتحمّل الأخطاء الإملائية، والتصفية متعددة الوجوه، والبحث المتجهي الدلالي، وأوقات استجابة بالمللي ثانية — كل ذلك في حاوية Docker واحدة، دون JVM أو إعداد عناقيد معقّدة.

على خادم ServOrbit، يصبح Typesense طبقة البحث في تطبيقك — سواء كنت تبني كتالوج منتجات متعدد اللغات، أو بوابة توثيق بالبحث الفوري، أو ميزة بحث دلالي مدعومة بتضمينات OpenAI أو نموذج محلي. تتوفر مكتبات عميل رسمية لـ JavaScript وPython وPHP وRuby وGo وDart وJava وSwift.

ما يُثبَّت

جاهز عند تشغيل الخادم

أنظمة التشغيل المتوافقة
Ubuntu 24.04
التطبيق
Typesense
المنظومة التقنية
DockerC++
الحد الأدنى من RAM
1 غيغابايت (4 غيغابايت للمجموعات الكبيرة أو البحث المتجهي)
الحد الأدنى من CPU
1 vCPU
المنفذ الافتراضي
8108
الوصول
root عبر SSH

الميزات الرئيسية

  • تحمّل الأخطاء الإملائية بالمطابقة التقريبية — استعلام عن 'محمد' يجد 'Mohammed' دون قاموس أو إعداد
  • بحث متعدد الوجوه والتصفية — صفِّح حسب الفئة والسعر والعلامة مع إحصاءات حية
  • بحث متجهي / دلالي مدمج — فهرِس متجهات التضمين مع حقول النص وشغّل استعلامات هجينة
  • محرك C++ مع ثبات قائم على RAFT، بلا توقفات JVM
  • مفاتيح API محدودة النطاق — أنشئ مفاتيح للبحث فقط أو مقيّدة بفهرس معين
  • رخصة GPLv3، 26 ألف نجمة+ على GitHub — إصدارات أسبوعية، SDKs رسمية لـ 9 لغات

متى تستخدم هذا الحل؟

بحث كتالوج المنتجات

فهرِس منتجاتك مع السعر والفئة والمخزون. يحصل المستخدمون على نتائج فورية متسامحة مع الأخطاء أثناء الكتابة، مع واجهات للتضييق — من خادم VPS الخاص بك، بلا رسوم لكل استعلام.

البحث الفوري في التوثيق وقاعدة المعرفة

افهرِس مستنداتك الـMarkdown أو مدونة Ghost في Typesense وأضف شريط بحث أثناء الكتابة. يدعم المحلل اللغوي المتعدد العربية والفرنسية والإنجليزية بشكل مدمج.

البحث الهجين: كلمات مفتاحية + دلالي

خزّن تضمينات OpenAI أو نموذج محلي مع حقول النصوص وشغّل استعلامات هجينة تجمع BM25 مع ANN متجهي — دون قاعدة بيانات متجهية منفصلة.

الدليل

نشر Typesense على خادم VPS الخاص بك

  1. اطلب خادم VPS من ServOrbit

    يعمل Typesense بأقل من 150 MB ذاكرة للمجموعات النموذجية؛ يكفي خادم VPS بـ 1 GB للانطلاق. ويثبّت التجهيز Docker على صورة Ubuntu ويهيّئ المنظومة.

  2. انشر التطبيق من الـ Marketplace

    من فضاء العميل في ServOrbit، اذهب إلى Marketplace ← التطوير ← Typesense ← نشر. تنطلق حاوية واحدة typesense/typesense:29.0 مع وحدة تخزين مسمّاة لـ /data ومفتاح API عشوائي معروض في فضاء العميل.

  3. استخدم الـ API أول مرة

    Typesense ليس له شاشة دخول: إنه محرك بحث يُقاد عبر API محمي بمفتاح. استخدم المفتاح المُسلَّم إليك في ترويسة X-TYPESENSE-API-KEY مع كل طلب، مثلًا: curl -H 'X-TYPESENSE-API-KEY: <مفتاحك>' http://127.0.0.1:8108/health

  4. اجعل الـ API متاحة لتطبيقاتك

    تنصت REST API على المنفذ 8108، المنشور على الحلقة المحلية. انشرها خلف Nginx أو Caddy على نطاقك عبر HTTPS للتطبيقات البعيدة، أو افتح نفقًا SSH: ssh -L 8108:127.0.0.1:8108 root@<عنوان-IP> ثم http://localhost:8108.

  5. فهرِس بياناتك الأولى وابحث فيها

    أنشئ مجموعة وأضف مستندات: curl -X POST 'http://127.0.0.1:8108/collections' -H 'X-TYPESENSE-API-KEY: <مفتاح>' -H 'Content-Type: application/json' -d '{"name":"products","fields":[{"name":"name","type":"string"}]}'. ثم ابحث: curl 'http://127.0.0.1:8108/collections/products/documents/search?q=vps&query_by=name' -H 'X-TYPESENSE-API-KEY: <مفتاح>'.

الأسئلة الشائعة

أسئلة حول Typesense

→ العودة إلى التطويركل التطبيقات
كلاهما محركا بحث مفتوحا المصدر مستضافان ذاتيًا بتحمّل الأخطاء وREST API. Typesense (C++، GPLv3) مُحسَّن لزمن الاستجابة الصارم ويتضمن بحثًا متجهيًا مدمجًا. Meilisearch (Rust، MIT) أسهل في الإعداد وأنسب للمجموعات الصغيرة. يمكنك تشغيلهما معًا في نفس الخادم.

إضافة زر النشر

هل تدير مشروعًا يستخدم Typesense؟ يتيح هذا الزر لقرّائك نشره على خادم VPS بنقرة واحدة، دون قراءة وثائق Docker.

Deploy Typesense on ServOrbit
Markdown
[![Deploy Typesense on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=typesense&utm_source=deploy-badge&utm_medium=referral&utm_campaign=typesense)
HTML
<a href="https://servorbit.com/vps-cloud?template=typesense&utm_source=deploy-badge&utm_medium=referral&utm_campaign=typesense"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Typesense on ServOrbit" height="40"></a>

يشير الزر إلى طلب خادم ‎VPS مع تحديد القالب مسبقًا. تُقدَّم الصورة من ‎servorbit.com — لا شيء تستضيفه من جهتك.

حلول تكميلية

التطوير

Meilisearch

محرك بحث نصي كامل مستضاف ذاتيًا: أضف بحثًا فوريًا ومتسامحًا مع الأخطاء الإملائية لتطبيقاتك عبر REST API — 57 ألف نجمة على GitHub، حاوية واحدة بـ Rust، أقل من 100 MB ذاكرة.

بحاجة إلى مساعدة؟

تصفّح مركز المساعدة والأسئلة الشائعة، أو تواصل مع فريقنا — معاودة اتصال أو WhatsApp أو بريد إلكتروني.

راسلنا على WhatsAppيُفتح في علامة تبويب جديدة
أو راسلنا