🗄️ تثبيت FerretDB — متوافق مع MongoDB فوق PostgreSQL

انشر FerretDB على Ubuntu بـ Docker — قاعدة بيانات مفتوحة المصدر متوافقة مع MongoDB تتحدث بروتوكول MongoDB بينما تخزّن البيانات في PostgreSQL مع إضافة DocumentDB، على المنفذ 27018.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر FerretDB مع خلفية PostgreSQL مفعّل عليها DocumentDB على المنفذ 27018. اتصل بأي عميل MongoDB.
عرض على GitHub

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

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

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

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

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

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

chmod +x ferretdb-ubuntu.sh

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

./ferretdb-ubuntu.sh

4 الاتصال بعميل MongoDB

mongodb://ferret:YOUR_PASSWORD@your-server-ip:27018/

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

المنفذالغرض
27018FerretDB MongoDB-compatible endpoint (mapped from container port 27017)
5432PostgreSQL with DocumentDB — internal to the Docker network, not exposed

نظرة عامة

FerretDB قاعدة بيانات مفتوحة المصدر تُطبّق بروتوكول MongoDB السلكي، بحيث تتصل بها برامج تشغيل MongoDB وmongosh وأكواد التطبيقات المبنية لـ MongoDB تماماً كما تتصل بسيرفر MongoDB حقيقي. في الخلفية، FerretDB ليست نسخة متفرعة من MongoDB — إنها وكيل (proxy) يترجم أوامر MongoDB الواردة إلى SQL ويخزّن البيانات الفعلية في PostgreSQL باستخدام إضافة DocumentDB، محرك تخزين وفهرسة BSON الذي فتحت مايكروسوفت مصدره عام 2025.

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

انتقلت MongoDB بخادمها الأساسي إلى ترخيص Server Side Public License (SSPL)، وهو ليس ترخيصاً مفتوح المصدر معتمداً من OSI ويفرض شروطاً لا تستطيع الكثير من الشركات ومزوّدي السحابة وتوزيعات لينكس قبولها. يمنحك FerretDB نفس واجهة برمجة MongoDB وبرامج التشغيل ولغة الاستعلام تحت ترخيص Apache 2.0 المتساهل حقاً، مدعوماً بـ PostgreSQL — قاعدة بيانات ناضجة ومُختبرة قد تكون تُشغّلها بالفعل في مكان آخر من بنيتك.

متى تحتاجه

  • تريد تشغيل أعباء عمل متوافقة مع MongoDB دون تبنّي ترخيص SSPL الخاص بها
  • مؤسستك تعتمد بالفعل على PostgreSQL للعمليات والنسخ الاحتياطي والمراقبة وتريد تجنّب تشغيل محرك قاعدة بيانات ثانٍ
  • تُقيّم مسار ترحيل من MongoDB لكن تريد خياراً مفتوح المصدر وذاتي الاستضافة أولاً
  • تحتاج توافقاً مع برنامج تشغيل MongoDB لتطبيق أو إطار عمل دون الدفع مقابل MongoDB Atlas
  • تريد إبقاء نسخة MongoDB حقيقية ونسخة FerretDB جنباً إلى جنب أثناء الترحيل، مميّزتين بالمنفذ
  • تريد مرونة قاعدة بيانات المستندات مع ضمانات المعاملات ونضج الأدوات التي تقدّمها PostgreSQL في الخلفية

