🗄️ تثبيت CloudBeaver — مدير قواعد بيانات عبر المتصفح
انشر CloudBeaver على Ubuntu بـ Docker — نسخة DBeaver في متصفحك، تدير PostgreSQL وMySQL وSQLite وعشرات غيرها من واجهة ويب واحدة على المنفذ 8978.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/databases/cloudbeaver/cloudbeaver-ubuntu.sh
chmod +x cloudbeaver-ubuntu.sh
sudo bash cloudbeaver-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/databases/cloudbeaver/cloudbeaver-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x cloudbeaver-ubuntu.sh
3 تشغيل المُثبّت
يثبّت السكريبت Docker إن لزم ويُشغّل dbeaver/cloudbeaver:latest على المنفذ 8978، مع حفظ إعداداته واتصالاته في ./workspace.
sudo bash cloudbeaver-ubuntu.sh
4 تشغيل معالج الإعداد
لا توجد بيانات دخول افتراضية — أول ما تفعله هو إنشاء حساب المسؤول في معالج الإعداد:
http://<your-server-ip>:8978
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8978 | Web UI — plain HTTP; admin created in the setup wizard |
| ./workspace | Config, users, and saved connections (holds credentials) |
نظرة عامة
CloudBeaver هي النسخة المستندة للويب من DBeaver، أداة قواعد البيانات المكتبية المعروفة على نطاق واسع، مبنية من نفس الفريق وعلى نفس المحرك الأساسي. تعمل كحاوية Docker واحدة وتمنحك محرر SQL وشبكة بيانات ومستعرض مخططات يمكن الوصول إليها من أي متصفح، تتصل بـ PostgreSQL وMySQL وMariaDB وSQLite وSQL Server وOracle وعشرات قواعد بيانات أخرى عبر مشغلات JDBC — كل ذلك دون تثبيت تطبيق مكتبي على كل جهاز يحتاج الوصول.
لماذا تستخدمه
تحل CloudBeaver مشكلة توفير عميل SQL مناسب لكل من يحتاجه دون تثبيت DBeaver Desktop على كل حاسوب محمول. نشر واحد على سيرفر يمنح فريقك بأكمله محرر SQL وشبكة بيانات ومستعرض مخططات عبر المتصفح يدعم نفس المجموعة الواسعة من قواعد البيانات التي تدعمها الأداة المكتبية. إنها بديل أخف من تشغيل phpMyAdmin لكل محرك قاعدة بيانات، وعلى عكس معظم أدوات إدارة الويب الخفيفة، لا ترتبط بنوع قاعدة بيانات واحد — نسخة CloudBeaver واحدة يمكنها إدارة اتصالات PostgreSQL وMySQL وSQLite جنباً إلى جنب.
متى تحتاجه
- يحتاج فريقك عميل SQL مشترك يُصل إليه عبر المتصفح بدلاً من تثبيت DBeaver Desktop على كل جهاز
- تدير عدة محركات قواعد بيانات (PostgreSQL، MySQL، SQLite، وغيرها) وتريد أداة واحدة بدلاً من عدة لوحات إدارة مخصصة لكل محرك
- تحتاج منح المطورين أو المحللين وصولاً للاستعلام في قاعدة بيانات دون توزيع بيانات اعتماد مباشرة أو وصول VPN للجميع
- تريد بديلاً خفيفاً وذاتي الاستضافة لأدوات مخصصة لكل محرك مثل phpMyAdmin أو Adminer التي تدعم نوع قاعدة بيانات واحد فقط
- تحتاج وصولاً عرضياً ومخصصاً بـ SQL لقواعد بيانات الإنتاج أو التجريب من أي جهاز دون تثبيت برامج
من يحتاجه
- مطورو الخلفية الذين يحتاجون وصولاً سريعاً بـ SQL لـ PostgreSQL أو MySQL أو قواعد بيانات أخرى من أي جهاز دون تثبيت عميل مكتبي
- مديرو قواعد البيانات الذين يديرون عدة محركات ويريدون واجهة موحدة واحدة بدلاً من التبديل بين أدوات خاصة بكل محرك
- الفرق الصغيرة والشركات الناشئة التي تريد مشاركة الوصول لقاعدة البيانات دون توزيع بيانات اعتماد خام لكل مهندس
- محللو البيانات الذين يحتاجون تشغيل استعلامات عرضية واستعراض المخطط دون الحاجة لتثبيت DBeaver Desktop كاملاً
- مهندسو DevOps الذين يريدون مستعرض قاعدة بيانات خفيف وقابل للتخلص منه لتصحيح مشكلات التجريب أو الإنتاج
- الوكالات والاستشاريون الذين يديرون قواعد بيانات عبر سيرفرات عملاء متعددة ويريدون تبويب متصفح واحد بدلاً من ملفات VPN عديدة
- عشاق الاستضافة الذاتية والمختبرات المنزلية الذين يُشغّلون عدة قواعد بيانات (Postgres لتطبيق وMySQL لآخر) ويريدون أداة إدارة واحدة للجميع
حالات الاستخدام الشائعة
- منح فريق تطوير وصولاً بـ SQL عبر المتصفح لسيرفر PostgreSQL أو MySQL مشترك دون تثبيت أي شيء محلياً
- استعراض مخططات الجداول وتشغيل استعلامات عرضية وتصدير نتائج أثناء جلسات التصحيح
- توفير وصول للقراءة فقط أو محدود النطاق لقواعد بيانات معينة للمحللين دون كشف بيانات اعتماد قاعدة البيانات الخام
- إدارة عدة محركات قواعد بيانات (Postgres، MySQL، SQLite) من واجهة ويب واحدة بدلاً من التنقل بين عدة أدوات
- تشغيل إصلاحات بيانات سريعة أو ترحيلات مباشرة من المتصفح أثناء حادثة، دون الحاجة لبيئة مكتبية كاملة
- تأهيل أعضاء فريق جدد بوصول فوري لقاعدة البيانات عبر رابط مشترك بدلاً من توزيع برامج مكتبية وبيانات اعتماد
الميزات الرئيسية
- محرر SQL عبر الويب مع تلوين الصيغة والإكمال التلقائي وسجل الاستعلامات، يمكن الوصول إليه من أي متصفح حديث
- شبكة بيانات لاستعراض وتصفية وترتيب وتعديل صفوف الجدول مباشرة، شبيهة بواجهة DBeaver Desktop
- مستعرض مخططات يعرض الجداول والعروض والأعمدة والفهارس والمفاتيح الخارجية لقواعد البيانات المتصلة
- دعم واسع لمشغلات JDBC يغطي PostgreSQL وMySQL وMariaDB وSQLite وSQL Server وOracle وClickHouse وعشرات غيرها
- صلاحيات اتصال لكل مستخدم، تتيح للمسؤول التحكم بأي قواعد بيانات يمكن لكل عضو فريق الوصول إليها
- تصدير نتائج الاستعلام إلى CSV وJSON وصيغ شائعة أخرى مباشرة من المتصفح
- تعمل كحاوية Docker خفيفة واحدة دون الحاجة لتثبيت مكتبي منفصل للمستخدمين النهائيين
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:8978 فوراً بعد التثبيت وأكمل معالج الإعداد لإنشاء حساب المسؤول قبل أن يستولي عليه أي شخص آخر
- أضف اتصال قاعدة بيانات بتوفير المضيف والمنفذ وبيانات الاعتماد والمشغل لكل قاعدة بيانات تريد إدارتها
- استخدم عنوان IP الخاص بالمضيف (أو اسم حاوية أخرى على نفس شبكة Docker) بدلاً من localhost عند الاتصال بقواعد البيانات، لأن localhost داخل الحاوية يشير للحاوية نفسها
- أنشئ حسابات مستخدمين إضافية لأعضاء الفريق وامنحهم وصولاً فقط لاتصالات قواعد البيانات المحددة التي يحتاجونها
- اختبر كل اتصال بعد إضافته للتأكد أن مشغل JDBC تم تنزيله بشكل صحيح وأن بيانات الاعتماد صالحة
- ضع CloudBeaver خلف وكيل عكسي مع HTTPS قبل السماح لأي شخص بالوصول إليها خارج شبكتك المحلية
- انسخ احتياطياً دليل ./workspace بانتظام لأنه يحمل كل اتصالاتك المحفوظة وبيانات اعتمادها
أفضل ممارسات الأمان
- أكمل معالج إعداد المسؤول فوراً بعد التثبيت — إلى أن تفعل، يمكن لأي شخص يصل للمنفذ 8978 أولاً الاستيلاء على حساب المسؤول
- لا تكشف المنفذ 8978 مباشرة للإنترنت عبر HTTP عادي — إنه غير مشفّر، فتنتقل بيانات الدخول ونتائج الاستعلامات عبر الشبكة بوضوح
- ضع CloudBeaver خلف وكيل عكسي (Nginx Proxy Manager أو Caddy) بشهادة TLS صالحة لأي وصول خارج شبكتك المحلية
- تعامل مع دليل ./workspace كمادة حساسة للغاية — فهو يخزّن بيانات اعتماد كل اتصال قاعدة بيانات أعددته
- أنشئ حسابات محدودة النطاق لكل مستخدم بوصول مقتصر على قواعد البيانات التي يحتاجها كل شخص بدلاً من مشاركة حساب المسؤول
- استخدم بيانات اعتماد قاعدة بيانات للقراءة فقط ضمن اتصالات CloudBeaver للمستخدمين الذين يحتاجون فقط الاستعلام لا تعديل البيانات
- قيّد الوصول على الشبكات الموثوقة بجدار ناري أو VPN، لأن اختراق هذه اللوحة الواحدة يعني اختراق كل قاعدة بيانات متصلة بها
المنافذ وإعدادات جدار الحماية
تستمع CloudBeaver على المنفذ 8978 لواجهة الويب عبر HTTP عادي دون تشفير مدمج. ولأن هذه اللوحة الواحدة تحمل بيانات اعتماد كل قاعدة بيانات متصلة بها، فإن كشف المنفذ 8978 مباشرة للإنترنت خطر بشكل خاص — اختراق CloudBeaver يعني اختراق كل قاعدة بيانات يمكنها الوصول إليها. قيّد المنفذ 8978 بـ ufw أو جدار حماية مزود السحابة على عناوين IP موثوقة فقط، وضعه خلف وكيل عكسي منهي لـ TLS لأي وصول عن بُعد. إذا كانت CloudBeaver تحتاج الوصول فقط من شبكتك المحلية أو عبر VPN، لا تنشر المنفذ للإنترنت العام إطلاقاً.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً دليل ./workspace الذي يحمل إعداداتك وحسابات المستخدمين وكل اتصال قاعدة بيانات محفوظ بما فيها بيانات الاعتماد
- تعامل مع نسخ workspace الاحتياطية كمادة سرية — شفّرها أثناء التخزين لأنها تحتوي بيانات اعتماد قاعدة بيانات نصية أو قابلة للعكس
- وثّق أي قواعد بيانات يشير إليها كل اتصال محفوظ، في حال احتجت إعادة إنشاء الاتصالات يدوياً على نسخة جديدة
- خزّن نسخ workspace الاحتياطية على تخزين منفصل عن مضيف CloudBeaver، ويُفضّل بنفس قيود الوصول للبيانات الحية
- اختبر استعادة دليل workspace إلى حاوية CloudBeaver جديدة دورياً للتأكد أن المستخدمين والاتصالات تعود سليمة
الأخطاء الشائعة
- ترك المنفذ 8978 مفتوحاً للإنترنت خلال الفجوة بين تثبيت CloudBeaver وإكمال معالج الإعداد، مما يتيح لأي شخص الاستيلاء على حساب المسؤول
- استخدام 'localhost' كمضيف قاعدة البيانات عند الاتصال بقاعدة بيانات على نفس السيرفر — داخل الحاوية، localhost تعني الحاوية نفسها لا المضيف
- كشف المنفذ 8978 عبر HTTP عادي للمستخدمين البعيدين بدلاً من وضعه خلف وكيل عكسي TLS
- مشاركة حساب المسؤول الواحد بين الفريق بأكمله بدلاً من إنشاء حسابات فردية بصلاحيات محدودة
- عدم نسخ دليل ./workspace احتياطياً، ثم فقدان كل اتصال وبيانات اعتماد محفوظة عند إعادة إنشاء الحاوية
- منح كل مستخدم وصولاً لكل اتصال قاعدة بيانات بدلاً من تقييد الوصول لما يحتاجه كل شخص فعلياً
- نسيان أن CloudBeaver نفسها تخزّن بيانات اعتماد قواعد البيانات — التعامل مع الأداة كمنخفضة الخطورة بينما هي هدف عالي القيمة فعلياً
استكشاف الأخطاء وإصلاحها
- تعذّر الاتصال بقاعدة بيانات على 'localhost' — استخدم عنوان IP الخاص بالمضيف بدلاً منه، أو اسم الحاوية الأخرى إذا كانت قاعدة البيانات تعمل في حاوية Docker أخرى على نفس الشبكة
- معالج الإعداد لا يظهر عند الزيارة الأولى — امسح ذاكرة تخزين المتصفح المؤقتة أو راجع docker logs cloudbeaver لأخطاء البدء؛ قد تكون الحاوية ما زالت في طور التهيئة
- الاتصالات المحفوظة اختفت بعد إعادة التشغيل — تأكد أن حجم ./workspace مُركَّب بشكل صحيح ولم يُنشأ بالخطأ كحجم مجهول
- فشل تنزيل مشغل JDBC عند إضافة اتصال جديد — تحقق أن للحاوية وصولاً صادراً للإنترنت لتنزيل المشغلات عند أول استخدام، أو ضمّن المشغلات مسبقاً إذا كان السيرفر بلا اتصال
- تعذّر تسجيل الدخول بعد الإعداد — تأكد أنك تستخدم بيانات اعتماد المسؤول بالضبط التي أُنشئت أثناء المعالج؛ لا توجد إعادة تعيين كلمة مرور دون الوصول لـ workspace
- نتائج استعلام بطيئة في شبكة البيانات — قد تكون النتائج الكبيرة بطيئة العرض في المتصفح؛ أضف عبارة LIMIT أو استخدم التصفح بالصفحات للجداول الكبيرة
- المستخدمون يرون اتصالات لا ينبغي أن يروها — راجع صلاحيات الاتصال لكل مستخدم في لوحة المسؤول، لأن الاتصالات الجديدة لا تُقيَّد تلقائياً
البدائل
Adminer سكريبت PHP بملف واحد أخف بكثير من CloudBeaver لكنه يدير اتصال قاعدة بيانات واحداً فقط في كل مرة ويغطي محركات أقل. phpMyAdmin هو المعيار الراسخ منذ زمن لـ MySQL/MariaDB تحديداً، بواجهة ناضجة لكن دون دعم لأنواع قواعد بيانات أخرى. pgAdmin4 هو الأداة المكافئة المخصصة لـ PostgreSQL، تقدّم ميزات أعمق خاصة بـ Postgres من واجهة CloudBeaver العامة الغرض. DBeaver Desktop هو التطبيق الأصلي الذي بُنيت عليه CloudBeaver — ثبّته محلياً إذا كنت تعمل من جهاز واحد فقط ولا تحتاج وصولاً مشتركاً عبر المتصفح. لفريق يدير عدة محركات قواعد بيانات مختلفة ويريد لوحة ويب مشتركة واحدة بدلاً من التنقل بين عدة أدوات، تبقى CloudBeaver الخيار الأكثر تنوعاً.
متى لا تستخدمه
CloudBeaver ليست الخيار الصحيح إذا كان فريقك بأكمله يدير قاعدة بيانات MySQL واحدة فقط — phpMyAdmin أخف وأكثر تخصصاً لهذه الحالة تحديداً. إذا كنت تعمل وحدك من جهاز واحد ولا تحتاج أبداً لمشاركة الوصول، فإن تثبيت DBeaver Desktop محلياً يتجنب تشغيل سيرفر إضافي واعتبارات الأمان المصاحبة للوحة ويب مشتركة. كما لا تملك CloudBeaver تشفيراً مدمجاً في سيرفر الويب الخاص بها، فإذا لم تستطع الالتزام بوضع وكيل عكسي أمامها، فإن كشفها حتى لشبكة صغيرة موثوقة يحمل خطراً حقيقياً. للفرق التي تحتاج تحكماً دقيقاً بالوصول وتدقيقاً أصيلاً في قاعدة البيانات يتجاوز ما يوفره عميل SQL عام، قد تكون أداة إدارة وصول قواعد بيانات مخصصة خياراً أفضل من لوحة إدارة مشتركة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي CloudBeaver وكيف ترتبط بـ DBeaver؟
CloudBeaver هي النسخة الويبية من DBeaver، أداة قواعد البيانات المكتبية المعروفة، مبنية من نفس الفريق وعلى نفس المحرك. تحصل على محرر SQL وشبكة بيانات ومستعرض مخططات في متصفحك، متصلاً بـ PostgreSQL وMySQL وSQLite وSQL Server وOracle وعشرات غيرها عبر مشغلات JDBC.
ما هي بيانات الدخول الافتراضية؟
لا توجد أي منها — تُنشئ حساب المسؤول بنفسك في معالج إعداد عند أول زيارة. هذا مهم للأمان: إلى أن تكمل ذلك المعالج، يمكن لمن يصل للمنفذ 8978 أولاً الاستيلاء على حساب المسؤول، لذا أكمله فوراً بعد التثبيت وأبقِ المنفذ محمياً بجدار ناري في الأثناء.
لماذا لا يمكنني الاتصال بقاعدة بيانات على localhost؟
لأن 'localhost' داخل حاوية CloudBeaver تعني الحاوية نفسها، لا سيرفرك. استخدم عنوان IP الخاص بالمضيف بدلاً منه، أو إذا كانت قاعدة البيانات تعمل في حاوية أخرى على نفس شبكة Docker، استخدم اسم تلك الحاوية كاسم المضيف.
أين تُخزَّن اتصالاتي وإعداداتي؟
في حجم ./workspace، الذي يُطابق /opt/cloudbeaver/workspace ويحمل إعداداتك ومستخدميك والاتصالات المحفوظة. انسخه احتياطياً، وتعامل مع تلك النسخة كسرّ — فهي تحتوي بيانات اعتماد مخزَّنة لكل قاعدة بيانات أضفتها.
هل من الآمن كشف المنفذ 8978 للإنترنت؟
ليس كما هي منشورة. إنها HTTP عادي، فتنتقل بيانات الدخول ونتائج الاستعلامات عبر الشبكة دون تشفير، وهذه اللوحة الواحدة تحمل بيانات اعتماد كل قاعدة بيانات متصلة بها — اختراقها يعني اختراقها جميعاً. قيّد المنفذ 8978 بـ ufw وضعه خلف وكيل عكسي TLS لأي وصول عن بُعد.