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

انشر ArangoDB على Ubuntu بـ Docker — محرك قاعدة بيانات واحد يغطي المستندات والرسوم البيانية والقيم المفتاحية بلغة استعلام AQL واحدة، مع واجهة ويب على المنفذ 8529 وكلمة مرور جذر مولّدة تلقائياً.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر ArangoDB على المنفذ 8529 مع كلمة مرور جذر مولّدة من 24 حرفاً.
عرض على GitHub

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

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

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

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

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

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

chmod +x arangodb-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم، يولّد ARANGO_ROOT_PASSWORD من 24 حرفاً، ويشغّل ArangoDB مع ربط ./data بـ /var/lib/arangodb3 و./apps بـ /var/lib/arangodb3-apps.

sudo bash arangodb-ubuntu.sh

4 الدخول إلى واجهة الويب

يطبع المثبّت كلمة مرور الجذر المولّدة — احفظها. سجّل الدخول كمستخدم root:

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

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

المنفذالغرض
8529Web UI + REST API + AQL — plain HTTP, root password generated
./dataDatabases (maps to /var/lib/arangodb3)
./appsFoxx microservices (maps to /var/lib/arangodb3-apps)

نظرة عامة

ArangoDB قاعدة بيانات متعددة النماذج تخزن المستندات والرسوم البيانية وأزواج القيم المفتاحية في محرك واحد وتستعلم عن الثلاثة بلغة واحدة، AQL (لغة استعلام ArangoDB). بدلاً من تشغيل مخزن مستندات وقاعدة بيانات رسوم بيانية وذاكرة تخزين مؤقت للقيم المفتاحية كثلاثة أنظمة منفصلة، يتيح ArangoDB لاستعلام واحد تصفية المستندات، وعبور العلاقات في رسم بياني، والانضمام لعمليات بحث القيم المفتاحية ضمن معاملة واحدة. يشغّل هذا النشر صورة Docker الرسمية مع واجهة الويب وREST API وAQL جميعها متاحة على المنفذ 8529، محمية بكلمة مرور جذر مولّدة عشوائياً يطبعها سكريبت التثبيت مرة واحدة ولا يخزنها كنص عادي أبداً.

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

التطبيقات التي تحتاج تخزين مستندات منظم واستعلامات رسوم بيانية غنية بالعلاقات في آن واحد تنتهي عادة بتشغيل قاعدتي أو ثلاث قواعد بيانات منفصلة ومزامنة البيانات بينها — مخزن مستندات للمحتوى، وقاعدة بيانات رسوم بيانية للتوصيات أو الروابط الاجتماعية، وذاكرة تخزين مؤقت لعمليات البحث السريعة. يدمج ArangoDB كل ذلك في محرك واحد بلغة استعلام واحدة، بحيث يمكن لاستعلام AQL واحد تصفية مجموعة مستندات ثم عبور رسم بياني عبر النتائج في عملية ذرية واحدة، دون خط أنابيب ETL يربط أنظمة منفصلة. هذا يقلل بشكل كبير من العبء التشغيلي للفرق التي كانت ستشغّل وتصون عدة قواعد بيانات متخصصة بدلاً من ذلك.

متى تحتاجه

  • يحتاج تطبيقك تخزين مستندات منظماً واستعلامات رسوم بيانية غنية بالعلاقات في نفس المشروع
  • تشغّل حالياً قواعد بيانات مستندات ورسوم بيانية وقيم مفتاحية منفصلة وتزامن البيانات بينها يدوياً
  • تريد بناء ميزات توصية أو كشف احتيال أو تحليل شبكات تعتمد على عبور الرسوم البيانية
  • تريد لغة استعلام واحدة (AQL) بدلاً من تعلم وصيانة صياغات استعلام منفصلة لكل نوع قاعدة بيانات
  • تبني نموذجاً أولياً لرسم معرفي أو تطبيق بيانات مترابطة وتريد تجنب إعداد بنية تحتية رسوم بيانية متخصصة
  • تريد معاملات ACID تمتد عبر مجموعات المستندات وحواف الرسم البياني ضمن عملية ذرية واحدة

