⚡ تثبيت PocketBase — خادم الواجهة الخلفية المتكامل والبديل الحر لـ Firebase على Docker

نشر منصة PocketBase على Ubuntu باستخدام Docker — محرك الواجهة الخلفية كخدمة (BaaS) فائق السرعة مفتوح المصدر في ملف تنفيذي واحد مع قاعدة بيانات SQLite، والاشتراكات اللحظية، والمصادقة، ولوحة التحكم.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر PocketBase على المنفذ 8090 مع حفظ دائم لقاعدة بيانات SQLite وواجهات REST API جاهزة فوراً.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/CMS/pocketbase/pocketbase-ubuntu.sh

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

chmod +x pocketbase-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./pb_data`) وتشغيل حاوية PocketBase الرسمية على المنفذ 8090.

sudo bash pocketbase-ubuntu.sh

4 إنشاء حساب المشرف والبدء في التطوير

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8090/_/. اتبع التعليمات لإنشاء حساب المشرف والوصول للوحة إدارة الجداول والبيانات.

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

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

المنفذالغرض
8090HTTP Admin UI + REST API

نظرة عامة

يعد PocketBase منصة واجهة خلفية كخدمة (Backend-as-a-Service) حديثة وفائقة الخفة مفتوحة المصدر مجمعة في ملف تنفيذي واحد بلغة Go. يعمل المحرك على المنفذ 8090، ويوفر كل ما يحتاجه مطورو تطبيقات الويب والهواتف: قاعدة بيانات SQLite مدمجة ومحسّنة (بوضع WAL)، ومزامنة بيانات لحظية عبر قنوات WebSockets/SSE، ونظام مصادقة مستخدمين متكامل (البريد وكلمة المرور وحسابات OAuth2 عبر Google وGitHub وApple)، ونظام تخزين للملفات والمرفقات، ولوحة تحكم ويب إدارية جذابة.

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

تفرض منصات الواجهات الخلفية السحابية (مثل Firebase أو Supabase أو AWS Amplify) تكاليف اشتراك متصاعدة مع زيادة عدد المستخدمين والاستعلامات وتحبسك داخل أنظمتها المغلقة. يوفر PocketBase واجهة خلفية متكاملة تعمل داخل حاوية واحدة على سيرفر VPS اقتصادي للغاية ($4 شهرياً)، وتتحمل أكثر من 10,000 اتصال متزامن بزمن استجابة أقل من 10 مللي ثانية، وبدون أي تعقيدات في إدارة خوادم قواعد البيانات.

متى تحتاجه

  • تبني تطبيقات ويب أو هواتف (Flutter أو React أو Vue أو Svelte أو Swift) وتحتاج لواجهة خلفية سريعة بدون كتابة أكواد مسارات وخوادم متكررة
  • تريد بديلاً مفتوح المصدر ومستضافاً ذاتياً لخدمة Firebase Firestore مع مزامنة لحظية للبيانات
  • تحتاج إلى نظام تسجيل مستخدمين ومصادقة (OAuth2 واستعادة كلمات المرور وتأكيد البريد) جاهز فوراً
  • تريد لوحة تحكم إدارية بصرية على مسار `/_/` لإدارة الجداول وفحص وتعديل البيانات بسهولة
  • تبحث عن محرك خفيف جداً يستهلك أقل من 30 ميجابايت من الذاكرة العشوائية وبدون قواعد بيانات خارجية ضخمة

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

  • بناء تطبيقات محادثة فورية أو أدوات عمل جماعية تعتمد على البث اللحظي لتحديثات قاعدة البيانات
  • تغذية تطبيقات الهواتف الذكية بنظام المصادقة والصور الشخصية ومزامنة البيانات في الوقت الفعلي
  • استخدامه كنظام إدارة محتوى بدون واجهة (Headless CMS) لمواقع Astro وNext.js وHugo
  • جمع قراءات أجهزة الاستشعار وإنترنت الأشياء وتخزينها بتوقيتات دقيقة وفلترتها بسهولة
  • تطبيق قواعد حماية دقيقة للبيانات (RBAC) باستخدام شروط وقوانين API مباشرة من لوحة التحكم

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

  • قاعدة بيانات SQLite مدمجة بوضع Write-Ahead Logging (WAL) توفر سرعة استثنائية في القراءة والكتابة
  • اشتراكات لحظية: الاستماع لتغييرات الجداول (إنشاء، تعديل، حذف) عبر WebSockets / SSE بسطر كود واحد
  • نظام مصادقة متكامل: البريد وكلمة المرور، مزودو OAuth2 (جوجل، جيت هب، ديسكورد، أبل)، والرموز المشفرة
  • إدارة رفع الملفات والصور مع توليد تلقائي للصور المصغرة وضبط صلاحيات الوصول
  • قواعد أمان تصريحية (API Rules): تأمين المجموعات بشروط SQL بسيطة (مثل `@request.auth.id = user.id`)
  • مكتبات برمجية رسمية لـ JavaScript/TypeScript وDart/Flutter مع دعم كامل لأنماط البيانات
  • لوحة تحكم إدارية عصرية فائقة السرعة على مسار `/_/` تدعم الوضع الداكن ومحرر الجداول الحي
  • نشر منظم عبر Docker مع ربط مجلد `./pb_data` لحفظ قاعدة البيانات والمرفقات بشكل دائم

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8090/_/ لعرض لوحة تحكم المشرف
  • أدخل بريدك الإلكتروني وكلمة مرور قوية لإنشاء حساب المشرف الأساسي
  • انقر على 'New Collection' لإنشاء جدولك الأول (مثل 'posts' أو 'products' أو 'messages')
  • أضف حقول البيانات (نصوص، أرقام، منطقي، بريد، ملفات، وعلاقات) واضبط شروط وقوانين الوصول (API Rules)
  • اربط تطبيقك الأمامي باستخدام مكتبة JavaScript الرسمية (`npm install pocketbase`) أو مكتبة Flutter
  • ضع PocketBase خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة للإنتاج
  • فعل ميزة النسخ الاحتياطي التلقائي من Settings ← Backups داخل لوحة التحكم

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

  • أنشئ حساب المشرف الأساسي فور تشغيل الحاوية لمنع أي شخص آخر من أخذ ملكية السيرفر
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي لحماية رموز الجلسات وكلمات المرور أثناء النقل
  • اضبط دائماً قوانين الوصول (API Rules) لكل جدول — ترك القوانين فارغة يعني أن المشرف فقط هو من يمكنه الوصول
  • لا تكشف المنفذ 8090 للإنترنت العام مباشرة دون المرور عبر وكيل عكسي مشفر بـ SSL
  • احمِ مجلد البيانات `./pb_data` الذي يحتوي على ملف قاعدة بيانات SQLite ومفاتيح التشفير بصلاحيات مناسبة
  • حدّث صورة الحاوية دورياً للحصول على الميزات الجديدة والترقيعات الأمنية

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

يقدم PocketBase لوحة التحكم والواجهات البرمجية REST/SSE عبر منفذ TCP 8090. في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8090، مع إبقاء المنفذ 8090 مغلقاً في جدار الحماية الخارجي وفتح المنفذين 80 و443 للزوار.

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

  • انسخ مجلد `./pb_data` احتياطياً، والذي يحتوي على ملفات `data.db` و`auxiliary.db` ومجلد الملفات `storage/`
  • استخدم ميزة النسخ الاحتياطي بنقرة زر في لوحة التحكم (Settings ← Backups) لتوليد ملفات zip مضغوطة
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة باسترجاع ملف `data.db` في حاوية تجريبية للتأكد من فتح كافة الجداول بنجاح

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

  • ترك قوانين الوصول (API Rules) فارغة في الجداول والتساؤل عن سبب ظهور خطأ 403 Forbidden في التطبيق
  • تخزين الملفات والمرفقات داخل الحاوية دون ربط مجلد التخزين الدائم `./pb_data`
  • محاولة تشغيل عدة نسخ متزامنة من السيرفر على نفس ملف SQLite (حيث صُمم PocketBase للتوسع الرأسي في عقدة واحدة)
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL
  • نسيان ضبط إعدادات CORS والنطاقات المسموح لها بالاتصال في إعدادات PocketBase

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

  • لوحة التحكم لا تفتح عند فتح الرابط الرئيسي — تأكد من الدخول للمسار المحدد `http://ip-سيرفرك:8090/_/` (مع الشرطة المائلة الأخيرة)
  • طلبات التطبيق تستجيب بخطأ 403 Forbidden — راجع قوانين API Rules للجدول في لوحة التحكم وتأكد من منح صلاحيات القراءة
  • الأحداث اللحظية لا تصل للتطبيق — تأكد من دعم الوكيل العكسي لـ Server-Sent Events (SSE) وتعطيل التخزين المؤقت (`proxy_buffering off;`)
  • خطأ قفل قاعدة البيانات (Database locked) — تأكد من دعم نظام الملفات بالسيرفر لتقنية SQLite WAL (تجنب مساحات الشبكة NFS)
  • نسيان كلمة مرور المشرف — أعد تعيين كلمة المرور عبر سطر الأوامر: `docker exec -it pocketbase /pb/pocketbase admin update <بريدك> <كلمتك_الجديدة>`

