Supabase مفتوح المصدر: التثبيت والمراقبة

Supabase مفتوح المصدر: التثبيت بـ Docker بحسب الوثائق، والمعمارية، والمراقبة في الاستضافة الذاتية، وحدود الحزمة، مع Postgres والمتجهات.
Supabase Postgres open source : installer et superviser

Supabase مفتوح المصدر: يجمع المستودع supabase/supabase منصة تطوير مبنية حول PostgreSQL، مع مصادقة وواجهات API تلقائية وتخزين ملفات ودوال وصندوق أدوات للمتجهات والذكاء الاصطناعي. وكان يعرض نحو 113 200 نجمة في أكتوبر 2026، بترخيص Apache-2.0. ويقدّمه README بوصفه «منصة تطوير Postgres» التي تبني وظائف Firebase بأدوات مفتوحة المصدر بمستوى المؤسسات.

بالنسبة إلى فريق منتج، هو خلفية جاهزة للاستخدام. وبالنسبة إلى فريق التشغيل، هو قبل كل شيء حزمة من عدة خدمات يجب استضافتها ومراقبتها إن اخترت الاستضافة الذاتية. يعرض هذا المقال ما يقوله المستودع، والتثبيت بـ Docker بحسب الوثائق، وما يمكن مراقبته، مع قيد مهم: واجهة مقاييس الخدمة المستضافة غير موجودة في الاستضافة الذاتية.

المعلومات مأخوذة من README والوثائق الرسمية. لم تثبّت span.observer برنامج Supabase: الصور أدناه مأخوذة من المستودع ومن وثائق المشروع.

Supabase مفتوح المصدر: ما يقوله المستودع

  • الترخيص: Apache-2.0 (ملف LICENSE في المستودع). ويضيف README أن المشروع يستخدم أدوات بترخيص MIT أو Apache 2 أو ما يعادلهما متى وُجدت، ويطوّر غيرها ويفتحها بنفسه: هذا وصف المشروع.
  • الوظائف المذكورة: قاعدة Postgres مستضافة، ومصادقة وتفويض، وواجهات API مولَّدة (REST وGraphQL واشتراكات الزمن الحقيقي)، ودوال قاعدة البيانات وEdge Functions، وتخزين الملفات، وصندوق أدوات الذكاء الاصطناعي والمتجهات، ولوحة معلومات.
  • أنماط الاستخدام: منصة مستضافة (من دون تثبيت)، أو استضافة ذاتية، أو تطوير محلي، بحسب README.
  • العملاء الرسميون: JavaScript وTypeScript وFlutter وSwift وPython؛ وتصون المجتمعات لغات أخرى.
  • الإصدارات: لا ينشر المستودع إصدارًا في صفحة releases عند تاريخ القراءة؛ وتذكر وثائق الاستضافة الذاتية وسمًا (tag) هو self-hosted/v0.8.3.
لقطة من README الخاص بـ Supabase: لوحة معلومات دالة Edge مع منحنيات زمن التنفيذ وعدد الاستدعاءات وعدد الأخطاء خلال سبعة أيام
Source : github.com

تُظهر لقطة README لوحة المعلومات (Studio) على دالة Edge: زمن التنفيذ والاستدعاءات والأخطاء. هذا هو منظور «الصحة» الأساسي من جهة التطبيق.

مخطط معمارية من مستودع Supabase: بوابة Envoy توجّه /auth إلى GoTrue، و/rest إلى PostgREST، و/realtime إلى Realtime، و/storage إلى Storage، و/pg إلى pg-meta، و/functions إلى Functions، و/graphql إلى pg_graphql، وكلها موصولة بـ PostgreSQL
Source : github.com

يوضح مخطط المعمارية الأساس: بوابة Envoy توجّه كل مسار إلى خدمة، وتعتمد كلها على PostgreSQL. ويصف README هذه المكوّنات: Postgres، وRealtime (خادم Elixir ينشر تغييرات القاعدة عبر websockets)، وPostgREST (واجهة REST مولَّدة)، وGoTrue (مصادقة بـ JWT)، وStorage (ملفات على S3 وصلاحياتها في Postgres)، وpg_graphql وpostgres-meta.

تثبيت Supabase في الاستضافة الذاتية بواسطة Docker

الخطوة 1 — المتطلبات

تفترض الوثائق أنك مرتاح في إدارة Linux وGit وDocker وDocker Compose. الموارد الدنيا: 4 غيغابايت من الذاكرة RAM ونواتان و40 غيغابايت SSD؛ والموصى بها: 8 غيغابايت أو أكثر و4 أنوية أو أكثر و80 غيغابايت أو أكثر.

الخطوة 2 — البدء السريع على Linux

curl -fsSL https://supabase.link/setup.sh | sh
cd supabase-project && \
sh run.sh start

يثبّت السكربت، المدعوم على Debian وUbuntu وعائلة RHEL، المتطلبات ويجلب الإعداد ويولّد الأسرار والمفاتيح ويجهّز الصور. وتوضح الوثائق أن الرابط المختصر يشير إلى setup.sh: افحصه قبل تنفيذه. ويعرض sh run.sh secrets المعرّفات المولَّدة.

الخطوة 3 — أو التثبيت اليدوي على أي نظام

