Installationsguide

Installera MaxiPBX på din server

Tio steg, från din PBX:s domännamn till din första inloggning i gränssnittet. Först förbereder du FQDN och brandvägg, sedan genererar Control Plane ett unikt skript som du kör via SSH, och slutligen tar en webbguide över konfigurationen.

Innan du börjar

  • En nyinstallerad Debian 13-server utan andra tjänster eller program.
  • SSH-åtkomst med root-kontot (eller ett konto som kan bli root).
  • Ett domännamn vars DNS-zon du hanterar, för att skapa din PBX:s FQDN (till exempel pbx.yourdomain.com).
  • Ett konto i MaxiPBX Control Plane, på my.maxipbx.com.
  • Åtkomst till brandväggen eller routern framför servern, för att öppna de portar som krävs.
Före installationen

Förbered nätverket

  1. Steg 1 : Skapa serverns FQDN

    Ge först och främst din PBX ett fullständigt kvalificerat domännamn (FQDN), till exempel pbx.yourdomain.com. Låt detta namn peka på serverns IP-adress i domänens DNS-zon:

    ObserveraFQDN måste redan peka på din server när du startar installationen (steg 8). Skapa det först.

    NamnTypVärde
    pbx.yourdomain.com A Serverns IPv4-adressObligatorisk
    pbx.yourdomain.com AAAA Serverns IPv6-adressOm servern har en IPv6-adress

    TipsEn DNS-ändring kan ta några minuter att slå igenom. Kontrollera att namnet pekar på serverns IP-adress genom att köra ”ping pbx.yourdomain.com” från din dator.

  2. Steg 2 : Öppna portarna i brandväggen

    PBX:en har en egen brandvägg som öppnar exakt de portar den behöver. Om det finns en brandvägg eller router framför den (värdleverantörens brandvägg, företagets router, internetbox) ska alla portar nedan öppnas i den, utifrån och in till PBX:en.

    ObserveraPort 8443 TCP behövs endast under installationen: den används av installationsguiden (steg 10). Öppna den innan du startar installationen och stäng den igen när PBX:en har aktiverats: den behövs då inte längre.

    PortProtokollTjänstAnvändning
    8443 Endast under installationen TCP Guide Installationsguide (steg 10). Stängs igen när PBX:en har aktiverats
    80 TCP Nginx Provisionering av telefoner via HTTP, förnyelse av Let's Encrypt-certifikat
    443 TCP Nginx Webbgränssnitt, API, mobil- och datorappar, webbtelefon (WebRTC), HTTPS-provisionering
    5060 UDP + TCP Kamailio SIP: telefoner, softphones, operatörstrunkar
    5061 TCP Kamailio Krypterad SIP (TLS), ECDSA-certifikat
    5062 TCP Kamailio Krypterad SIP (TLS), RSA-certifikat för telefoner som inte stöder ECDSA
    30000-40000 UDP rtpengine Tal (RTP) för alla samtal: utan dessa portar blir det inget ljud
    3478-3479 UDP + TCP coturn STUN/TURN: ljud för apparna och webbtelefonen bakom NAT
    5349-5350 UDP + TCP coturn Krypterad TURN (TLS), samma funktion i restriktiva nätverk
    389 TCP MaxiPBX API LDAP-katalog för telefoner
    10389 TCP MaxiPBX API LDAP-katalog på en alternativ port, för vissa modeller
    22 TCP SSH Fjärradministration och underhåll av MaxiPBX. Kan begränsas till våra IP-adresser

    TipsOm PBX:en står bakom NAT (privat IP-adress) ska du konfigurera portvidarebefordran av hela denna lista till dess interna IP-adress, med samma RTP-intervall 30000-40000 UDP.

I Control Plane

Generera din installationsnyckel

  1. Steg 3 : Logga in i Control Plane

    Öppna my.maxipbx.com i webbläsaren och logga in med ditt konto. I Control Plane hanterar du hela din PBX-flotta.

    Öppna Control Plane
  2. Steg 4 : Öppna din lista över PBX:er

    Gå till ”PBX-flotta” i menyn och klicka sedan på ”PBX”. Där ser du alla PBX:er som redan är kopplade till ditt konto.

  3. Steg 5 : Generera en installationsnyckel

    Klicka på ”Generera en installationsnyckel”. Nyckeln kopplar den blivande servern till ditt konto: när den har installerats visas den direkt i din flotta.

  4. Steg 6 : Visa och kopiera installationsskriptet

    Visa installationsskriptet och kopiera det i sin helhet. Det innehåller redan din nyckel: du behöver inte ändra något i det.

    ObserveraSkriptet innehåller en nyckel som är unik för ditt konto. Dela den inte och publicera den inte någonstans.

På din server

Kör installationen

  1. Steg 7 : Anslut via SSH med root-kontot

    Anslut från en terminal (eller en klient som PuTTY i Windows) till din helt nya Debian 13-server med root-kontot. Ersätt YOUR_IP med serverns IP-adress.

    ssh root@YOUR_IP

    TipsOm du är inloggad med ett annat konto, byt till root med kommandot ”su -” eller ”sudo -i” innan du fortsätter.

  2. Steg 8 : Klistra in skriptet och tryck på Enter

    Klistra in installationsskriptet som du kopierade i steg 6 i terminalen och tryck sedan på Enter.

  3. Steg 9 : Låt installationen slutföras

    Installationens förlopp visas löpande på skärmen. Låt den köra klart utan att röra något.

    ObserveraStäng inte terminalen och avbryt inte SSH-anslutningen under installationen.

I din webbläsare

Slutför konfigurationen

  1. Steg 10 : Öppna installationsguiden

    När installationen är klar visar terminalen din PBX:s adress i formatet nedan. Öppna den i webbläsaren och följ installationsguiden: den leder dig genom den inledande konfigurationen.

    https://YOUR_IP:8443

    TipsOm webbläsaren visar en säkerhetsvarning om certifikatet vid detta första besök kan du fortsätta till webbplatsen för att starta guiden.

    Behöver du hjälp?Om du är osäker på något medan du använder guiden är du välkommen att kontakta din MaxiPBX-återförsäljare: de finns där för att hjälpa dig.

Din PBX är installerad

När guiden har slutförts är din PBX klar och kopplad till din flotta i Control Plane. Du kan nu skapa dina användare, telefoner och linjer.

Behöver du hjälp?

Vårt team kan stödja dig under installationen eller sköta den åt dig.