🗄️ تثبيت SurrealDB — قاعدة بيانات متعددة النماذج بالرسم البياني والمستندات على Docker

نشر منصة SurrealDB على Ubuntu باستخدام Docker — قاعدة البيانات مفتوحة المصدر الثورية المبنية بلغة Rust التي تجمع بين الجداول العلائقية، والمستندات المرنة، والرسوم البيانية (Graph)، وبحث المتجهات، والاستعلامات الحية الفورية على المنفذ 8000.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر SurrealDB على المنفذ 8000 مع محرك تخزين دائم ومحرك استعلامات SurrealQL جاهزاً.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/surrealdb/surrealdb-ubuntu.sh
chmod +x surrealdb-ubuntu.sh
sudo bash surrealdb-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/surrealdb/surrealdb-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x surrealdb-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./data`) وضبط بيانات المصادقة وتشغيل حاوية SurrealDB بمحرك تخزين الملفات على المنفذ 8000.

sudo bash surrealdb-ubuntu.sh

4 الاتصال عبر Surrealist أو حزم SDK

افتح تطبيق الويب Surrealist (عبر surrealist.app) أو الطرفية واتصل بالرابط http://ip-سيرفرك:8000. سجل الدخول ببيانات المشرف، وأنشئ مساحات الأسماء وقواعد البيانات، واكتب استعلامات SurrealQL واشترك بالاستعلامات الحية.

curl http://:8000/health
# surreal sql --endpoint http://:8000 --user root --pass yourpass --ns test --db test

المنافذ المستخدمة

المنفذالغرض
8000HTTP API + WebSocket (live queries) + health

نظرة عامة

تعد SurrealDB قاعدة بيانات متطورة وشاملة ومتعددة النماذج (Multi-Model) تم بناؤها بالكامل بلغة Rust. تعمل المنصة عبر المنفذ 8000، وتجمع بين الجداول العلائقية (Relational Tables)، ومستندات JSON المرنة، وعلاقات الرسوم البيانية المتشابكة (Graph Database)، وسجلات السلاسل الزمنية، والبيانات الجغرافية، وبحث متجهات الذكاء الاصطناعي داخل محرك واحد متكامل فائق السرعة. وتعتمد على لغة استعلامات SurrealQL القوية الشبيهة بـ SQL، وتدعم البث الحي الفوري عبر WebSockets (`LIVE SELECT`)، ونظام مصادقة JWT مدمج مع تحكم دقيق بالأذونات.

لماذا تستخدمه

يتطلب بناء التطبيقات الحديثة دمج عدة قواعد بيانات منفصلة: PostgreSQL للجداول العلائقية، وMongoDB للمستندات، وNeo4j للرسوم البيانية والعلاقات، وRedis للبث اللحظي، وPinecone لمتجهات الذكاء الاصطناعي. تستبدل SurrealDB كل هذه المنظومات بمحرك واحد آمن الذاكرة مكتوب بـ Rust: استعلم عن علاقات الرسوم البيانية، وخزن مستندات JSON، واسترجع متجهات التضمين للذكاء الاصطناعي، واستقبل تحديثات WebSockets الفورية من محرك واحد عالي الأداء.

متى تحتاجه

  • تبحث عن قاعدة بيانات واحدة متعددة النماذج تجمع الجداول العلائقية والمستندات وعلاقات الـ Graph ومتجهات الذكاء الاصطناعي
  • تريد ربط تطبيقات الواجهة الأمامية والموبايل مباشرة بقاعدة البيانات بأمان باستخدام توكنات JWT وسياسات الأمان المدمجة
  • تحتاج إلى بث التحديثات الفورية للبيانات باستخدام استعلامات `LIVE SELECT` عبر مقابس WebSockets
  • تحتاج إلى معالجة واستعلام علاقات الرسوم البيانية المعقدة (مثل `user:ali->follows->user:omar`) دون الحاجة لتشغيل خوادم Neo4j الثقيلة
  • تريد قاعدة بيانات فائقة السرعة وآمنة الذاكرة مبنية بـ Rust تعمل بكفاءة عالية على سيرفرات متواضعة

من يحتاجه

  • مطورو الويب والتطبيقات (Next.js وSvelte وFlutter وRust) لبناء تطبيقات تفاعلية فورية بسرعة فائقة
  • مهندسو الذكاء الاصطناعي لتخزين متجهات التضمين (Embeddings) وقواعد المعرفة الرسومية في مكان واحد
  • مطورو الألعاب السحابية لتخزين حالات اللاعبين اللحظية وشبكات العلاقات بين العناصر في الوقت الفعلي
  • مؤسسو المشاريع الناشئة لإطلاق نماذج عمل سريعة دون إضاعة الوقت في بناء واجهات برمجة (REST APIs) وسيطة
  • أصحاب السيرفرات المنزلية لاستضافة قاعدة بيانات متعددة الاستخدامات وخفيفة للغاية على سيرفرات لينكس

حالات الاستخدام الشائعة

  • بناء تطبيق سبورة تفاعلية مشترك (Collaborative Canvas) يبث تعديلات الرسم لحظياً عبر `LIVE SELECT`
  • تمثيل شبكات التواصل الاجتماعي وخوارزميات التوصيات باستخدام استعلامات الرسوم البيانية (`->follows->`)
  • تخزين متجهات نصوص نماذج الذكاء الاصطناعي للبحث الدلالي واسترجاع المعرفة (RAG)
  • تمكين تطبيقات الموبايل من قراءة البيانات مباشرة باستخدام توكنات JWT المشفرة وأذونات الحقول الدقيقة
  • تسجيل قراءات حساسات إنترنت الأشياء (IoT) فائقة التردد والاستعلام الجغرافي عنها في أجزاء من الثانية

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

  • معمارية متعددة النماذج: جداول علائقية، ومستندات JSON، وروابط رسوم بيانية (Graph)، وبحث متجهات AI
  • لغة استعلامات SurrealQL: بناء جمل يشبه SQL مع دعم متقدم للتنقل بين الرسوم البيانية والعمليات الحسابية
  • استعلامات حية عبر WebSockets: الاشتراك في التغييرات الفورية (`LIVE SELECT`) مع استقبال التحديثات لحظياً
  • ربط مباشر بتطبيقات الواجهة: تحكم دقيق بالأذونات (PERMISSIONS FOR select, create) مع توكنات JWT
  • بحث متجهات مدمج: فهرسة (HNSW وMTREE) وبحث متجهات التضمين لتطبيقات الذكاء الاصطناعي التوليدي
  • معاملات ACID متكاملة: ضمان اتساق وسلامة البيانات عبر الجداول والعمليات المختلفة
  • حزم SDK رسمية متطورة: دعم كامل للغات JavaScript وTypeScript وPython وRust وGo وJava و.NET
  • معمارية Docker Compose تجمع SurrealDB مع مجلد `./data` باستخدام محرك تخزين RocksDB / Surrealkv

كيفية الاستخدام بعد التثبيت

  • افتح متصفحك وانتقل إلى تطبيق https://surrealist.app (أو اختبر الصحة عبر `curl http://ip-سيرفرك:8000/health`)
  • اتصل برابط السيرفر `http://ip-سيرفرك:8000` وسجل الدخول بحساب المشرف (`root` / كلمة المرور المحددة)
  • حدد مساحة الأسماء (Namespace) مثل `production` وقاعدة البيانات (Database) مثل `main`
  • اكتب استعلام SurrealQL تجريبي: `CREATE user:john SET name = 'John Doe', email = 'john@example.com';`
  • أنشئ علاقة رسوم بيانية: `RELATE user:john->purchased->product:laptop SET date = time::now();`
  • ضع SurrealDB خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع تفعيل ترويسات WebSocket
  • أعد سكريبت نسخ احتياطي دوري لمجلد التخزين الدائم `./data`