أوامر من وثائق الاستضافة الذاتية لـ Supabase: استنساخ المستودع عند الوسم self-hosted/v0.8.3، ونسخ إعداد Docker، وإنشاء ملف .env، وdocker compose pull، ثم سكربتات توليد المفاتيح
Source : supabase.com

يحتوي الملف .env.example كلمات مرور مثال. وتحذّر الوثائق من البدء بهذه القيم أبدًا: ولّد الأسرار بـ sh utils/generate-keys.sh وsh utils/add-new-auth-keys.sh، ثم اضبط SUPABASE_PUBLIC_URL وAPI_EXTERNAL_URL وSITE_URL. وتستمع البوابة افتراضيًا على المنفذ 8000.

مراقبة Supabase

ما تقدمه الخدمة المستضافة

تصف الوثائق واجهة مقاييس متوافقة مع Prometheus (نحو 200 سلسلة لـ Postgres) تُربط بـ Grafana أو أدوات أخرى. وتوضح أن هذه الواجهة في مرحلة تجريبية (beta)، وأن أسماء المقاييس قد تتغير، وأنها غير متاحة في النسخ المستضافة ذاتيًا.

في الاستضافة الذاتية

لا يتضمن الإعداد الافتراضي Logs وAnalytics. وتذكر الوثائق إمكان تفعيل Logflare (التحليلات) وVector (جمع السجلات) وLog Explorer في Studio بملف تجاوز (override) لـ Docker Compose، مقابل موارد إضافية. وفي ما عدا ذلك تراقب حزمة Docker تقليدية:

  • الحاويات والموارد: الحالة وإعادات التشغيل وذاكرة كل خدمة (البوابة والقاعدة والمصادقة وRealtime وStorage…)، بأدواتك المعتادة.
  • PostgreSQL: الاتصالات والأقفال والاستعلامات البطيئة والنسخ المتماثل، بمُصدِّر مناسب؛ ولنقل الإشارات راجع Collector في OpenTelemetry نحو Dynatrace.
  • السجلات: إن أرسلتها إلى منصة فاحتفظ بمعرّف التتبع في كل سطر؛ راجع سجلات OpenTelemetry مع معرّف التتبع.

لم نعثر على تصدير OpenTelemetry أصلي موثق للحزمة المستضافة ذاتيًا.

كيف تتحقق من أن كل شيء يعمل؟

  • يبيّن docker compose ps أن كل الخدمات قيد التشغيل وسليمة.
  • تُفتح لوحة Studio على عنوان البوابة، بكلمة المرور المولَّدة عند التثبيت.
  • يردّ طلب على واجهة REST لجدول اختبار، ويظهره سجل الحاوية المقابلة.

الحدود والنقاط المفتوحة

  • أنت من يشغّل الحزمة: النسخ الاحتياطي والتحديثات وTLS وأمان الشبكة على عاتقك؛ وتوصي الوثائق بالمنصة المستضافة إن كانت هذه المواضيع جديدة عليك.
  • تكافؤ جزئي: واجهة المقاييس غائبة في الاستضافة الذاتية؛ تحقق من قائمة الوظائف قبل الترحيل.
  • أسرار افتراضية: لا تحتفظ أبدًا بقيم .env.example.
  • تتبع الإصدار: من دون صفحة releases، يكون الوسم self-hosted/… في الوثائق هو المرجع؛ دوّنه عند كل تثبيت.

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

  • ثبّت وسم الإعداد (self-hosted/vX.Y.Z) وأعد قراءة الملاحظات قبل التحديث.
  • لا تنشر القاعدة على الإنترنت: مرّر الوصول عبر البوابة وبروكسي TLS.
  • أعد قراءة وثائق التحكم في الوصول إلى البيانات قبل كشف الجداول عبر الـ API.
  • خطّط لنسخ احتياطية للقاعدة واختبر الاستعادة.
  • لحزمة ذكاء اصطناعي كاملة راجع حزمة الذكاء الاصطناعي مفتوحة المصدر المستضافة ذاتيًا وDify وn8n.

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

هل Supabase بديل حقيقي لـ Firebase؟

يصف المشروع نفسه بأنه يبني وظائف Firebase بأدوات مفتوحة المصدر، لكنه يوضح أنه ليس مطابقة واحدًا لواحد: القاعدة هي PostgreSQL لا مخزن مستندات.

هل يمكن استخدامه للمتجهات والذكاء الاصطناعي؟

يسرد README صندوق أدوات للذكاء الاصطناعي والمتجهات. راجع وثائقه للاطلاع على الامتدادات وحدود إصدارك.

هل الاستضافة الذاتية مجانية؟

الشيفرة بترخيص Apache-2.0؛ أما الخادم والتخزين والتشغيل فعلى حسابك.

الخلاصة

يجمع Supabase مكوّنات مفتوحة المصدر حول PostgreSQL ويقدّم مسارين: الخدمة المستضافة، أو حزمة Docker تشغّلها بنفسك. وفي الحالة الثانية خطّط من البداية لمراقبة الحاويات والقاعدة، لأن واجهة مقاييس الخدمة المستضافة غير مشمولة.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية (supabase.com/docs).

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Graphify graphe de connaissances : cartographier un code

الرسم البياني للمعرفة مع Graphify: خريطة لشيفرة مجهولة

Next Post
Twenty CRM open source : installer, licence et supervision

Twenty CRM مفتوح المصدر: التثبيت والترخيص والمراقبة

Related Posts