Installatiehandleiding

MaxiPBX op uw server installeren

Tien stappen, van de domeinnaam van uw PBX tot uw eerste toegang tot de interface. Eerst bereidt u de FQDN en de firewall voor, daarna genereert het Control Plane een uniek script dat u via SSH uitvoert, en ten slotte neemt een webwizard de configuratie over.

Voordat u begint

  • Een vers geïnstalleerde Debian 13-server, zonder andere diensten of toepassingen.
  • SSH-toegang met het account root (of een account dat root kan worden).
  • Een domeinnaam waarvan u de DNS-zone beheert, om de FQDN van uw PBX aan te maken (bijvoorbeeld pbx.yourdomain.com).
  • Een account op het MaxiPBX Control Plane, via my.maxipbx.com.
  • Toegang tot de firewall of router vóór de server, om de vereiste poorten te openen.
Vóór de installatie

Het netwerk voorbereiden

  1. Stap 1 : Maak de FQDN van uw server aan

    Geef uw PBX allereerst een volledig gekwalificeerde domeinnaam (FQDN), bijvoorbeeld pbx.yourdomain.com. Laat deze naam in de DNS-zone van uw domein verwijzen naar het IP-adres van uw server:

    Let opDe FQDN moet al naar uw server verwijzen op het moment dat u de installatie start (stap 8). Maak deze als eerste aan.

    NaamTypeWaarde
    pbx.yourdomain.com A IPv4-adres van uw serverVerplicht
    pbx.yourdomain.com AAAA IPv6-adres van uw serverAls uw server een IPv6-adres heeft

    TipHet kan enkele minuten duren voordat een DNS-wijziging is doorgevoerd. Om te controleren of de naam met het IP-adres van uw server antwoordt, voert u vanaf uw computer „ping pbx.yourdomain.com” uit.

  2. Stap 2 : Open de firewallpoorten

    De PBX heeft een eigen firewall, die precies de poorten opent die nodig zijn. Staat er een firewall of router vóór (firewall van de hostingprovider, bedrijfsrouter, internetmodem), open daarop dan alle onderstaande poorten, van buitenaf naar de PBX.

    Let opPoort 8443 TCP is alleen nodig tijdens de installatie: deze wordt gebruikt door de installatiewizard (stap 10). Open de poort voordat u de installatie start en sluit hem weer zodra de PBX geactiveerd is: hij is dan niet meer nodig.

    PoortProtocolDienstWaarvoor dient het
    8443 Alleen tijdens de installatie TCP Wizard Installatiewizard (stap 10). Weer sluiten zodra de PBX geactiveerd is
    80 TCP Nginx Provisioning van toestellen via HTTP, vernieuwing van het Let's Encrypt-certificaat
    443 TCP Nginx Webinterface, API, mobiele en desktopapps, webtelefoon (WebRTC), HTTPS-provisioning
    5060 UDP + TCP Kamailio SIP: toestellen, softphones, trunks van providers
    5061 TCP Kamailio Versleutelde SIP (TLS), ECDSA-certificaat
    5062 TCP Kamailio Versleutelde SIP (TLS), RSA-certificaat voor toestellen die ECDSA niet ondersteunen
    30000-40000 UDP rtpengine Spraak (RTP) van alle gesprekken: zonder deze poorten geen geluid
    3478-3479 UDP + TCP coturn STUN/TURN: geluid van de apps en de webtelefoon achter NAT
    5349-5350 UDP + TCP coturn Versleutelde TURN (TLS), dezelfde rol op restrictieve netwerken
    389 TCP MaxiPBX API LDAP-telefoonboek voor de toestellen
    10389 TCP MaxiPBX API LDAP-telefoonboek op een alternatieve poort, voor bepaalde modellen
    22 TCP SSH Beheer en onderhoud op afstand door MaxiPBX. Kan worden beperkt tot onze IP-adressen

    TipStaat de PBX achter NAT (privé-IP-adres), stel dan voor deze volledige lijst port forwarding in naar het interne IP-adres, met hetzelfde RTP-bereik 30000-40000 UDP.

In het Control Plane

Uw installatiesleutel genereren

  1. Stap 3 : Meld u aan bij het Control Plane

    Open my.maxipbx.com in uw browser en meld u aan met uw account. Via het Control Plane beheert u uw volledige PBX-bestand.

    Control Plane openen
  2. Stap 4 : Open de lijst met uw PBX’s

    Ga in het menu naar „PBX-bestand” en klik vervolgens op „PBX”. Daar ziet u alle PBX’s die al aan uw account gekoppeld zijn.

  3. Stap 5 : Genereer een installatiesleutel

    Klik op „Installatiesleutel genereren”. Deze sleutel koppelt de toekomstige server aan uw account: na de installatie verschijnt hij direct in uw bestand.

  4. Stap 6 : Toon en kopieer het installatiescript

    Toon het installatiescript en kopieer het volledig. Het bevat al uw sleutel: u hoeft er niets aan te wijzigen.

    Let opHet script bevat een sleutel die specifiek is voor uw account. Deel het niet en publiceer het nergens.

Op uw server

De installatie starten

  1. Stap 7 : Maak via SSH verbinding met het account root

    Maak vanuit een terminal (of een client zoals PuTTY onder Windows) met het account root verbinding met uw gloednieuwe Debian 13-server. Vervang YOUR_IP door het IP-adres van uw server.

    ssh root@YOUR_IP

    TipBent u met een ander account aangemeld, schakel dan vóór het vervolg over naar root met het commando „su -” of „sudo -i”.

  2. Stap 8 : Plak het script en bevestig

    Plak het in stap 6 gekopieerde installatiescript in de terminal en druk vervolgens op Enter.

  3. Stap 9 : Laat de installatie doorlopen

    De voortgang van de installatie wordt doorlopend op het scherm weergegeven. Laat de installatie volledig doorlopen zonder iets aan te raken.

    Let opSluit de terminal niet en verbreek de SSH-verbinding niet tijdens de installatie.

In uw browser

De configuratie voltooien

  1. Stap 10 : Open de installatiewizard

    Aan het einde van de installatie toont de terminal het adres van uw PBX in de onderstaande vorm. Open dit in uw browser en volg de installatiewizard: deze begeleidt u bij de initiële configuratie.

    https://YOUR_IP:8443

    TipToont uw browser bij deze eerste toegang een beveiligingswaarschuwing over het certificaat, dan kunt u doorgaan naar de site om de wizard te starten.

    Hulp nodig?Neem bij twijfel tijdens de wizard gerust contact op met uw MaxiPBX-resellerpartner: die staat klaar om u te ondersteunen.

Uw PBX is geïnstalleerd

Zodra de wizard is voltooid, is uw PBX klaar voor gebruik en gekoppeld aan uw bestand in het Control Plane. U kunt nu uw gebruikers, toestellen en lijnen aanmaken.

Hulp nodig bij de installatie?

Ons team kan u tijdens de installatie begeleiden of deze voor u uitvoeren.