من يحتاجه

  • فرق التطوير التي تبني تطبيقات باستخدام برنامج تشغيل MongoDB وتريد خلفية مفتوحة المصدر وذاتية الاستضافة
  • المؤسسات التي اعتمدت على PostgreSQL وتريد تجنّب تشغيل تقنية قاعدة بيانات ثانية لأعباء عمل المستندات
  • الشركات القلقة بشأن شروط ترخيص SSPL الخاص بـ MongoDB لمنتجات تجارية أو مُستضافة سحابياً
  • عشاق الاستضافة الذاتية والمختبرات المنزلية الذين يريدون توافقاً مع واجهة MongoDB دون تشغيل MongoDB نفسها
  • الفرق المنتقلة بعيداً عن MongoDB وتريد اختبار التوافق قبل الالتزام بإعادة كتابة كاملة
  • مهندسو المنصات الذين يريدون تكرار PostgreSQL وأدوات نسخه الاحتياطي ومنظومته خلف واجهة على طراز المستندات

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

  • تشغيل تطبيقات مكتوبة لبرنامج تشغيل MongoDB مقابل قاعدة بيانات مدعومة بـ PostgreSQL بدلاً منه
  • اختبار توافق واجهة MongoDB لتطبيق قبل تقرير الترحيل الكامل
  • دمج أعباء عمل المستندات والعلائقية على محرك قاعدة بيانات PostgreSQL واحد
  • تجنّب ترخيص SSPL الخاص بـ MongoDB لمنتج تجاري أو مُعاد توزيعه يضمّن قاعدة بيانات مستندات
  • بناء نماذج أولية بمستندات مرنة على طراز MongoDB مع إبقاء البيانات في محرك علائقي مفهوم جيداً
  • تشغيل MongoDB وFerretDB جنباً إلى جنب على منافذ مختلفة أثناء ترحيل تدريجي

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

  • يُطبّق بروتوكول MongoDB السلكي 5.0+، بحيث تتصل برامج تشغيل وأدوات MongoDB الموجودة دون أي تعديل في الكود
  • يخزّن البيانات في PostgreSQL باستخدام إضافة DocumentDB لأداء تخزين وفهرسة BSON قريب من الأصلي
  • مرخّص بموجب Apache 2.0 — مفتوح المصدر حقاً دون قيود على طراز SSPL
  • يعمل كوكيل (proxy) وليس نسخة متفرعة، يترجم أوامر بروتوكول MongoDB السلكي إلى SQL يُنفَّذ ضد PostgreSQL
  • متوافق مع أدوات وبرامج تشغيل MongoDB الشائعة عبر معظم اللغات وأطر العمل الشائعة
  • يعمل جنباً إلى جنب مع حاوية PostgreSQL مخصصة، فترث نضج PostgreSQL التشغيلي للنسخ الاحتياطي والمراقبة
  • يُطوَّر بنشاط، وجلب الإصدار 2.0 قفزة أداء كبيرة عبر إضافة DocumentDB
  • يُنشر عمداً هنا على منفذ غير افتراضي (27018) حتى تتمكن نسخة MongoDB حقيقية من التعايش على نفس المضيف

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

  • اتصل باستخدام أي برنامج تشغيل MongoDB أو mongosh، موجّهاً سلسلة الاتصال إلى المنفذ 27018 بدلاً من الافتراضي 27017
  • تحقق من كلمة مرور PostgreSQL المُولَّدة في مخرجات التثبيت وخزّنها بأمان مع بقية بياناتك السرية
  • أنشئ قواعد بيانات ومجموعات تطبيقك تماماً كما تفعل مع MongoDB حقيقية — سطح الواجهة البرمجية هو نفسه
  • اختبر عوامل MongoDB المحدّدة ومراحل التجميع وأنماط الاستعلام التي يعتمد عليها تطبيقك قبل الالتزام الكامل
  • أعدّ نسخاً احتياطية منتظمة لـ PostgreSQL لحجم ./db، فهو المكان الذي تعيش فيه بياناتك الفعلية
  • راقب نسخة PostgreSQL الأساسية بأدوات PostgreSQL القياسية بدلاً من أدوات مراقبة خاصة بـ MongoDB
  • أبقِ إصدار حاوية FerretDB متوافقاً مع إصدار إضافة PostgreSQL/DocumentDB للحفاظ على التوافق

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

  • أبقِ المنفذ 27018 محمياً بجدار حماية عن الإنترنت العام — عامله تماماً كما تعامل نشر MongoDB حقيقي
  • استخدم كلمة مرور قوية وفريدة للمستخدم ferret وغيّرها إذا تعرّضت يوماً في السجلات أو شُوركت بشكل غير آمن
  • أبقِ PostgreSQL (المنفذ 5432) داخلياً ضمن شبكة Docker فقط — يجب ألا يُنشر أبداً للمضيف أو الإنترنت
  • قيّد اتصالات العملاء على سيرفرات تطبيقات موثوقة أو VPN بدلاً من السماح بوصول شبكي واسع
  • فعّل TLS لاتصالات برنامج تشغيل MongoDB إذا كان العملاء يتصلون عبر شبكة غير موثوقة
  • طبّق نفس ممارسات تحصين PostgreSQL التي تطبّقها لأي قاعدة بيانات إنتاج — أدوار بأقل صلاحية، حدود اتصال، وتسجيل
  • أبقِ صورتي FerretDB وPostgreSQL محدّثتين لتحصل على تصحيحات الأمان بسرعة

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