من يحتاجه

  • مطورو الخلفية الذين يبنون تطبيقات تحتاج استعلامات مستندات بأسلوب علائقي وعبور رسوم بيانية في نظام واحد
  • الفرق التي تبني محركات توصية أو كشف احتيال أو ميزات رسوم اجتماعية تستفيد من عبور الرسوم البيانية الأصلي
  • مهندسو البيانات الذين يريدون تجنب تشغيل قواعد بيانات مستندات ورسوم بيانية وقيم مفتاحية منفصلة ومزامنة البيانات بينها
  • الشركات الناشئة التي تبني نماذج أولية لرسوم معرفية أو تحليل شبكات أو تطبيقات بيانات مترابطة دون إعداد بنية تحتية رسوم بيانية متخصصة
  • المطورون المهاجرون من Neo4j الذين يريدون قدرة الرسوم البيانية مدمجة مع تخزين مستندات مرن في نفس المحرك
  • الفرق التي تكتب JavaScript بالفعل أو تحتاج قاعدة بيانات بطبقة خدمات JavaScript مدمجة (Foxx) قريبة من البيانات

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

  • نمذجة شبكة اجتماعية أو تسلسل هرمي تنظيمي كرسم بياني وعبور العلاقات باستعلامات رسوم AQL
  • بناء محرك توصية يجمع بين خصائص المستندات وعبور الرسم البياني لتاريخ الشراء أو التفاعل
  • تخزين كتالوجات منتجات أو محتوى كمستندات JSON مع نمذجة الكيانات المرتبطة (فئات، وسوم، مستخدمون) كرسم بياني
  • تشغيل كشف احتيال أو شذوذ بعبور رسوم بيانية للمعاملات للعثور على أنماط اتصال مشبوهة
  • نشر خدمات Foxx الصغيرة التي تشغّل JavaScript مباشرة داخل قاعدة البيانات لواجهات بيانات منخفضة الكمون
  • استبدال مزيج من MongoDB وNeo4j بمجموعة ArangoDB واحدة تغطي أحمال عمل المستندات والرسوم البيانية معاً

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

  • نواة متعددة النماذج تدعم المستندات والرسوم البيانية والقيم المفتاحية في محرك تخزين وطبقة استعلام واحدة
  • AQL (لغة استعلام ArangoDB)، لغة تصريحية واحدة للاستعلام عن المستندات وعبور الرسوم البيانية وربط البيانات
  • محرك رسوم بيانية أصلي مع عمليات عبور ومسار أقصر ومطابقة أنماط مدمجة دون قاعدة بيانات رسوم بيانية منفصلة
  • معاملات ACID عبر المجموعات والرسوم البيانية، بما فيها معاملات متعددة المستندات ومتعددة المجموعات
  • إطار عمل خدمات Foxx الصغيرة لتشغيل منطق تطبيق JavaScript مباشرة داخل قاعدة البيانات قريباً من البيانات
  • فهرسة نصية كاملة وجغرافية مكانية إلى جانب الفهارس القياسية الدائمة وفهارس التجزئة وقوائم التخطي
  • واجهة ويب مدمجة لإدارة قواعد البيانات والمجموعات والرسوم البيانية والمستخدمين وتشغيل استعلامات AQL تفاعلياً
  • وضع تجميع مع تقسيم وتكرار تلقائيين للتوسع الأفقي بما يتجاوز نشر السيرفر الواحد

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

  • سجّل الدخول إلى واجهة الويب على المنفذ 8529 كمستخدم root باستخدام كلمة المرور المولّدة التي طبعها المثبّت
  • أنشئ قاعدة بيانات مخصصة غير جذر ومستخدماً محدود الصلاحيات لتطبيقك بدلاً من استخدام حساب root مباشرة
  • أنشئ مجموعات لبيانات مستنداتك وحدد أي رسوم بيانية تحتاجها تحت قسم Graphs في واجهة الويب
  • استخدم محرر AQL المدمج في واجهة الويب لكتابة واختبار الاستعلامات قبل تضمينها في كود التطبيق
  • ثبّت برنامج تشغيل ArangoDB للغة تطبيقك (JavaScript وPython وJava وGo وأخرى مدعومة رسمياً)
  • حدد فهارس على خصائص المستندات المستعلَم عنها بكثرة لإبقاء استعلامات AQL سريعة مع نمو المجموعات
  • إذا كنت تستخدم Foxx، طوّر وانشر الخدمات الصغيرة تحت قسم Services، المخزنة في حجم ./apps
  • اضبط حدود الموارد وراجع الإعدادات الافتراضية تحت /etc/arangodb3/arangod.conf داخل الحاوية لضبط الإنتاج

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

  • احفظ كلمة مرور الجذر المولّدة فوراً بعد التثبيت — لا يمكن استعادتها من الحاوية بمجرد فقدانها
  • أنشئ مستخدم قاعدة بيانات محدود الصلاحيات لكل تطبيق بدلاً من الاتصال بحساب root
  • ضع ArangoDB خلف وكيل عكسي مع TLS لأن المنفذ 8529 يقدم HTTP عادي افتراضياً في هذا النشر
  • لا تكشف المنفذ 8529 مباشرة للإنترنت العام أبداً — قيّده على localhost أو شبكة خاصة أو VPN
  • فعّل المصادقة على جميع قواعد البيانات (مفعّلة افتراضياً) وتجنب تعطيلها حتى لبيئات الاختبار الداخلية
  • انسخ حجم ./apps احتياطياً إلى جانب ./data إذا كنت تستخدم خدمات Foxx الصغيرة، لأنه يحمل كود خدماتك المنشورة
  • حافظ على تحديث صورة ArangoDB Docker لتلقي تصحيحات الأمان، مع مراجعة ملاحظات الإصدار لأي تغييرات جذرية أولاً
  • قيّد المضيفين الذين يمكنهم الوصول للمنفذ 8529 على مستوى الجدار الناري، لأن أي شخص ببيانات اعتماد صالحة على هذا المنفذ يتحكم بكل قاعدة بيانات

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

