🕸️ تثبيت Neo4j — قاعدة البيانات البيانية الرائدة مع إضافات APOC على Docker

نشر قاعدة بيانات Neo4j 5 على Ubuntu باستخدام Docker — محرك قواعد البيانات البيانية (Graph Database) الرائد عالمياً، مدعوماً بلغة استعلام Cypher وإضافات APOC المتقدمة وواجهة المتصفح التفاعلية.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Neo4j 5 مع حزمة إضافات APOC ومجلدات التخزين الدائمة على المنفذ 7474 لواجهة الويب والمنفذ 7687 لبروتوكول Bolt.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/databases/neo4j/neo4j-ubuntu.sh

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

chmod +x neo4j-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وسحب صورة neo4j:5 الرسمية وتوليد بيانات اعتماد قوية وتفعيل ملحقات APOC وتشغيل الحاوية على المنفذين 7474 و7687.

sudo bash neo4j-ubuntu.sh

4 الوصول إلى واجهة الاستعلام

افتح متصفح الويب وانتقل إلى الرابط http://ip-سيرفرك:7474 لفتح متصفح Neo4j التفاعلي. سجل الدخول باستخدام بيانات الاعتماد المولدة لتنفيذ استعلامات Cypher واستعراض شبكات العلاقات بيئياً.

http://<your-server-ip>:7474

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

المنفذالغرض
7474HTTP REST API + Browser UI

نظرة عامة

تعتبر Neo4j المنصة الرائدة عالمياً في مجال قواعد البيانات البيانية الأصيلة (Native Graph Database)، والمصممة خصيصاً لتخزين وإدارة واستعلام البيانات شديدة الترابط. على عكس قواعد البيانات العلائقية (التي تعاني من بطء عمليات الربط المتعددة JOIN) أو قواعد بيانات المستندات، تعامل Neo4j العلاقات بين الكيانات كعناصر أساسية من الدرجة الأولى مع ميزة المجاورة المباشرة بدون فهارس (Index-Free Adjacency)، مما يتيح استعراض المسارات المعقدة بسرعة فائقة وثابتة مهما كان حجم قاعدة البيانات الكلي. وبفضل لغة استعلام Cypher البصرية ومكتبة إجراءات APOC المدمجة، تتفوق Neo4j في بناء الرسوم المعرفية، وكشف الاحتيال، وأنظمة التوصية، ورسم خرائط أمان الشبكات.

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

عندما تكون العلاقات بين البيانات متشابكة وعميقة (مثل الشبكات الاجتماعية، وسلاسل الإمداد، وتفرعات الصلاحيات)، تشهد قواعد البيانات التقليدية SQL انهياراً كبيراً في الأداء بسبب عمليات الربط التكرارية المكلفة. تحل Neo4j هذه المعضلة بتخزين مؤشرات العلاقات مباشرة على القرص كروابط مادية. ويستغرق التنقل بين ملايين العقد المترابطة أجزاءً من الثانية بدلاً من دقائق. بالإضافة إلى ذلك، يتيح نموذج البيانات البياني كتابة استعلامات واضحة وسلسة بلغة Cypher تحاكي العلاقات الواقعية بدقة.

