sbarbase
English
المحتويات

البداية السريعة

من خادم فارغ إلى استدعاء supabase-js على أول بيئة لك. هذه هي الخطوات التي نفّذتها تجربة كاملة على خادم فارغ، في آلة افتراضية نظيفة بنظام Fedora 44 فيها 4 أنوية معالج و6 GB من الذاكرة (lab/vm-rehearsal.sh). لم تُشغَّل على خادم حقيقي بعد، وخطوة HTTPS في النهاية لم تُفحص إلا بشهادة موقّعة ذاتيًا. صباربيز قيد التطوير: لا تضع عليه بيانات لا تحتمل خسارتها.

إذا كان Docker موجودًا على الخادم، فإن التثبيت عبر Docker أقصر ولا يعتمد على إصدار Python في الخادم. هذه الصفحة هي مسار systemd.

قبل أن تبدأ، اقرأ اختيار خادم. تحتاج صلاحية root على خادم Fedora 44 أو Ubuntu 26.04 فيه 4 أنوية و8 GB من الذاكرة (3 أنوية هي الحد الأدنى المفيد) و12 GiB من القرص الفارغ. آلة التجربة ذات 6 GB اتسعت لبيئة واحدة بالضبط، وهي التي تنشئها الخطوة 6.

ثماني خطوات: حزم النظام، وحساب الخدمة ونسخة المستودع، وBun، وملف المشغّل، وفحص الخادم، وأمر استلام واحد يثبّت ويجرّب وينشئ أول مشروع، ثم لوحة الإدارة عبر نفق SSH، وتطبيقك عبر HTTPS

المسار كله في نظرة واحدة، كما جُرّب في آلة افتراضية محلية؛ ولم يُشغَّل على خادم حقيقي بعد.

1. ثبّت حزم النظام

على Fedora 44:

sudo dnf install -y moby-engine git python3-cryptography
sudo systemctl enable --now docker

على Ubuntu 26.04 أو Ubuntu 24.04 أو Debian 13:

sudo apt-get install -y docker.io git python3-cryptography curl unzip
sudo systemctl enable --now docker

الحزمتان curl وunzip لمثبّت Bun في الخطوة 3. تحقق أن /usr/bin/python3 --version يعطي 3.12 أو أحدث. تنجح اختبارات الوحدات مع إصدار Python الذي يأتي مع Ubuntu 24.04 وDebian 13، لكن هذا التثبيت لم يُجرَّب من أوله إلى آخره إلا على Fedora 44، ولم يُجرَّب على أي من الأنظمة الثلاثة هذه.

2. أنشئ حساب الخدمة ونسخة المستودع

يعمل صباربيز بحسابه الخاص، وهو صاحب نسخة المستودع تحت /opt/sbarbase:

sudo useradd -m -s /bin/bash sbarbase
sudo usermod -aG docker sbarbase
sudo install -d -o sbarbase -g sbarbase /opt/sbarbase
sudo -u sbarbase git clone https://github.com/M7MMAD-OMAR/sbarbase /opt/sbarbase

العضوية في مجموعة docker تعادل root على هذا الخادم؛ ويشرح نموذج التهديد لماذا نقبل ذلك حاليًا.

3. ثبّت Bun لذلك الحساب

sudo -u sbarbase -H bash -c 'curl -fsSL https://bun.sh/install | bash -s bun-v1.3.14'

نسخت التجربة الملف التنفيذي نفسه لـBun 1.3.14 إلى /home/sbarbase/.bun/bin بدلًا من ذلك؛ والمثبّت الرسمي يضعه في المكان نفسه.

4. اكتب بيانات اعتماد المشغّل الأول في ملف خاص

cd /opt/sbarbase
sudo -u sbarbase /usr/bin/python3 lab/operator_file.py /home/sbarbase/operator.json

يطلب بريدًا إلكترونيًا واسم عميل وكلمة مرور (مرتين، دون إظهارها، و12 حرفًا على الأقل)، ثم يكتب ملفًا بالوضع 600. لا تظهر كلمة المرور أبدًا في وسيط أو سجل أو في الأدلة.