كل شيء في هذا النشر يعمل عبر منفذ واحد، 8529 — واجهة الويب وREST API وكل حركة استعلامات AQL. لا يوجد منفذ إداري منفصل، مما يعني أن أي شخص يصل للمنفذ 8529 ببيانات اعتماد جذر صالحة يملك تحكماً كاملاً في كل قاعدة بيانات في المثيل. هذا HTTP عادي وليس HTTPS، لذا يجب ألا يُكشف المنفذ 8529 مباشرة للإنترنت أبداً؛ أبقه خلف جدار ناري ومتاحاً فقط من مضيفين موثوقين، أو ضع وكيلاً عكسياً منهياً لـ TLS مثل Nginx Proxy Manager أمامه لأي وصول عن بُعد. للتطوير المحلي أو اختبار مستخدم واحد، يكفي تقييد الوصول لـ localhost أو شبكة خاصة؛ لأي شيء يشبه الإنتاج، أضف طبقة VPN أو وكيل عكسي قبل السماح باتصالات خارجية.

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

  • استخدم arangodump لإنشاء نسخة احتياطية منطقية متسقة لقواعد بياناتك بدلاً من نسخ دليل ./data بينما ArangoDB يعمل
  • استعد النسخ الاحتياطية بـ arangorestore، الذي يعمل بشكل نظيف عبر إصدارات ArangoDB، على عكس النسخ الخام على مستوى الملف لقاعدة بيانات تعمل
  • انسخ دليل ./apps احتياطياً بشكل منفصل إذا كنت تستخدم خدمات Foxx الصغيرة — يُربط بـ /var/lib/arangodb3-apps وستفقد نسخة بيانات فقط خدماتك
  • جدول arangodump كمهمة cron تستهدف قرصاً منفصلاً أو تخزيناً بعيداً، وليس نفس حجم دليل ./data الحي
  • خزّن كلمة مرور الجذر المولّدة وأي بيانات اعتماد قاعدة بيانات تطبيق في مدير كلمات مرور، لأنها غير مخزنة كنص عادي قابل للاستعادة في أي مكان
  • اختبر استعادة نسخة احتياطية على مثيل ArangoDB منفصل دورياً للتأكد من صلاحية النسخ الاحتياطية واكتمالها قبل الحاجة إليها في حالة طارئة

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

  • نسخ دليل ./data كنسخة احتياطية على مستوى الملف بينما قاعدة البيانات تعمل، مما يخاطر بالتقاطها في منتصف الكتابة
  • فقدان كلمة مرور الجذر المولّدة دون أي سجل لها في أي مكان، لأنها لا يمكن استعادتها من الحاوية العاملة
  • ربط كود التطبيق مباشرة بمستخدم root بدلاً من إنشاء قاعدة بيانات ومستخدم محدودَي الصلاحيات
  • كشف المنفذ 8529 مباشرة للإنترنت دون وكيل عكسي، مما يرسل بيانات الاعتماد والاستعلامات عبر HTTP عادي
  • نسيان نسخ حجم ./apps احتياطياً عند استخدام خدمات Foxx الصغيرة، مما يؤدي لفقدان كود الخدمات رغم سلامة البيانات
  • عدم تحديد فهارس على الخصائص المستعلَم عنها بكثرة، مما يؤدي لبطء استعلامات AQL مع نمو المجموعات لأكثر من بضعة آلاف مستند
  • تشغيل ArangoDB كمثيل واحد لحمل عمل تجاوزه، بدلاً من الانتقال لوضع التجميع للتقسيم والتكرار

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

  • لا يمكن تسجيل الدخول إلى واجهة الويب — تأكد أنك تستخدم كلمة المرور المولّدة بالضبط من مخرجات المثبّت؛ استرجعها مجدداً بـ docker logs إذا كان لديك مخرجات بدء التشغيل الأصلية محفوظة
  • واجهة الويب أو API غير متاحة على المنفذ 8529 — تحقق أن الحاوية تعمل بـ docker ps وتأكد أن ما من قاعدة جدار ناري تحظر المنفذ
  • استعلامات AQL تعمل ببطء — استخدم محلل الاستعلامات في واجهة الويب للتحقق ما إذا كان الاستعلام يستخدم فهرساً، وأضف واحداً على الخاصية المُصفّاة إذا لم يكن كذلك
  • خدمة Foxx لا تظهر بعد النشر — تأكد أن حجم ./apps مربوط بشكل صحيح بـ /var/lib/arangodb3-apps وتحقق من صفحة Services لأخطاء النشر
  • استعلامات عبور الرسوم البيانية تُرجع نتائج غير متوقعة — تحقق أن اتجاهات مجموعة الحواف (from/to) تطابق ما يتوقعه اتجاه العبور (OUTBOUND وINBOUND وANY)
  • أخطاء نفاد الذاكرة تحت الحمل — استخدام ذاكرة ArangoDB يتناسب مع حجم البيانات وتعقيد الاستعلامات؛ زد حدود ذاكرة الحاوية أو انتقل لوضع التجميع
  • arangorestore يفشل بأخطاء عدم تطابق إصدار — تحقق أن arangodump أُخذ بإصدار ArangoDB متوافق وراجع ملاحظات الترحيل لترقيات الإصدار الرئيسية

