Installasjonsveiledning

Installer MaxiPBX på serveren din

Ti trinn, fra domenenavnet til PBX-en din til din første pålogging i grensesnittet. Først klargjør du FQDN og brannmur, deretter genererer Control Plane et unikt skript som du kjører via SSH, og til slutt tar en nettveiviser over konfigurasjonen.

Før du begynner

  • En nyinstallert Debian 13-server uten andre tjenester eller programmer.
  • SSH-tilgang med root-kontoen (eller en konto som kan bli root).
  • Et domenenavn der du administrerer DNS-sonen, for å opprette FQDN for PBX-en din (for eksempel pbx.yourdomain.com).
  • En konto i MaxiPBX Control Plane, på my.maxipbx.com.
  • Tilgang til brannmuren eller ruteren foran serveren, for å åpne de nødvendige portene.
Før installasjonen

Klargjør nettverket

  1. Trinn 1 : Opprett FQDN for serveren din

    Gi først og fremst PBX-en din et fullstendig kvalifisert domenenavn (FQDN), for eksempel pbx.yourdomain.com. La dette navnet peke til serverens IP-adresse i domenets DNS-sone:

    MerkFQDN-en må allerede peke til serveren din når du starter installasjonen (trinn 8). Opprett den først.

    NavnTypeVerdi
    pbx.yourdomain.com A Serverens IPv4-adressePåkrevd
    pbx.yourdomain.com AAAA Serverens IPv6-adresseHvis serveren har en IPv6-adresse

    TipsEn DNS-endring kan ta noen minutter å tre i kraft. Kjør «ping pbx.yourdomain.com» fra datamaskinen din for å kontrollere at navnet peker til serverens IP-adresse.

  2. Trinn 2 : Åpne portene i brannmuren

    PBX-en har sin egen brannmur, som åpner nøyaktig de portene den trenger. Hvis det står en brannmur eller ruter foran den (vertsleverandørens brannmur, bedriftens ruter, internettboks), må alle portene nedenfor åpnes på den, utenfra og inn til PBX-en.

    MerkPort 8443 TCP er bare nødvendig under installasjonen: den brukes av installasjonsveiviseren (trinn 10). Åpne den før du starter installasjonen, og lukk den igjen når PBX-en er aktivert: da trengs den ikke lenger.

    PortProtokollTjenesteBruksområde
    8443 Kun under installasjonen TCP Veiviser Installasjonsveiviser (trinn 10). Lukkes igjen når PBX-en er aktivert
    80 TCP Nginx Provisjonering av telefoner via HTTP, fornyelse av Let's Encrypt-sertifikater
    443 TCP Nginx Nettgrensesnitt, API, mobil- og skrivebordsapper, nettelefon (WebRTC), HTTPS-provisjonering
    5060 UDP + TCP Kamailio SIP: telefoner, softphones, operatørtrunker
    5061 TCP Kamailio Kryptert SIP (TLS), ECDSA-sertifikat
    5062 TCP Kamailio Kryptert SIP (TLS), RSA-sertifikat for telefoner som ikke støtter ECDSA
    30000-40000 UDP rtpengine Tale (RTP) for alle samtaler: uten disse portene blir det ingen lyd
    3478-3479 UDP + TCP coturn STUN/TURN: lyd for appene og nettelefonen bak NAT
    5349-5350 UDP + TCP coturn Kryptert TURN (TLS), samme funksjon i restriktive nettverk
    389 TCP MaxiPBX API LDAP-katalog for telefoner
    10389 TCP MaxiPBX API LDAP-katalog på en alternativ port, for enkelte modeller
    22 TCP SSH Fjernadministrasjon og vedlikehold utført av MaxiPBX. Kan begrenses til våre IP-adresser

    TipsHvis PBX-en står bak NAT (privat IP-adresse), må du sette opp portvideresending av hele denne listen til dens interne IP-adresse, med det samme RTP-området 30000-40000 UDP.

I Control Plane

Generer installasjonsnøkkelen din

  1. Trinn 3 : Logg på Control Plane

    Åpne my.maxipbx.com i nettleseren og logg på med kontoen din. I Control Plane administrerer du hele PBX-flåten din.

    Åpne Control Plane
  2. Trinn 4 : Åpne listen over PBX-er

    Gå til «PBX-flåte» i menyen, og klikk deretter på «PBX». Der ser du alle PBX-ene som allerede er knyttet til kontoen din.

  3. Trinn 5 : Generer en installasjonsnøkkel

    Klikk på «Generer en installasjonsnøkkel». Nøkkelen knytter den fremtidige serveren til kontoen din: når den er installert, vises den direkte i flåten din.

  4. Trinn 6 : Vis og kopier installasjonsskriptet

    Vis installasjonsskriptet og kopier det i sin helhet. Det inneholder allerede nøkkelen din: du trenger ikke å endre noe i det.

    MerkSkriptet inneholder en nøkkel som er unik for kontoen din. Ikke del det, og ikke publiser det noe sted.

På serveren din

Kjør installasjonen

  1. Trinn 7 : Koble til via SSH med root-kontoen

    Koble til den helt nye Debian 13-serveren din med root-kontoen fra en terminal (eller en klient som PuTTY på Windows). Erstatt YOUR_IP med serverens IP-adresse.

    ssh root@YOUR_IP

    TipsHvis du er pålogget med en annen konto, bytter du til root med kommandoen «su -» eller «sudo -i» før du fortsetter.

  2. Trinn 8 : Lim inn skriptet og trykk på Enter

    Lim inn installasjonsskriptet du kopierte i trinn 6 i terminalen, og trykk deretter på Enter.

  3. Trinn 9 : La installasjonen kjøre

    Fremdriften i installasjonen vises fortløpende på skjermen. La den kjøre ferdig uten å røre noe.

    MerkIkke lukk terminalen eller avbryt SSH-tilkoblingen under installasjonen.

I nettleseren din

Fullfør konfigurasjonen

  1. Trinn 10 : Åpne installasjonsveiviseren

    Når installasjonen er fullført, viser terminalen adressen til PBX-en din i formatet nedenfor. Åpne den i nettleseren og følg installasjonsveiviseren: den leder deg gjennom den innledende konfigurasjonen.

    https://YOUR_IP:8443

    TipsHvis nettleseren viser en sikkerhetsadvarsel om sertifikatet ved dette første besøket, kan du fortsette til nettstedet for å starte veiviseren.

    Trenger du hjelp?Hvis du er i tvil om noe mens du bruker veiviseren, er du velkommen til å kontakte din MaxiPBX-forhandlerpartner: de er der for å hjelpe deg.

PBX-en din er installert

Når veiviseren er fullført, er PBX-en din klar og knyttet til flåten din i Control Plane. Du kan nå opprette brukere, telefoner og linjer.

Trenger du hjelp?

Teamet vårt kan bistå deg under installasjonen eller ta seg av den for deg.