البدائل

منصة Supabase بديل Firebase المتكامل المعتمد على PostgreSQL. منصة Appwrite خدمة BaaS مفتوحة المصدر تدعم عدة لغات. منصة Firebase الخدمة السحابية التجارية المغلقة من جوجل. منصة Directus محرك بيانات لقواعد بيانات SQL. منصة Strapi نظام Headless CMS بـ Node.js.

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

تجنب استخدام PocketBase إذا كان تطبيقك يتطلب توزيع قاعدة البيانات عبر عشرات الخوادم في قارات متعددة (حيث صُممت منصات مثل Supabase أو AWS Aurora للتوزيع العنقودي الضخم). وإذا كنت تحتاج لإجراءات مخزنة ومعاملات مالية معقدة متعددة الجداول مع أقفال موزعة، فإن بنية PostgreSQL التقليدية أنسب.

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

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

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

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

ما هو PocketBase وما الفرق بينه وبين Firebase؟

يعد PocketBase واجهة خلفية كخدمة مفتوحة المصدر ومستضافة ذاتياً 100% في ملف تنفيذي واحد. وبخلاف Firebase الذي يحبسك داخل سحابة جوجل بفواتير متزايدة، يمنحك PocketBase الملكية التامة على قاعدة بيانات SQLite مدمجة بدون أي رسوم.

