دليل التثبيت

ثبّت MaxiPBX على خادمك

عشر خطوات، من اسم نطاق PBX الخاص بك حتى أول تسجيل دخول إلى الواجهة. تبدأ بتجهيز FQDN والجدار الناري، ثم يُنشئ Control Plane سكربتًا فريدًا تشغّله عبر SSH، وبعد ذلك يتولى معالج ويب عملية الإعداد.

قبل البدء

  • خادم Debian 13 مثبّت حديثًا، دون أي خدمة أو تطبيق آخر عليه.
  • وصول عبر SSH بحساب root (أو بحساب يمكنه الحصول على صلاحيات root).
  • اسم نطاق تدير منطقة DNS الخاصة به، لإنشاء FQDN الخاص بـ PBX (مثل pbx.yourdomain.com).
  • حساب على MaxiPBX Control Plane، على العنوان my.maxipbx.com.
  • إمكانية الوصول إلى الجدار الناري أو الموجّه الموجود أمام الخادم، لفتح المنافذ المطلوبة.
قبل التثبيت

تجهيز الشبكة

  1. الخطوة 1 : أنشئ FQDN لخادمك

    قبل كل شيء، امنح PBX الخاص بك اسم نطاق مؤهلًا بالكامل (FQDN)، مثل pbx.yourdomain.com. في منطقة DNS الخاصة بنطاقك، وجّه هذا الاسم إلى عنوان IP الخاص بخادمك:

    تنبيهيجب أن يشير FQDN إلى خادمك مسبقًا عند بدء التثبيت (الخطوة 8). أنشئه أولًا.

    الاسمالنوعالقيمة
    pbx.yourdomain.com A عنوان IPv4 الخاص بخادمكإلزامي
    pbx.yourdomain.com AAAA عنوان IPv6 الخاص بخادمكإذا كان لخادمك عنوان IPv6

    نصيحةقد يستغرق انتشار تغيير DNS بضع دقائق. للتحقق من أن الاسم يُحلّ إلى عنوان IP الخاص بخادمك، نفّذ الأمر «ping pbx.yourdomain.com» من حاسوبك.

  2. الخطوة 2 : افتح منافذ الجدار الناري

    يمتلك PBX جدارًا ناريًا خاصًا به يفتح المنافذ التي يحتاجها بالضبط. إذا كان أمامه جدار ناري أو موجّه (جدار ناري لدى مزوّد الاستضافة، أو موجّه الشركة، أو جهاز الإنترنت)، فافتح عليه جميع المنافذ أدناه، من الخارج نحو PBX.

    تنبيهالمنفذ 8443 TCP مطلوب أثناء التثبيت فقط: إذ يستخدمه معالج التثبيت (الخطوة 10). افتحه قبل بدء التثبيت، ثم أغلقه مجددًا بعد تفعيل PBX: فلن تعود هناك حاجة إليه.

    المنفذالبروتوكولالخدمةالاستخدام
    8443 أثناء التثبيت فقط TCP المعالج معالج التثبيت (الخطوة 10). أغلقه مجددًا بعد تفعيل PBX
    80 TCP Nginx التهيئة التلقائية للهواتف عبر HTTP، وتجديد شهادات Let's Encrypt
    443 TCP Nginx واجهة الويب، وAPI، وتطبيقات الهاتف المحمول وسطح المكتب، وهاتف الويب (WebRTC)، والتهيئة التلقائية عبر HTTPS
    5060 UDP + TCP Kamailio SIP: الهواتف، والهواتف البرمجية، وخطوط المشغّلين (Trunks)
    5061 TCP Kamailio SIP مشفّر (TLS)، شهادة ECDSA
    5062 TCP Kamailio SIP مشفّر (TLS)، شهادة RSA للهواتف التي لا تدعم ECDSA
    30000-40000 UDP rtpengine الصوت (RTP) لجميع المكالمات: بدون هذه المنافذ لا يوجد صوت
    3478-3479 UDP + TCP coturn STUN/TURN: الصوت للتطبيقات وهاتف الويب خلف NAT
    5349-5350 UDP + TCP coturn TURN مشفّر (TLS)، الدور نفسه على الشبكات المقيّدة
    389 TCP MaxiPBX API دليل LDAP للهواتف
    10389 TCP MaxiPBX API دليل LDAP على منفذ بديل، لبعض الطرازات
    22 TCP SSH الإدارة والصيانة عن بُعد من قِبل MaxiPBX. يمكن قصر الوصول على عناوين IP الخاصة بنا

    نصيحةإذا كان PBX خلف NAT (عنوان IP خاص)، فقم بإعداد إعادة توجيه المنافذ لهذه القائمة كاملة نحو عنوان IP الداخلي الخاص به، مع نطاق RTP نفسه 30000-40000 UDP.