متى تحتاجه

  • تقوم بنمذجة بيانات شديدة الترابط حيث تكون العلاقات بين العناصر بنفس أهمية البيانات نفسها
  • يتطلب تطبيقك تتبع مسارات علاقات عميقة ومتعددة القفزات يصعب تنفيذها أو تصبح بطيئة جداً باستخدام SQL JOINs
  • تبني رسماً بيانياً معرفياً (Knowledge Graph) أو محرك توصيات ذكي أو نظام إدارة البيانات الرئيسية (MDM)
  • تحتاج إلى كشف أنماط الاحتيال المالي وغسيل الأموال في الوقت الفعلي عبر شبكات المعاملات المترابطة
  • ترغب في استكشاف شبكات العلاقات بصرياً عبر واجهة تفاعلية دون الحاجة لكتابة استعلامات معقدة

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

  • بناء الرسوم المعرفية للمؤسسات لربط المستندات غير المهيكلة بالكيانات والتصنيفات والمفاهيم
  • كشف حلقات الاحتيال المالي عبر كشف الحسابات المشتركة والمعاملات الدائرية المتزامنة
  • تطوير محركات التوصية المخصصة للمستخدمين بالاعتماد على الفلترة التعاونية وشبكات الاهتمامات المشتركة
  • رسم خرائط البنية التحتية لتكنولوجيا المعلومات وشبكات السحابة لحساب أثر الأعطال والتهديدات الأمنية
  • إدارة أشجار الصلاحيات المعقدة والتحكم في الوصول القائم على الأدوار (RBAC) مع استعلام فوري للصلاحيات

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

  • محرك تخزين ومعالجة بياني أصيل مع ميزة المجاورة المباشرة (Index-Free Adjacency) لسرعة استثنائية
  • لغة استعلام Cypher البصرية والتصريحية المصممة خصيصاً لمطابقة الأنماط البيانية بسهولة
  • واجهة متصفح Neo4j Browser التفاعلية على المنفذ 7474 لاستكشاف الرسوم البيانية وفحص البنية بصرياً
  • بروتوكول Bolt الثنائي فائق الأداء على المنفذ 7687 مع مكتبات رسمية للغات Python وJava وJS وGo و.NET
  • حزمة ملحقات APOC مثبتة مسبقاً لاستيراد وتصدير البيانات (JSON وCSV) وخوارزميات الرسوم البيانية المتقدمة
  • دعم كامل لمعايير ACID لضمان سلامة واتساق المعاملات وتخزينها الدائم
  • نموذج الرسم البياني الموصوف (Property Graph) الذي يتيح إضافة خصائص غير محدودة للعقد والعلاقات
  • نشر معزول عبر Docker مع فصل مجلدات البيانات والسجلات والاستيراد والملحقات لتسهيل الترقية والصيانة

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

  • افتح واجهة Neo4j Browser في المتصفح عبر الرابط http://ip-سيرفرك:7474
  • اتصل بالخادم عبر بروتوكول Bolt باستخدام العنوان bolt://ip-سيرفرك:7687 واسم المستخدم 'neo4j' وكلمة المرور المولدة
  • جرب الدرس التفاعلي المدمج في Cypher بكتابة ':play movie-graph' في شريط الاستعلامات والضغط على زر التشغيل
  • نفذ استعلامات Cypher تجريبية لإنشاء عقد: CREATE (p:Person {name: 'Alice'}) RETURN p;
  • ضع ملفات CSV أو JSON في مجلد /root/docker/neo4j/import لاستيراد البيانات الخارجية عبر LOAD CSV أو دوال APOC
  • اربط تطبيقاتك البرمجية باستخدام مكتبة Neo4j Driver الرسمية (مثل pip install neo4j في بايثون)

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

  • احتفظ بكلمة مرور المشرف في مدير كلمات مرور آمن وقم بتغييرها بشكل دوري
  • لا تكشف منفذ الويب 7474 مباشرة للإنترنت العام دون وكيل عكسي مشفر بـ HTTPS
  • قيد الوصول لمنفذ بروتوكول Bolt 7687 واقصره على عناوين IP خوادم التطبيقات الخلفية عبر جدار الحماية
  • عطل حزم دوال APOC غير المستخدمة في بيئة الإنتاج لمنع الاستعلامات غير الموثوقة
  • حدد حدود الذاكرة (الذاكرة المؤقتة Pagecache وذاكرة JVM Heap) لمنع استهلاك الخادم لموارد النظام
  • حدّث حاوية Neo4j دورياً لتطبيق التحديثات الأمنية وإصلاحات الأداء

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

يستخدم خادم Neo4j منفذين أساسيين: منفذ TCP 7474 لواجهة REST API ومتصفح الويب التفاعلي Neo4j Browser، ومنفذ TCP 7687 لبروتوكول Bolt الثنائي المستخدم من قبل مكتبات البرمجة والمتصفح. في الإنتاج، يوصى بتهيئة وكيل عكسي مشفر على المنفذ 443 للوصول للواجهة، وقصر المنفذ 7687 على خوادم التطبيقات فقط عبر UFW.

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

  • انسخ مجلد ./data احتياطياً، والذي يحتوي على ملفات التخزين البياني ومخطط البيانات والفهارس
  • استخدم أداة neo4j-admin database dump داخل الحاوية لأخذ نسخة احتياطية ثنائية متسقة ومضغوطة
  • احتفظ بنسخة من ملفات الإعدادات وملفات الاستيراد في مجلد ./import والملحقات في ./plugins
  • جدول عمليات نسخ احتياطي دورية وارفعها لمساحة تخزين سحابية آمنة عبر restic أو rsync
  • اختبر دورياً استعادة النسخة الاحتياطية في بيئة تجريبية للتأكد من سلامة الجداول واسترجاع الرسوم البيانية

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

  • استخدام كلمات مرور افتراضية أو ضعيفة على خوادم متصلة بالإنترنت العام
  • إهمال ضبط حجم الذاكرة المؤقتة (Pagecache) وذاكرة JVM Heap للرسوم البيانية الضخمة، مما يسبب بطء الاستعلامات
  • استخدام أمر LOAD CSV للملفات الضخمة دون تقسيم المعاملات عبر apoc.periodic.iterate مما يسبب أخطاء نفاد الذاكرة
  • التعامل مع Neo4j كقاعدة بيانات علائقية وتصميم جداول ومفاتيح أجنبية بدلاً من نمذجة الكيانات والعلاقات بشكل بياني طبيعي
  • فتح منفذ Bolt 7687 للإنترنت العام دون تشفير TLS أو تقييد بعناوين IP الموثوقة

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

  • فشل تسجيل الدخول لمتصفح Neo4j — تأكد من صحة كلمة المرور وضبط عنوان Bolt على bolt://ip-سيرفرك:7687
  • فشل بدء الحاوية — راجع صلاحيات المجلدات في ./data و./logs، حيث تعمل Neo4j بالمستخدم 7474 (نفذ: chown -R 7474:7474 ./data ./logs ./import ./plugins)
  • بطء تنفيذ استعلامات Cypher — استخدم كلمة EXPLAIN أو PROFILE قبل الاستعلام لفحص خطة التنفيذ وإنشاء الفهارس المفقودة
  • خطأ OutOfMemory أثناء استيراد البيانات — ارفع حجم JVM Heap في إعدادات البيئة (NEO4J_server_memory_heap_max__size)
  • عدم العثور على دوال APOC — تأكد من احتواء docker-compose على متغير NEO4J_PLUGINS: '["apoc"]' ووجود ملف jar في مجلد plugins

