Instalační příručka

Instalace MaxiPBX na váš server

Deset kroků od doménového jména vaší PBX až po první přístup do rozhraní. Nejprve připravíte FQDN a firewall, poté Control Plane vygeneruje jedinečný skript, který spustíte přes SSH, a nakonec konfiguraci převezme webový průvodce.

Než začnete

  • Čerstvě nainstalovaný server Debian 13 bez jakýchkoli dalších služeb či aplikací.
  • Přístup přes SSH s účtem root (nebo s účtem, který se může stát rootem).
  • Doménové jméno, jehož zónu DNS spravujete, pro vytvoření FQDN vaší PBX (například pbx.yourdomain.com).
  • Účet v MaxiPBX Control Plane na adrese my.maxipbx.com.
  • Přístup k firewallu nebo routeru umístěnému před serverem, abyste mohli otevřít potřebné porty.
Před instalací

Příprava sítě

  1. Krok 1 : Vytvořte FQDN serveru

    Nejprve přidělte své PBX plně kvalifikované doménové jméno (FQDN), například pbx.yourdomain.com. V zóně DNS vaší domény nasměrujte toto jméno na IP adresu serveru:

    UpozorněníFQDN musí na váš server směřovat již v okamžiku spuštění instalace (krok 8). Vytvořte jej jako první.

    NázevTypHodnota
    pbx.yourdomain.com A IPv4 adresa vašeho serveruPovinné
    pbx.yourdomain.com AAAA IPv6 adresa vašeho serveruPokud má server adresu IPv6

    TipRozšíření změny DNS může trvat několik minut. Chcete-li ověřit, že jméno odpovídá IP adresou vašeho serveru, spusťte ze svého počítače „ping pbx.yourdomain.com“.

  2. Krok 2 : Otevřete porty ve firewallu

    PBX má vlastní firewall, který otevírá přesně ty porty, které potřebuje. Pokud je před ní umístěn firewall nebo router (firewall poskytovatele hostingu, firemní router, internetový modem), otevřete na něm všechny níže uvedené porty, a to z vnější sítě směrem k PBX.

    UpozorněníPort 8443 TCP je potřeba pouze během instalace: používá jej instalační průvodce (krok 10). Otevřete jej před spuštěním instalace a po aktivaci PBX jej opět uzavřete: již není potřeba.

    PortProtokolSlužbaK čemu slouží
    8443 Pouze během instalace TCP Průvodce Instalační průvodce (krok 10). Po aktivaci PBX jej opět uzavřete
    80 TCP Nginx Provisioning telefonů přes HTTP, obnova certifikátu Let's Encrypt
    443 TCP Nginx Webové rozhraní, API, mobilní a desktopové aplikace, webový telefon (WebRTC), provisioning přes HTTPS
    5060 UDP + TCP Kamailio SIP: telefony, softphony, trunky operátorů
    5061 TCP Kamailio Šifrovaný SIP (TLS), certifikát ECDSA
    5062 TCP Kamailio Šifrovaný SIP (TLS), certifikát RSA pro telefony, které nepodporují ECDSA
    30000-40000 UDP rtpengine Hlas (RTP) všech hovorů: bez těchto portů není slyšet zvuk
    3478-3479 UDP + TCP coturn STUN/TURN: zvuk aplikací a webového telefonu za NAT
    5349-5350 UDP + TCP coturn Šifrovaný TURN (TLS), stejná role v restriktivních sítích
    389 TCP API MaxiPBX Adresář LDAP pro telefony
    10389 TCP API MaxiPBX Adresář LDAP na alternativním portu, pro některé modely
    22 TCP SSH Vzdálená správa a údržba ze strany MaxiPBX. Lze omezit na naše IP adresy

    TipPokud je PBX za NAT (soukromá IP adresa), nastavte přesměrování všech portů z tohoto seznamu na její interní IP adresu, včetně stejného rozsahu RTP 30000-40000 UDP.

V Control Plane

Vygenerujte instalační klíč

  1. Krok 3 : Přihlaste se do Control Plane

    Otevřete v prohlížeči my.maxipbx.com a přihlaste se svým účtem. V Control Plane spravujete celý svůj park PBX.

    Otevřít Control Plane
  2. Krok 4 : Otevřete seznam svých PBX

    V nabídce přejděte do sekce „Park PBX“ a poté klikněte na „PBX“. Zobrazí se všechny PBX, které jsou již přiřazeny k vašemu účtu.

  3. Krok 5 : Vygenerujte instalační klíč

    Klikněte na „Vygenerovat instalační klíč“. Tento klíč propojí budoucí server s vaším účtem: po instalaci se server zobrazí přímo ve vašem parku.

  4. Krok 6 : Zobrazte a zkopírujte instalační skript

    Zobrazte instalační skript a zkopírujte jej celý. Skript již obsahuje váš klíč: nemusíte v něm nic měnit.

    UpozorněníSkript obsahuje klíč specifický pro váš účet. Nesdílejte jej a nikde jej nezveřejňujte.

Na vašem serveru

Spusťte instalaci

  1. Krok 7 : Připojte se přes SSH s účtem root

    Z terminálu (nebo z klienta, jako je PuTTY ve Windows) se připojte ke svému novému serveru Debian 13 s účtem root. Nahraďte YOUR_IP IP adresou vašeho serveru.

    ssh root@YOUR_IP

    TipPokud jste přihlášeni jiným účtem, přepněte se před pokračováním na root příkazem „su -“ nebo „sudo -i“.

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

    Vložte do terminálu instalační skript zkopírovaný v kroku 6 a stiskněte Enter.

  3. Krok 9 : Nechte instalaci proběhnout

    Průběh instalace se postupně zobrazuje na obrazovce. Nechte ji doběhnout až do konce a do ničeho nezasahujte.

    UpozorněníBěhem instalace nezavírejte terminál a nepřerušujte připojení SSH.

Ve vašem prohlížeči

Dokončete konfiguraci

  1. Krok 10 : Otevřete instalačního průvodce

    Na konci instalace terminál zobrazí adresu vaší PBX v níže uvedeném tvaru. Otevřete ji v prohlížeči a postupujte podle instalačního průvodce: provede vás počáteční konfigurací.

    https://YOUR_IP:8443

    TipPokud prohlížeč při tomto prvním přístupu zobrazí bezpečnostní varování týkající se certifikátu, můžete pokračovat na web a spustit průvodce.

    Potřebujete pomoc?Máte-li během průvodce jakékoli pochybnosti, neváhejte kontaktovat svého partnerského prodejce MaxiPBX: je tu proto, aby vám pomohl.

Vaše PBX je nainstalována

Po dokončení průvodce je vaše PBX připravena a přiřazena k vašemu parku v Control Plane. Nyní můžete vytvořit uživatele, telefony a linky.

Potřebujete pomoc?

Náš tým vám může s instalací pomoci nebo ji za vás zcela provést.