يستمع FerretDB على منفذ المضيف 27018 في هذا النشر، مختلفاً عمداً عن منفذ MongoDB الافتراضي 27017 حتى تتمكن نسخة MongoDB حقيقية من العمل على نفس المضيف دون تعارض أو غموض. وجّه برامج تشغيل MongoDB وسلاسل الاتصال إلى 27018. يعمل PostgreSQL، الذي يقوم بالتخزين الفعلي للبيانات عبر إضافة DocumentDB، على المنفذ 5432 داخلياً ضمن شبكة Docker وليس منشوراً للمضيف — يجب ألا يُكشف أبداً للإنترنت. احمِ المنفذ 27018 بجدار حماية عن الوصول العام تماماً كما تفعل مع نشر MongoDB إنتاجي، بحيث تُسمح الاتصالات فقط من سيرفرات تطبيقات موثوقة أو عبر VPN.

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

  • انسخ حجم ./db احتياطياً، فهو المكان الذي يعيش فيه PostgreSQL — وبالتالي كل بياناتك الفعلية
  • استخدم أدوات PostgreSQL القياسية مثل pg_dump لنسخة احتياطية متسقة على مستوى التطبيق بدلاً من نسخ ملفات خام لقاعدة بيانات تعمل
  • خزّن كلمة مرور PostgreSQL المُولَّدة مع نسخك الاحتياطية — ستحتاجها للاستعادة وإعادة الاتصال
  • جدول نسخاً احتياطية آلية منتظمة بدلاً من الاعتماد على تصدير يدوي قبل التغييرات الكبيرة
  • اختبر استعادة نسخة احتياطية على نسخة FerretDB وPostgreSQL جديدة للتأكد أن عملاء MongoDB يعيدون الاتصال بنجاح
  • أبقِ النسخ الاحتياطية خارج جهاز المضيف — انسخها إلى قرص آخر أو تخزين شبكي أو سحابي بجدول منتظم

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

  • افتراض أن FerretDB نسخة متفرعة من MongoDB تخزّن ملفات BSON مباشرة — إنها وكيل، وPostgreSQL يحمل البيانات الحقيقية
  • النسخ الاحتياطي بأدوات على طراز MongoDB مثل mongodump بدلاً من أدوات PostgreSQL مثل pg_dump ضد حجم ./db
  • ترحيل تطبيق دون التحقق أولاً من عوامل MongoDB ومراحل التجميع التي يستخدمها فعلياً
  • كشف منفذ PostgreSQL 5432 للمضيف أو الإنترنت بينما يجب أن يبقى داخلياً ضمن شبكة Docker
  • الخلط بين المنفذ 27018 ومنفذ MongoDB الافتراضي 27017 عند ضبط سلاسل اتصال العملاء
  • عدم اختبار توافق خطوط أنابيب التجميع المتقدمة قبل افتراض أن ترحيل MongoDB الكامل سيعمل دون تغيير

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

  • العميل لا يستطيع الاتصال — تأكد أن سلسلة الاتصال تستخدم المنفذ 27018، وليس منفذ MongoDB الافتراضي 27017
  • نتائج استعلام غير متوقعة أو أخطاء — تحقق ما إذا كان عامل MongoDB أو مرحلة التجميع المحددة التي تستخدمها مدعومة في إصدار FerretDB الحالي
  • استعلامات بطيئة — تحقق من وجود فهارس في PostgreSQL للحقول التي يستعلمها تطبيقك بكثرة، تماماً كما تفعل مع MongoDB
  • فشل مصادقة — تأكد أنك تستخدم كلمة مرور المستخدم ferret المُولَّدة وأنها لم تُغيَّر دون تحديث تطبيقك
  • الحاوية لا تبدأ — تحقق أن حاوية PostgreSQL بدأت بنجاح أولاً، لأن FerretDB يعتمد على جاهزيتها
  • تبدو البيانات مفقودة بعد إعادة التشغيل — تحقق أن حجم ./db مُركّب ومحفوظ فعلياً، وليس حجماً مجهولاً أُعيد إنشاؤه

