⚡ تثبيت Supabase — بديل Firebase مفتوح المصدر وقاعدة بيانات PostgreSQL على Docker
نشر منصة Supabase على Ubuntu باستخدام Docker — البديل مفتوح المصدر الرائد عالمياً لمنصة Firebase مع قاعدة بيانات PostgreSQL 15 ومحرك pgvector للمتجهات والمصادقة الفورية ولوحة التحكم Studio على المنفذ 8200.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/supabase/supabase-ubuntu.sh
chmod +x supabase-ubuntu.sh
sudo bash supabase-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/supabase/supabase-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x supabase-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين الدائم لقاعدة البيانات والملفات (`./volumes`) وتوليد شفرات الـ JWT ومفاتيح الـ API وتشغيل حزمة Supabase المتكاملة خلف بوابة Kong على المنفذ 8200.
sudo bash supabase-ubuntu.sh
4 فتح لوحة Studio وبدء التطوير
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8200. سجل دخولك للوحة Supabase Studio ببيانات المشرف، وصمم جداولك مع تفعيل سياسات الأمان على مستوى الصفوف (RLS)، واربط تطبيقاتك عبر مكتبات Supabase الرسمية.
http://<your-server-ip>:8200
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8200 | Kong gateway (HTTP) — Studio, REST API, auth, storage, realtime |
| 8447 | Kong gateway (HTTPS) |
| internal | PostgreSQL 5432 + a dozen Supabase services (keep internal) |
نظرة عامة
تعد Supabase المنصة مفتوحة المصدر الرائدة عالمياً لخدمات الخلفية البرمجية كخدمة (BaaS) والبديل الأقوى لمنصة Google Firebase. تعمل المنصة عبر المنفذ 8200 من خلال بوابة Kong API، وتقدم بنية تحتية سحابية مؤسسية متمحورة حول قاعدة بيانات PostgreSQL 15 العلائقية. وتجمع المنصة بين توليد واجهات الـ REST API اللحظية (PostgREST)، وواجهات GraphQL، والبث الحي عبر WebSockets (Realtime)، ونظام مصادقة المستخدمين الشامل بالـ JWT ومزودي OAuth (GoTrue)، ومساحة تخزين الملفات المتوافقة مع S3، ودوال الحافة البرمجية (Edge Functions)، مع إضافة pgvector للذكاء الاصطناعي، ولوحة التحكم البصرية التفاعلية Supabase Studio.
لماذا تستخدمه
يستغرق بناء البنية التحتية الخلفية للتطبيقات من الصفر (إدارة قواعد البيانات والمصادقة وتخزين الصور والبث اللحظي للدردشة) شهوراً من العمل الشاق. كما تفرض المنصات السحابية مثل Firebase تكاليف غير متوقعة وتقييداً على قواعد بيانات NoSQL خاصة. تمنحك الاستضافة الذاتية لـ Supabase منصة متكاملة ومعيارية على قاعدة بيانات PostgreSQL الحقيقية على سيرفرك الخاص مع سيادة كاملة على البيانات بنسبة 100% وانعدام أي تكاليف أو قيود على عدد المستخدمين والطلبات.
متى تحتاجه
- تبحث عن بديل مفتوح المصدر لمنصة Google Firebase يعتمد على قاعدة بيانات PostgreSQL علائقية حقيقية
- تحتاج إلى توليد واجهات REST وGraphQL برمجية آلياً وفورياً من جداولك مع تطبيق سياسات الأمان (RLS)
- تحتاج إلى نظام مصادقة شامل (البريد، والروابط السحرية، وجوجل، وجيت هاب، وأبل) يدعم توكنات JWT المشفرة
- تبني تطبيقات تفاعلية فورية أو أنظمة محادثة ودردشة حية تعتمد على بث تغييرات قاعدة البيانات عبر WebSockets
- تطور تطبيقات ذكاء اصطناعي وتوليد معزز بالاسترجاع (RAG) تتطلب تخزين وبحث المتجهات عبر إضافة pgvector
من يحتاجه
- مطورو الويب وتطبيقات الهواتف (React وNext.js وFlutter وReact Native) لبناء تطبيقات سريعة واحترافية
- مؤسسو الشركات الناشئة والمشاريع البرمجية لإطلاق منتجاتهم في أسرع وقت دون تكاليف سحابية متكررة
- مهندسو الذكاء الاصطناعي لتخزين متجهات التضمين (Embeddings) في PostgreSQL عبر pgvector
- المؤسسات والشركات التي تتطلب سيادة كاملة على بيانات المستخدمين وتوافقاً صارماً مع معايير GDPR
- أصحاب السيرفرات المنزلية لاستضافة خادم مركزي شامل لكافة قواعد البيانات وتطبيقاتهم الخاصة
حالات الاستخدام الشائعة
- بناء منصة SaaS سحابية متعددة المستأجرين مع عزل بيانات كل عميل باستخدام سياسات Row Level Security (RLS)
- تغذية تطبيق دردشة فورية بـ Flutter يعتمد على WebSockets لتسليم الرسائل اللحظية في أجزاء من الثانية
- تخزين متجهات نصوص OpenAI في PostgreSQL عبر pgvector لتنفيذ أنظمة البحث الدلالي الذكي (Semantic Search)
- إدارة تسجيل المستخدمين والتحقق بالبريد وتوليد جلسات الأمان باستخدام منظومة GoTrue
- استضافة ورفع صور الملفات الشخصية والمستندات في مساحات تخزين متوافقة مع S3 مع صلاحيات وصول دقيقة
الميزات الرئيسية
- محرك PostgreSQL 15 المتكامل: قوة الاستعلامات العلائقية، والمحفزات (Triggers)، وإضافات pgvector وPostGIS
- لوحة تحكم Supabase Studio على المنفذ 8200: محرر جداول بصري، ومنفذ استعلامات SQL، وسجلات النظام الحية
- توليد واجهات PostgREST آلياً: استعلام وفلترة وتحديث البيانات بطلبات HTTP قياسية بدون كتابة أكواد خلفية
- منظومة مصادقة GoTrue: تسجيل الدخول بكلمة المرور، والروابط السحرية، وتكاملات OAuth مع جوجل وجيت هاب وأبل
- محرك البث اللحظي Realtime: استقبال أحداث تغييرات قاعدة البيانات (INSERT وUPDATE) عبر WebSockets
- تخزين وسائط متوافق مع S3: رفع وتحويل وخدمة ملفات المستخدمين مع سياسات وصول دقيقة للمجلدات
- بوابة Kong API المدمجة: توجيه الطلبات وفحص مفاتيح الـ API وتحديد معدل الاستهلاك على المنفذين 8200 و8447
- حزم SDK رسمية شاملة: دعم كامل للغات JavaScript/TypeScript وPython وFlutter وSwift وGo
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8200 لعرض لوحة تحكم Supabase Studio
- سجل الدخول ببيانات المشرف المحددة في ملف المتغيرات `.env`
- انتقل إلى 'Table Editor' وأنشئ جدولك الأول (مثل `profiles` أو `tasks`)
- فعل ميزة Row Level Security (RLS) على الجدول وأضف سياسات القراءة والكتابة للمستخدمين
- انتقل إلى Settings ← API لنسخ المفتاح العام `anon key` ومفتاح السيرفر السري `service_role` لتطبيقك
- ضع بوابة Kong (منفذ 8200) خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./volumes/db/data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: فعل دائماً سياسات الأمان على مستوى الصفوف (RLS) لكافة الجداول لحماية بيانات المستخدمين من التسريب
- لا تضع المفتاح السري `service_role` في تطبيقات الواجهة الأمامية (Frontend) أبداً؛ واقصره على خوادمك الخلفية الآمنة
- عيّن كلمات مرور وتوكنات JWT معقدة وعشوائية لمتغيرات `JWT_SECRET` و`POSTGRES_PASSWORD` في ملف `.env`
- استخدم تشفير HTTPS دائماً في الإنتاج لحماية كافة التوكنات والاستدعاءات البرمجية أثناء النقل
- أبقِ منفذ قاعدة البيانات 5432 والمنافذ الداخلية مغلقة في جدار الحماية الخارجي للسيرفر
- حدّث صور حاويات Supabase دورياً للحصول على أحدث التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم Supabase خدماته عبر بوابة Kong على منفذ TCP 8200 (HTTP) ومنفذ 8447 (HTTPS). وتمر كافة الخدمات المصغرة (Studio وGoTrue وPostgREST وRealtime وStorage) عبر Kong. يجب السماح بالمنفذ 8200 في جدار الحماية للشبكة المحلية (`ufw allow 8200/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 وأبقِ المنفذ 8200 ومنفذ قاعدة البيانات 5432 مغلقين خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./volumes/db/data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات PostgreSQL والمستخدمين والجداول
- انسخ مجلد `./volumes/storage` الذي يحتوي على كافة ملفات وصور المستخدمين المرفوعة
- استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec supabase-db pg_dump -U postgres postgres > supabase_backup.sql`
- احتفظ بنسخة مشفرة من ملف `.env` الذي يحتوي على مفاتيح الـ JWT وتوكنات الـ API وكلمات المرور
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية مشفرة عبر restic أو rsync
الأخطاء الشائعة
- تعطيل سياسات الأمان (RLS) على الجداول مما يتيح لأي شخص يمتلك المفتاح العام `anon` قراءة وتعديل كافة البيانات
- تسريب المفتاح السري `service_role` داخل أكواد الواجهة الأمامية (React أو Flutter) مما يمنح الزوار صلاحية المشرف الكاملة
- محاولة تشغيل الحزمة على سيرفر بذاكرة عشوائية أقل من 2 إلى 4 جيجابايت RAM
- عدم ربط مجلد التخزين الدائم `./volumes/db/data`، مما يسبب فقدان قاعدة البيانات بالكامل عند تحديث الحاوية
- التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL
استكشاف الأخطاء وإصلاحها
- طلبات الـ API تعيد خطأ 401 Unauthorized — تأكد من صحة ترويسة `apikey` ومفتاح الـ `anon` ومطابقته لملف `.env`
- ظهور خطأ 502 Bad Gateway في Studio — افحص صحة الحاويات بـ `docker compose ps` وافحص سجلات Kong بـ `docker logs supabase-kong`
- فشل اتصال مقابس WebSockets بالـ Realtime — تأكد من تفعيل ترويسات `Upgrade` و`Connection` في خادم Nginx
- فشل الاتصال بقاعدة بيانات PostgreSQL — تأكد من عمل حاوية `supabase-db` وصحة الصلاحيات
- فشل رفع الملفات في Storage — راجع صلاحيات المجلدات في المسار `./volumes/storage` بالسيرفر
البدائل
منصة Google Firebase التجارية السحابية. منصة PocketBase الخفيفة المدمجة بـ Go وSQLite. منصة Appwrite مفتوحة المصدر. منصة Directus لإدارة قواعد البيانات. محرك Hasura لتوليد واجهات GraphQL لقواعد PostgreSQL.
متى لا تستخدمه
تجنب استخدام Supabase إذا كنت تبحث عن قاعدة بيانات مدمجة بسيطة جداً لمشروع شخصي صغير يخدم أقل من 1,000 مستخدم (حيث تعد PocketBase أخف بكثير وتستهلك أقل من 20 ميجابايت RAM). وإذا كنت تفضل قواعد بيانات NoSQL الوثائقية وتريد بيئة سحابية لا تتطلب أي إدارة لسيرفرات Docker، فإن Firebase Cloud أسهل للمبتدئين.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي منصة Supabase وكيف تحل محل Firebase؟
تعد Supabase منصة خلفية كخدمة (BaaS) مفتوحة المصدر توفر كافة الميزات الأساسية لـ Firebase (المصادقة، والبث المباشر، وتخزين الملفات، والدوال البرمجية، وتوليد واجهات الـ API) ولكنها مبنية على قاعدة بيانات PostgreSQL العلائقية القياسية بدلاً من NoSQL المغلقة.
ما هي متطلبات العتاد الدنيا للاستضافة الذاتية لـ Supabase؟
يوصى بسيرفر يحتوي على 2 إلى 4 جيجابايت من الذاكرة العشوائية (RAM) ونواتين معالج بنظام Ubuntu 22.04/24.04 LTS لتشغيل حزمة Supabase المتكاملة (PostgreSQL وKong وStudio وGoTrue وRealtime) بسلاسة.
ما هي ميزة الأمان على مستوى الصفوف (Row Level Security - RLS)؟
تعد RLS ميزة أمنية مدمجة في PostgreSQL تتيح لك كتابة قواعد أمان تحدد السجلات التي يحق للمستخدم قراءتها أو تعديلها بناءً على معرّف حسابه، مما يضمن عزل بيانات كل مستخدم تلقائياً عند طلب البيانات من واجهات الـ API.
هل يمكن استخدام pgvector لتطبيقات الذكاء الاصطناعي في Supabase؟
نعم! تأتي صورة PostgreSQL الرسمية لـ Supabase مزودة بإضافة `pgvector` مسبقاً، مما يتيح لك تخزين وفهرسة واستعلام متجهات التضمين للبحث الدلالي وتطبيقات الذكاء الاصطناعي مباشرة بلغة SQL.
كيف أربط تطبيقي أو موقعي بخادم Supabase المستضاف ذاتياً؟
قم بتثبيت حزمة العميل الرسمية (`@supabase/supabase-js`) في تطبيقك، واستدعها بالأمر `createClient('https://api.yourdomain.com', 'anon-key')` مع كتابة رابط بوابة Kong والمفتاح العام الخاص بسيرفرك.