Інструкція зі встановлення

Встановіть 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. Тепер ви можете створювати користувачів, телефони та лінії.

Потрібна допомога?

Наша команда може супроводжувати вас під час встановлення або виконати його замість вас.