البدائل

تبقى MongoDB Community Edition الخيار الأكمل إذا لم يكن ترخيص SSPL مصدر قلق لحالة استخدامك، وتتجنّب أي فجوات توافق تماماً لأنها النسخة الحقيقية. MongoDB Atlas هي خدمة MongoDB السحابية المُدارة، تزيل العبء التشغيلي مقابل فاتورة سحابية متكررة وارتباط بمزوّد واحد. تقدّم Amazon DocumentDB توافقاً مشابهاً مع واجهة MongoDB كخدمة AWS مُدارة لكنها مملوكة ومرتبطة بتلك السحابة. إذا لم تكن تحتاج تحديداً توافقاً مع واجهة MongoDB، فاستخدام PostgreSQL مباشرة بنوع عمود JSONB الأصلي يمنحك تخزين مستندات مرناً دون طبقة ترجمة البروتوكول السلكي إطلاقاً. مكانة FerretDB الخاصة هي تحديداً الفرق التي تحتاج توافقاً مع برنامج تشغيل MongoDB على محرك مفتوح المصدر حقاً وذاتي الاستضافة ومدعوم بـ PostgreSQL.

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

إذا كان تطبيقك يحتاج ميزات MongoDB التي لا يدعمها FerretDB بالكامل بعد — مراحل تجميع متقدمة معينة، أنواع فهارس محددة، أو دلالات معاملات — فتحقق من التوافق قبل الترحيل، أو ببساطة شغّل MongoDB Community Edition الحقيقية بدلاً من ذلك. إذا لم يكن ترخيص SSPL مصدر قلق لنشرك (مثلاً أداة داخلية لا تُوزَّع أو تُقدَّم كخدمة أبداً)، فليس هناك سبب كبير لإضافة طبقة ترجمة بدلاً من تشغيل MongoDB مباشرة. وإذا لم تكن تحتاج توافقاً مع واجهة MongoDB إطلاقاً، فقد يخدم دعم JSONB الأصلي في PostgreSQL احتياجات تخزين المستندات المرنة بشكل أبسط، دون إدخال FerretDB كمكوّن إضافي.

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

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

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

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

ما هو FerretDB؟

FerretDB قاعدة بيانات مفتوحة المصدر تتحدث بروتوكول MongoDB السلكي — بحيث تتصل بها برامج تشغيل MongoDB وmongosh وأكواد التطبيقات تماماً كما تتصل بـ MongoDB — بينما تخزّن البيانات في PostgreSQL في الخلفية باستخدام إضافة DocumentDB.

لماذا أستخدمه بدلاً من MongoDB؟

السبب الرئيسي هو الترخيص. انتقلت MongoDB إلى SSPL، وهو ليس مفتوح مصدر معتمداً من OSI ويفرض شروطاً لا تستطيع الكثير من الشركات ومزوّدي السحابة قبولها. يمنحك FerretDB واجهة MongoDB وبرامج تشغيلها تحت ترخيص Apache 2.0 المفتوح حقاً، مدعوماً بـ PostgreSQL.

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

يستمع هذا النشر على منفذ المضيف 27018، وليس عمداً منفذ MongoDB الافتراضي 27017. هذا يتيح لنسخة MongoDB حقيقية وFerretDB التعايش على نفس المضيف ويزيل أي غموض حول أيهما تتصل به. وجّه عملاء MongoDB وسلاسل الاتصال إلى 27018.

هل هو متوافق تماماً مع كل ميزات MongoDB؟

يُطبّق مجموعة فرعية كبيرة من واجهة MongoDB — كافية للكثير من التطبيقات — لكن ليس كل مجموعة الميزات. قبل الترحيل، تحقق أن العوامل ومراحل التجميع والعمليات المحددة التي يعتمد عليها عبء عملك مدعومة في إصدار FerretDB الحالي.

هل أنسخه احتياطياً مثل MongoDB أم PostgreSQL؟

مثل PostgreSQL، لأن هذا هو المكان الذي تعيش فيه البيانات فعلياً. انسخ حجم ./db احتياطياً، ويُفضَّل باستخدام أدوات PostgreSQL القياسية مثل pg_dump للحصول على لقطة متسقة، وخزّن كلمة مرور PostgreSQL المُولَّدة مع نسخك الاحتياطية.