أفضل ممارسات الأمان

  • تنبيه أمني حاسم: لا تشغل SurrealDB بوضع `--unauthenticated` في الإنتاج نهائياً؛ وافرض دائماً المصادقة بكلمة مرور (`--auth`)
  • استخدم تشفير HTTPS دائماً في الإنتاج لحماية البيانات المنقولة وتوكنات الدخول عبر الشبكة
  • حدد سياسات أمان دقيقة (`DEFINE SCOPE` و`PERMISSIONS`) عند السماح للتطبيقات بالاتصال المباشر بقاعدة البيانات
  • عيّن كلمات مرور معقدة وعشوائية لحساب المشرف الأساسي (Root) في متغيرات البيئة
  • احمِ مجلد البيانات `./data` بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات محرك الاستعلامات

المنافذ وإعدادات جدار الحماية

يقدم SurrealDB واجهات الـ REST API واستعلامات WebSocket الحية عبر منفذ TCP 8000. يجب السماح بالمنفذ 8000 في جدار الحماية للشبكة المحلية (`ufw allow 8000/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تفعيل ترويسات WebSockets وأبقِ المنفذ 8000 مغلقاً خارجياً.

النسخ الاحتياطي والصيانة

  • انسخ كامل مجلد `./data` احتياطياً، والذي يحتوي على ملفات محرك التخزين RocksDB / Surrealkv
  • استخرج نسخة احتياطية بصيغة SurrealQL عبر أداة الطرفية: `surreal export --conn http://localhost:8000 backup.surql`
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على المتغيرات ومسارات التخزين
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة باستيراد ملفات `.surql` بحاوية تجريبية للتأكد من استرجاع البيانات وعلاقات الـ Graph بنجاح

الأخطاء الشائعة

  • تشغيل SurrealDB بوضع الذاكرة المؤقتة (`memory`) بدلاً من وضع حفظ الملفات (`surrealkv://data` أو `rocksdb:data`) مما يسبب فقدان البيانات عند إعادة التشغيل
  • ترك خيار `--unauthenticated` مفعلاً مما يتيح لأي شخص بالشبكة حذف وتعديل كافة البيانات
  • نسيان تفعيل ترويسات WebSocket في Nginx مما يعطل استعلامات البث المباشر `LIVE SELECT`
  • عدم ربط مجلد التخزين الدائم `./data` في ملف Docker Compose
  • السماح للمستخدمين بالاتصال بدون تحديد سياسات الأمان والأذونات على مستوى الجداول

استكشاف الأخطاء وإصلاحها

  • فشل المصادقة — تأكد من تطابق اسم المستخدم وكلمة المرور ومساحة الأسماء (NS) وقاعدة البيانات (DB) في ترويسات الطلب
  • الاستعلامات الحية لا تستقبل تحديثات — تأكد من تفعيل ترويسات `Upgrade: websocket` و`Connection: Upgrade` في Nginx
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs surrealdb -f`
  • خطأ في صلاحيات إقلاع قاعدة البيانات — اضبط ملكية مجلد التخزين بالأمر: `chown -R 1000:1000 ./data`
  • فشل استعلام الرسوم البيانية — تأكد من استخدام أقواس الأسهم الصحيحة للـ Graph (`->` و`<-`)

البدائل

قاعدة بيانات PostgreSQL العلائقية المعيارية. قاعدة بيانات MongoDB للمستندات. قاعدة بيانات Neo4j المتخصصة في الرسوم البيانية. منصات Supabase وPocketBase الشاملة. قاعدة بيانات Redis للذاكرة المؤقتة.

متى لا تستخدمه

تجنب استخدام SurrealDB إذا كنت تعتمد على بيئات عمل كلاسيكية وأطر عمل قديمة تتطلب محركات ORM تقليدية خاصة بـ SQL القياسي (مثل Hibernate أو Django ORM القديم)، حيث تعد PostgreSQL معيارية أكثر. وإذا كنت تحتاج فقط لذاكرة تخزين مؤقت بسيطة، فإن Redis أخف.

هل تحتاج مساعدة احترافية؟

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

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

ما هي SurrealDB ولماذا تسمى قاعدة بيانات متعددة النماذج؟

تعد SurrealDB قاعدة بيانات عصرية مبنية بلغة Rust تجمع أصلياً إمكانيات الجداول العلائقية، ومستندات JSON، وروابط الرسوم البيانية (Graph)، وبحث المتجهات داخل محرك واحد، مما يتيح للمطورين استعلام كافة هذه النماذج بلغة موحدة (SurrealQL).

كيف تعمل الاستعلامات الحية (Live Queries) في SurrealDB؟

باستخدام أمر `LIVE SELECT * FROM table;` عبر اتصال WebSocket، تقوم SurrealDB تلقائياً ببث حزم التحديثات اللحظية (إضافة، تعديل، حذف) فور حدوث أي تغيير في البيانات المطابقة بقاعدة البيانات.

هل يمكن لتطبيقات الواجهة الأمامية الاتصال بـ SurrealDB مباشرة بدون خادم وسيط؟

نعم! تتضمن SurrealDB نظام مصادقة وتحقق من توكنات JWT مع قواعد أمان دقيقة على مستوى الحقول والصفوف (`PERMISSIONS FOR select, create, update, delete`)، مما يتيح الاتصال المباشر والآمن من التطبيقات.

هل تدعم SurrealDB بحث المتجهات لتطبيقات الذكاء الاصطناعي؟

نعم! تدعم SurrealDB أنواع البيانات المتجهية، وفهارس HNSW وMTREE، ودوال حساب المسافات الدلالية (Cosine وEuclidean) لتخزين واسترجاع متجهات التضمين للذكاء الاصطناعي وتطبيقات RAG.

كم تستهلك SurrealDB من الذاكرة العشوائية (RAM)؟

نظراً لأن SurrealDB مبنية من الصفر بلغة Rust، فهي فائقة الخفة، حيث تستهلك عادة ما بين 30 إلى 90 ميجابايت فقط من الذاكرة العشوائية داخل Docker.