ما مدى سرعة PocketBase وكم عدد المستخدمين الذين يمكنه استيعابهم؟

يتميز PocketBase بسرعة فائقة بفضل لغة Go ومحرك SQLite WAL. وعلى سيرفر VPS بسيط (بـ 5 إلى 10 دولارات شهرياً)، يمكنه استيعاب أكثر من 10,000 اتصال متزامن وآلاف الطلبات بالثانية بزمن استجابة أقل من 10 مللي ثانية.

هل يدعم PocketBase تدفق وتحديث البيانات اللحظي؟

نعم! يتضمن PocketBase اشتراكات لحظية أصلية عبر Server-Sent Events (SSE)، مما يتيح للتطبيقات استقبال التحديثات الحية فور إضافة أو تعديل أو حذف أي سجل في قاعدة البيانات.

هل يمكن توسيع وبرمجة دوال مخصصة في PocketBase؟

نعم! يمكن استخدام PocketBase كإطار عمل بلغة Go أو كتابة سكريبتات جافاسكريبت داخلية في مجلد `pb_hooks` لإنشاء مسارات API مخصصة واعتراض الأحداث.

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

يعد PocketBase خفيفاً بشكل مذهل، حيث يستهلك عادة ما بين 15 إلى 30 ميجابايت فقط من الذاكرة العشوائية في وضع الاستعداد، ونادراً ما يتجاوز 100 ميجابايت تحت أعباء العمل المتوسطة.