Inštalačná príručka

Inštalácia MaxiPBX na váš server

Desať krokov od doménového mena vašej PBX až po prvý prístup do rozhrania. Najprv pripravíte FQDN a firewall, potom Control Plane vygeneruje jedinečný skript, ktorý spustíte cez SSH, a napokon konfiguráciu prevezme webový sprievodca.

Skôr než začnete

  • Čerstvo nainštalovaný server Debian 13 bez akýchkoľvek ďalších služieb či aplikácií.
  • Prístup cez SSH s účtom root (alebo s účtom, ktorý sa môže stať rootom).
  • Doménové meno, ktorého zónu DNS spravujete, na vytvorenie FQDN vašej PBX (napríklad pbx.yourdomain.com).
  • Účet v MaxiPBX Control Plane na adrese my.maxipbx.com.
  • Prístup k firewallu alebo routeru umiestnenému pred serverom, aby ste mohli otvoriť potrebné porty.
Pred inštaláciou

Príprava siete

  1. Krok 1 : Vytvorte FQDN servera

    Najprv prideľte svojej PBX plne kvalifikované doménové meno (FQDN), napríklad pbx.yourdomain.com. V zóne DNS vašej domény nasmerujte toto meno na IP adresu servera:

    UpozornenieFQDN musí na váš server smerovať už v okamihu spustenia inštalácie (krok 8). Vytvorte ho ako prvé.

    NázovTypHodnota
    pbx.yourdomain.com A IPv4 adresa vášho serveraPovinné
    pbx.yourdomain.com AAAA IPv6 adresa vášho serveraAk má server adresu IPv6

    TipRozšírenie zmeny DNS môže trvať niekoľko minút. Ak chcete overiť, že meno odpovedá IP adresou vášho servera, spustite zo svojho počítača „ping pbx.yourdomain.com“.

  2. Krok 2 : Otvorte porty vo firewalle

    PBX má vlastný firewall, ktorý otvára presne tie porty, ktoré potrebuje. Ak je pred ňou umiestnený firewall alebo router (firewall poskytovateľa hostingu, firemný router, internetový modem), otvorte na ňom všetky nižšie uvedené porty, a to z vonkajšej siete smerom k PBX.

    UpozorneniePort 8443 TCP je potrebný iba počas inštalácie: používa ho inštalačný sprievodca (krok 10). Otvorte ho pred spustením inštalácie a po aktivácii PBX ho opäť zatvorte: už nie je potrebný.

    PortProtokolSlužbaNa čo slúži
    8443 Iba počas inštalácie TCP Sprievodca Inštalačný sprievodca (krok 10). Po aktivácii PBX ho opäť zatvorte
    80 TCP Nginx Provisioning telefónov cez HTTP, obnova certifikátu Let's Encrypt
    443 TCP Nginx Webové rozhranie, API, mobilné a desktopové aplikácie, webový telefón (WebRTC), provisioning cez HTTPS
    5060 UDP + TCP Kamailio SIP: telefóny, softfóny, trunky operátorov
    5061 TCP Kamailio Šifrovaný SIP (TLS), certifikát ECDSA
    5062 TCP Kamailio Šifrovaný SIP (TLS), certifikát RSA pre telefóny, ktoré nepodporujú ECDSA
    30000-40000 UDP rtpengine Hlas (RTP) všetkých hovorov: bez týchto portov nie je počuť zvuk
    3478-3479 UDP + TCP coturn STUN/TURN: zvuk aplikácií a webového telefónu za NAT
    5349-5350 UDP + TCP coturn Šifrovaný TURN (TLS), rovnaká úloha v reštriktívnych sieťach
    389 TCP API MaxiPBX Adresár LDAP pre telefóny
    10389 TCP API MaxiPBX Adresár LDAP na alternatívnom porte, pre niektoré modely
    22 TCP SSH Vzdialená správa a údržba zo strany MaxiPBX. Možno obmedziť na naše IP adresy

    TipAk je PBX za NAT (súkromná IP adresa), nastavte presmerovanie všetkých portov z tohto zoznamu na jej internú IP adresu vrátane rovnakého rozsahu RTP 30000-40000 UDP.

V Control Plane

Vygenerujte inštalačný kľúč

  1. Krok 3 : Prihláste sa do Control Plane

    Otvorte v prehliadači my.maxipbx.com a prihláste sa svojím účtom. V Control Plane spravujete celý svoj park PBX.

    Otvoriť Control Plane
  2. Krok 4 : Otvorte zoznam svojich PBX

    V ponuke prejdite do sekcie „Park PBX“ a potom kliknite na „PBX“. Zobrazia sa všetky PBX, ktoré sú už priradené k vášmu účtu.

  3. Krok 5 : Vygenerujte inštalačný kľúč

    Kliknite na „Vygenerovať inštalačný kľúč“. Tento kľúč prepojí budúci server s vaším účtom: po inštalácii sa server zobrazí priamo vo vašom parku.

  4. Krok 6 : Zobrazte a skopírujte inštalačný skript

    Zobrazte inštalačný skript a skopírujte ho celý. Skript už obsahuje váš kľúč: nemusíte v ňom nič meniť.

    UpozornenieSkript obsahuje kľúč špecifický pre váš účet. Nezdieľajte ho a nikde ho nezverejňujte.

Na vašom serveri

Spustite inštaláciu

  1. Krok 7 : Pripojte sa cez SSH s účtom root

    Z terminálu (alebo z klienta, ako je PuTTY vo Windows) sa pripojte k svojmu novému serveru Debian 13 s účtom root. Nahraďte YOUR_IP IP adresou vášho servera.

    ssh root@YOUR_IP

    TipAk ste prihlásení iným účtom, pred pokračovaním sa prepnite na root príkazom „su -“ alebo „sudo -i“.

  2. Krok 8 : Vložte skript a potvrďte

    Vložte do terminálu inštalačný skript skopírovaný v kroku 6 a stlačte Enter.

  3. Krok 9 : Nechajte inštaláciu prebehnúť

    Priebeh inštalácie sa postupne zobrazuje na obrazovke. Nechajte ju dobehnúť až do konca a do ničoho nezasahujte.

    UpozorneniePočas inštalácie nezatvárajte terminál a neprerušujte pripojenie SSH.

Vo vašom prehliadači

Dokončite konfiguráciu

  1. Krok 10 : Otvorte inštalačného sprievodcu

    Na konci inštalácie terminál zobrazí adresu vašej PBX v nižšie uvedenom tvare. Otvorte ju v prehliadači a postupujte podľa inštalačného sprievodcu: prevedie vás počiatočnou konfiguráciou.

    https://YOUR_IP:8443

    TipAk prehliadač pri tomto prvom prístupe zobrazí bezpečnostné upozornenie týkajúce sa certifikátu, môžete pokračovať na stránku a spustiť sprievodcu.

    Potrebujete pomoc?Ak máte počas sprievodcu akékoľvek pochybnosti, neváhajte kontaktovať svojho partnerského predajcu MaxiPBX: je tu na to, aby vám pomohol.

Vaša PBX je nainštalovaná

Po dokončení sprievodcu je vaša PBX pripravená a priradená k vášmu parku v Control Plane. Teraz môžete vytvoriť používateľov, telefóny a linky.

Potrebujete pomoc?

Náš tím vám môže s inštaláciou pomôcť alebo ju za vás úplne vykonať.