5. افحص الخادم

sudo -u sbarbase /usr/bin/python3 lab/install_server.py check

يجب أن ينتهي بـPreflight: 0 blocker(s). كل عائق يذكر ما عليك إصلاحه، ومعه أرقام الذاكرة والأنوية الدقيقة التي يحتاجها.

6. ثبّت وجرّب وأنشئ أول مشروع بأمر واحد

sudo deploy/server-acceptance.sh --rehearse --install-unit --first-project \
     --service-user sbarbase --home /home/sbarbase --bun-dir /home/sbarbase/.bun/bin \
     --docker-host unix:///var/run/docker.sock --bootstrap-file /home/sbarbase/operator.json

يفعل بالترتيب ما يلي: يفحص المتطلبات، ويبني لوحة الإدارة، ويفحص وكيل TLS، ويثبّت خدمة systemd المسماة sbarbase ويشغّلها، ويسحب الصور المثبّتة الإصدار (نحو 2.4 GB، مع عرض التقدم)، ويجرّب تشغيلًا وإيقافًا نظيفًا، ثم يشغّل الخدمة من جديد. بعدها ينشئ مشروعًا اسمه "First project" فيه بيئة production، ويصدر مفتاحًا، ويسجّل مستخدمًا بـsupabase-js عبر البوابة، ثم يسحب المفتاح. ينتهي بـServer acceptance: PASSED، وتُحفظ الأدلة في docs/evidence/. المشروع الأول حقيقي: يشغل واحدة من البيئات الثماني التي يسمح بها التثبيت، وحذفه لا يحرّر مكانها بعد، ويترك في تلك البيئة مستخدم تطبيق واحدًا للاختبار.

عند الفشل يذكر الأمر الخطوة التي فشلت، ويترك الخدمة كما وجدها. أصلح السبب وشغّل الأمر نفسه مجددًا.

7. افتح لوحة الإدارة

تستمع لوحة الإدارة على الواجهة المحلية فقط. ثبّت منفذها ليبقى بعد إعادة التشغيل، ثم صِل إليها من حاسوبك عبر نفق SSH:

sudo mkdir -p /etc/systemd/system/sbarbase.service.d
printf '[Service]\nEnvironment=SBARBASE_CONSOLE_PORT=8787\n' | sudo tee /etc/systemd/system/sbarbase.service.d/console-port.conf
sudo systemctl daemon-reload && sudo systemctl restart sbarbase
ssh -L 8787:127.0.0.1:8787 you@your-server

افتح بعدها http://localhost:8787 وادخل بالبريد وكلمة المرور من الخطوة 4. سترى عميلك و"First project" وبيئته production. افتح البيئة، وأنشئ مفتاحًا عامًا من API keys. تستطيع نسخ المفتاح العام مرة أخرى لاحقًا، أما المفتاح السري فلا يظهر إلا مرة واحدة.

8. استخدمه من تطبيقك

ينتهي Project URL الخاص بالبيئة بمسارها، /<runtime>. وعبر نفق SSH يبدأ بـ http://localhost:8787، فوجّه supabase-js إلى عنوانك العام مضافًا إليه ذلك المسار:

import {createClient} from '@supabase/supabase-js';
const supabase = createClient('https://console.example.com/<runtime>', '<publishable key>');

يعمل Auth وREST وStorage عبر هذا العنوان الواحد، من خادم أو من صفحة في المتصفح على أي نطاق. ويُشغَّل Realtime لكل بيئة (Realtime)، ويُضبط مزوّدو OAuth لكل بيئة (تسجيل الدخول)، وتُنشر Edge Functions لكل بيئة من مجلد دوال Supabase (Edge Functions).

للعنوان العام عبر HTTPS، ضع وكيل TLS المرجعي (أو nginx أو Caddy) أمام 127.0.0.1:8787 بشهادة حقيقية، كما يصف دليل النشر على خادم. لا تفتح في الجدار الناري إلا SSH و80 و443، واسمح بالمسارين من الحاويات إلى الخادم اللذين يحتاجهما Studio وEdge Functions.

ماذا بعد

عدّل على GitHub