Ръководство за инсталиране

Инсталирайте 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. Вече можете да създавате потребители, телефони и линии.

Нуждаете се от помощ?

Нашият екип може да ви съдейства по време на инсталирането или да го извърши вместо вас.