في Control Plane

أنشئ مفتاح التثبيت

  1. الخطوة 3 : سجّل الدخول إلى Control Plane

    افتح my.maxipbx.com في متصفحك وسجّل الدخول بحسابك. في Control Plane تدير مجموعة PBX الخاصة بك بالكامل.

    فتح Control Plane
  2. الخطوة 4 : افتح قائمة PBX الخاصة بك

    من القائمة، انتقل إلى «مجموعة PBX»، ثم انقر على «PBX». ستجد هناك جميع أجهزة PBX المرتبطة بحسابك بالفعل.

  3. الخطوة 5 : أنشئ مفتاح تثبيت

    انقر على «إنشاء مفتاح تثبيت». يربط هذا المفتاح الخادم المستقبلي بحسابك: فبعد تثبيته، سيظهر مباشرةً ضمن مجموعتك.

  4. الخطوة 6 : اعرض سكربت التثبيت وانسخه

    اعرض سكربت التثبيت وانسخه بالكامل. فهو يحتوي مسبقًا على مفتاحك: ولا حاجة إلى تعديل أي شيء فيه.

    تنبيهيحتوي السكربت على مفتاح خاص بحسابك. لا تشاركه مع أحد ولا تنشره في أي مكان.

على خادمك

شغّل التثبيت

  1. الخطوة 7 : اتصل عبر SSH بحساب root

    من طرفية (أو من عميل مثل PuTTY على Windows)، اتصل بخادم Debian 13 الجديد بحساب root. استبدل YOUR_IP بعنوان IP الخاص بخادمك.

    ssh root@YOUR_IP

    نصيحةإذا كنت مسجّلًا الدخول بحساب آخر، فانتقل إلى root باستخدام الأمر «su -» أو «sudo -i» قبل المتابعة.

  2. الخطوة 8 : الصق السكربت واضغط Enter

    الصق سكربت التثبيت الذي نسخته في الخطوة 6 في الطرفية، ثم اضغط Enter.

  3. الخطوة 9 : اترك التثبيت يكتمل

    يُعرض تقدّم التثبيت على الشاشة أولًا بأول. اتركه يكتمل حتى النهاية دون أي تدخل.

    تنبيهلا تغلق الطرفية ولا تقطع اتصال SSH أثناء التثبيت.

في متصفحك

أكمل الإعداد

  1. الخطوة 10 : افتح معالج التثبيت

    في نهاية التثبيت، تعرض الطرفية عنوان PBX الخاص بك بالصيغة الموضّحة أدناه. افتحه في متصفحك، ثم اتبع معالج التثبيت: فهو يرشدك خلال الإعداد الأولي.

    https://YOUR_IP:8443

    نصيحةإذا عرض متصفحك تحذيرًا أمنيًا بشأن الشهادة في هذه الزيارة الأولى، فيمكنك المتابعة إلى الموقع لتشغيل المعالج.

    هل تحتاج إلى مساعدة؟إذا راودك أي شك أثناء استخدام المعالج، فلا تتردد في التواصل مع شريكك الموزّع لـ MaxiPBX: فهو موجود لمساعدتك.

تم تثبيت PBX الخاص بك

بعد اكتمال المعالج، يصبح PBX الخاص بك جاهزًا ومرتبطًا بمجموعتك في Control Plane. يمكنك الآن إنشاء المستخدمين والهواتف والخطوط.

هل تحتاج إلى مساعدة؟

يمكن لفريقنا مرافقتك أثناء التثبيت أو تولّيه نيابةً عنك.