מדריך התקנה

התקינו את 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: טלפונים, טלפונים רכים, טראנקים של ספקים
    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. כעת ניתן ליצור משתמשים, טלפונים וקווים.

זקוקים לעזרה?

הצוות שלנו יכול ללוות אתכם במהלך ההתקנה או לבצע אותה עבורכם.