البدائل

MongoDB هو أقرب مقارنة لتخزين المستندات البحت — أبسط للتفكير فيه إذا لم تحتج أبداً عبور رسوم بيانية أصلي، لكنه يتطلب قاعدة بيانات رسوم بيانية منفصلة مثل Neo4j إذا أصبحت استعلامات العلاقات مهمة. Neo4j هي أنضج قاعدة بيانات رسوم بيانية مخصصة بأداء عبور ممتاز ولغة استعلام Cypher، لكنها لا تتعامل أصلياً مع تخزين المستندات العام كما يفعل ArangoDB. PostgreSQL مع الإضافات (JSONB للمستندات، Apache AGE للرسوم البيانية) يمكن أن يقارب سلوك تعدد النماذج لكنه يتطلب ربط إضافات معاً بدلاً من الحصول على دعم أصلي. SurrealDB قاعدة بيانات أحدث متعددة النماذج بعرض مشابه لـ ArangoDB، تستحق التقييم إذا أردت أحدث جيل من هذه الفئة. كمحرك واحد ناضج ومُثبت في الإنتاج يتعامل أصلياً مع المستندات والرسوم البيانية بلغة استعلام واحدة، يبقى ArangoDB من أقوى الخيارات.

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

إذا كان تطبيقك يحتاج فقط تخزين مستندات بسيطاً دون عبور علاقات أبداً، فقاعدة بيانات مستندات مخصصة مثل MongoDB أبسط للتشغيل ولديها نظام بيئي أكبر من الأدوات ومزودي الاستضافة. إذا كان عبور الرسوم البيانية حمل عملك الأساسي والمستندات ثانوية، فقاعدة بيانات رسوم بيانية مخصصة مثل Neo4j تقدم عادة أداء عبور أفضل ونظاماً بيئياً أدوات أنضج مخصصاً للرسوم البيانية. مرونة تعدد النماذج في ArangoDB تعني أيضاً أنه يفتقر لعقود من التصليب الإنتاجي التي يملكها PostgreSQL أو MongoDB كل على حدة، لذا قد تفضل عمليات النشر المحافظة جداً والحرجة للمهمة أداة أضيق ومُختبرة أكثر في المعارك. وإذا لم يكن فريقك بحاجة لمنحنى تعلم AQL، فقاعدة بيانات بلغة استعلام يعرفها فريقك بالفعل ستوصلك للإنتاج أسرع.

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

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

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

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

