انسٹالیشن گائیڈ

MaxiPBX کو اپنے سرور پر انسٹال کریں

دس مراحل، آپ کے PBX کے ڈومین نام سے لے کر انٹرفیس تک آپ کی پہلی رسائی تک۔ پہلے آپ FQDN اور فائر وال تیار کرتے ہیں، پھر Control Plane ایک منفرد اسکرپٹ تیار کرتا ہے جسے آپ SSH کے ذریعے چلاتے ہیں، اور آخر میں ایک ویب وزرڈ کنفیگریشن سنبھال لیتا ہے۔

شروع کرنے سے پہلے

  • ایک نیا انسٹال شدہ Debian 13 سرور، جس پر کوئی دوسری سروس یا ایپلیکیشن موجود نہ ہو۔
  • root اکاؤنٹ کے ساتھ SSH رسائی (یا ایسا اکاؤنٹ جو root بن سکے)۔
  • ایک ڈومین نام جس کے DNS زون کا انتظام آپ کے پاس ہو، تاکہ آپ اپنے PBX کا FQDN بنا سکیں (مثال کے طور پر pbx.yourdomain.com)۔
  • MaxiPBX Control Plane پر ایک اکاؤنٹ، my.maxipbx.com پر۔
  • سرور کے سامنے موجود فائر وال یا راؤٹر تک رسائی، تاکہ مطلوبہ پورٹس کھولے جا سکیں۔
انسٹالیشن سے پہلے

نیٹ ورک تیار کریں

  1. مرحلہ 1 : اپنے سرور کا FQDN بنائیں

    سب سے پہلے اپنے PBX کو ایک مکمل ڈومین نام (FQDN) دیں، مثال کے طور پر pbx.yourdomain.com۔ اپنے ڈومین کے DNS زون میں اس نام کو اپنے سرور کے IP ایڈریس کی طرف پوائنٹ کریں:

    احتیاطانسٹالیشن شروع کرتے وقت (مرحلہ 8) FQDN کا پہلے سے آپ کے سرور کی طرف پوائنٹ کرنا ضروری ہے۔ اسے سب سے پہلے بنائیں۔

    نامقسمقدر
    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 : root اکاؤنٹ کے ساتھ SSH کے ذریعے کنیکٹ کریں

    ٹرمینل سے (یا Windows پر PuTTY جیسے کلائنٹ سے) root اکاؤنٹ کے ساتھ اپنے نئے Debian 13 سرور سے کنیکٹ کریں۔ YOUR_IP کی جگہ اپنے سرور کا IP ایڈریس درج کریں۔

    ssh root@YOUR_IP

    مشورہاگر آپ کسی دوسرے اکاؤنٹ سے لاگ اِن ہیں، تو آگے بڑھنے سے پہلے “su -” یا “sudo -i” کمانڈ کے ذریعے root پر سوئچ کریں۔

  2. مرحلہ 8 : اسکرپٹ پیسٹ کریں اور Enter دبائیں

    مرحلہ 6 میں کاپی کیا گیا انسٹالیشن اسکرپٹ ٹرمینل میں پیسٹ کریں، پھر Enter دبائیں۔

  3. مرحلہ 9 : انسٹالیشن کو چلنے دیں

    انسٹالیشن کی پیش رفت ساتھ ساتھ اسکرین پر دکھائی دیتی ہے۔ کسی چیز کو چھیڑے بغیر اسے مکمل ہونے تک چلنے دیں۔

    احتیاطانسٹالیشن کے دوران ٹرمینل بند نہ کریں اور نہ ہی SSH کنکشن منقطع کریں۔

اپنے براؤزر میں

کنفیگریشن مکمل کریں

  1. مرحلہ 10 : انسٹالیشن وزرڈ کھولیں

    انسٹالیشن کے اختتام پر ٹرمینل آپ کے PBX کا ایڈریس نیچے دکھائی گئی شکل میں ظاہر کرتا ہے۔ اسے اپنے براؤزر میں کھولیں، پھر انسٹالیشن وزرڈ کی پیروی کریں: یہ ابتدائی کنفیگریشن میں آپ کی رہنمائی کرتا ہے۔

    https://YOUR_IP:8443

    مشورہاگر اس پہلی وزٹ پر آپ کا براؤزر سرٹیفکیٹ کے بارے میں سکیورٹی انتباہ دکھائے، تو آپ وزرڈ شروع کرنے کے لیے سائٹ پر آگے بڑھ سکتے ہیں۔

    مدد درکار ہے؟اگر وزرڈ استعمال کرتے ہوئے آپ کو کوئی شک ہو، تو بلا جھجک اپنے MaxiPBX ری سیلر پارٹنر سے رابطہ کریں: وہ آپ کی معاونت کے لیے موجود ہیں۔

آپ کا PBX انسٹال ہو گیا ہے

وزرڈ مکمل ہونے کے بعد آپ کا PBX تیار ہے اور Control Plane میں آپ کے بیڑے سے منسلک ہے۔ اب آپ اپنے صارفین، فونز اور لائنیں بنا سکتے ہیں۔

مدد درکار ہے؟

ہماری ٹیم انسٹالیشن کے دوران آپ کی معاونت کر سکتی ہے یا آپ کی جگہ یہ کام خود انجام دے سکتی ہے۔