البدائل

منصة Memgraph هي قاعدة بيانات بيانية تعمل بالكامل في الذاكرة ومتوافقة مع لغة Cypher وبروتوكول Bolt ومحسنة للسرعة الفائقة. قاعدة ArangoDB متعددة النماذج وتدعم الرسوم البيانية والمستندات في محرك واحد. إضافة Apache Age تضيف قدرات الرسوم البيانية واستعلامات Cypher فوق قاعدة PostgreSQL. خدمة Amazon Neptune خيار سحابي مدار من AWS يدعم openCypher وGremlin.

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

تجنب استخدام Neo4j إذا كانت بياناتك عبارة عن سجلات مسطحة وبسيطة لا تحتوي على علاقات هامة، أو إذا كانت عملياتك تتركز على العمليات الحسابية التجميعية لمليارات الصفوف (استخدم قواعد بيانات SQL أو مخازن الأعمدة مثل ClickHouse بدلاً منه). ولتخزين المستندات البسيطة دون تتبع علاقات، تعد MongoDB أو PostgreSQL أسهل وأبسط.

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

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

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

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

ما هي لغة Cypher؟

Cypher هي لغة استعلام تصريحية ومخصصة لقواعد البيانات البيانية ابتكرتها Neo4j. تستخدم أنماطاً بصرية تشبه الرسم مثل (p:Person)-[:FRIENDS_WITH]->(f:Person) لتمثيل العقد والعلاقات واستعلامها بوضوح وبساطة.

ما هو بروتوكول Bolt؟

Bolt هو بروتوكول شبكي ثنائي وعالي الأداء صُمم خصيصاً لقواعد البيانات البيانية. يعمل على المنفذ 7687 ويستخدم من قبل جميع مكتبات الربط الرسمية (Python وJava وJS وGo) للتواصل مع قاعدة البيانات بأقل تأخير ممكن.

ما هي حزمة إضافات APOC ولماذا هي مهمة؟

تعتبر APOC المكتبة المعيارية الشاملة لـ Neo4j، حيث توفر مئات الدوال والإجراءات الإضافية لاستيراد وتصدير البيانات (JSON وCSV)، وخوارزميات الرسوم البيانية، ومعالجة النصوص والمعاملات الضخمة.

كيف أقوم باستيراد ملفات CSV إلى Neo4j؟

ضع ملفات CSV في مجلد /root/docker/neo4j/import المربوط، ثم نفذ استعلام Cypher من متصفح Neo4j باستخدام أمر: LOAD CSV WITH HEADERS FROM 'file:///yourfile.csv' AS row لإنشاء العقد والعلاقات تلقائياً.

كم تحتاج Neo4j من الذاكرة العشوائية (RAM)؟

للقواعد البيانية الصغيرة والمتوسطة (أقل من مليون عقدة)، تعمل Neo4j بكفاءة بذاكرة تتراوح بين 1 إلى 2 جيجابايت. وللقواعد الضخمة التي تضم عشرات الملايين من العقد والعلاقات، يفضل تخصيص من 4 إلى 16 جيجابايت أو أكثر لـ JVM Heap والذاكرة المؤقتة.