ماذا يعني تعدد النماذج فعلياً هنا؟

يعني أن المستندات والرسوم البيانية وبيانات القيم المفتاحية تعيش في نفس المحرك ويُستعلَم عنها بلغة واحدة، AQL. يمكن لاستعلام واحد تصفية المستندات ثم عبور رسم بياني عبرها، ضمن معاملة واحدة.

ما بيانات تسجيل دخولي؟

المستخدم هو root وكلمة المرور سلسلة من 24 حرفاً يولّدها المثبّت من /dev/urandom ويطبعها عند الانتهاء. احفظها فوراً — لا يمكن استعادتها من الحاوية. للتطبيقات الحقيقية، أنشئ قاعدة بيانات مخصصة ومستخدماً محدود الصلاحيات بدلاً من استخدام root.

ما المنفذ الذي يستخدمه ArangoDB؟

كل شيء يعمل على المنفذ 8529 — واجهة الويب وREST API واستعلامات AQL. لا يوجد منفذ إدارة منفصل، لذا أي شخص يصل للمنفذ 8529 ببيانات اعتماد صالحة يتحكم بكل قاعدة بيانات. هذا HTTP عادي في هذا النشر، لذا أبقه بعيداً عن الإنترنت وخلف وكيل TLS إذا احتجت وصولاً عن بُعد.

ما فائدة حجم ./apps؟

يُربط بـ /var/lib/arangodb3-apps ويخزن خدمات Foxx الصغيرة — JavaScript يعمل داخل قاعدة البيانات نفسها، مما يتيح لك وضع نقاط نهاية API بجانب بياناتك. إذا كنت تستخدم Foxx، انسخ ./apps احتياطياً إلى جانب ./data، لأن نسخة حجم البيانات فقط ستفقد خدماتك.

كيف أنسخها احتياطياً بشكل صحيح؟

استخدم arangodump لنسخة احتياطية منطقية متسقة وarangorestore لاستعادتها، بدلاً من نسخ دليل ./data بينما قاعدة البيانات تعمل. النسخ على مستوى الملف لقاعدة بيانات حية يخاطر بالتقاطها في منتصف الكتابة، والنسخة المنطقية تُستعاد أيضاً بشكل نظيف عبر الإصدارات.