Руководство по установке

Установите 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-адрес вашего сервера:

    ВниманиеК моменту запуска установки (шаг 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 : Подключитесь по 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. Теперь вы можете создавать пользователей, телефоны и линии.

Нужна помощь?

Наша команда может сопровождать вас во время установки или выполнить её за вас.