Centrifugo

حول Centrifugo

ما يُثبَّت

جاهز عند تشغيل الخادم

أنظمة التشغيل المتوافقة

توزيعات Linux حسب اختيارك

التطبيق

Centrifugo

المنظومة التقنية

DockerGoCentrifugo

الحد الأدنى من RAM

1 غيغابايت على الأقل

الحد الأدنى من CPU

1 vCPU

المنفذ الافتراضي

8113

الوصول

root عبر SSH

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

• اتصالات فورية — WebSocket، مع حزم رسمية للعملاء بلغات JavaScript وDart/Flutter وSwift وJava/Android وGo وPython.
• واجهة نشر — يكفي طلب HTTP واحد مع الترويسة X-API-Key لإرسال رسالة إلى قناة، من أي لغة.
• مصادقة بالرموز — يوقّع خادمك الخلفي رموز JWT ‏(HS256)، ويُرفض كل اتصال بلا رمز صالح.
• قنوات واشتراكات من جهة الخادم — يمكن أن يحمل رمز المستخدم قائمة قنواته، دون شيفرة إضافية لدى العميل.
• لوحة إدارة — حالة العقدة وعدد العملاء المتصلين وإرسال أوامر الواجهة من المتصفح، محمية بكلمة مرور.
• خفيف — ملف Go تنفيذي واحد، وبضع عشرات من الميغابايت من الذاكرة في وضع الخمول.

متى تستخدم هذا الحل؟

الدليل

نشر Centrifugo على خادم VPS الخاص بك

1. 1

   إنشاء الخادم واختيار العنوان

   اطلب خادمًا افتراضيًا بنظام Ubuntu 24.04؛ تكفي ذاكرة 1 غيغابايت للبدء. يتطلب Centrifugo نطاقًا: تتصل به المتصفحات عبر wss:// ويستدعي خادمك الخلفي واجهته عبر HTTPS، على اسم ثابت. يُفتح على نطاق فرعي من أحد نطاقاتك، أو على النطاق الفرعي المجاني للخادم (centrifugo.{dns_slug}‎.servorbit-dns.com) مع HTTPS. لا حاجة لشراء اسم نطاق.

2. 2

   تثبيت Centrifugo من المتجر

   من مساحة العميل، اختر Centrifugo وحدد العنوان ثم انقر على «تثبيت». ينشر السكربت الحاوية الرسمية، ويولّد كلمة مرور اللوحة ومفتاح واجهة الخادم ومفتاح توقيع الرموز، ثم يضبط الوكيل العكسي nginx عبر HTTPS مع دعم WebSocket.

3. 3

   تسجيل الدخول لأول مرة

   افتح https://your-domain: تطلب لوحة الإدارة كلمة مرور. أدخل كلمة المرور المعروضة في مساحة العميل. تعرض الصفحة الرئيسية إصدار العقدة وعدد العملاء المتصلين.

4. 4

   استرجاع مفاتيح الخادم الخلفي

   اتصل بالخادم عبر SSH واقرأ /opt/centrifugo/.env: ‏ENCRYPTION_KEY هو مفتاح واجهة الخادم (الترويسة X-API-Key) وENCRYPTION_KEY_HEX64 هو مفتاح HMAC الذي يوقّع رموز الاتصال. احفظهما في أسرار تطبيقك، ولا تضعهما أبدًا في شيفرة تُرسل إلى المتصفح.

5. 5

   النشر وربط العملاء

   يوقّع خادمك الخلفي رمز JWT بخوارزمية HS256 ‏(sub = معرّف المستخدم، channels = القنوات المتابَعة) ويسلّمه إلى المتصفح، الذي يتصل بحزمة centrifuge على wss://your-domain/connection/websocket. أضف أصل موقعك إلى CENTRIFUGO_CLIENT_ALLOWED_ORIGINS في /opt/centrifugo/docker-compose.yml، وأعد التشغيل بـ docker compose up -d، ثم انشر بطلب POST إلى https://your-domain/api/publish.