Installationsvejledning

Installer MaxiPBX på din server

Ti trin, fra din PBX’s domænenavn til dit første login i brugerfladen. Først forbereder du FQDN og firewall, derefter genererer Control Plane et unikt script, som du kører via SSH, og til sidst overtager en webguide konfigurationen.

Før du begynder

  • En nyinstalleret Debian 13-server uden andre tjenester eller programmer.
  • SSH-adgang med root-kontoen (eller en konto, der kan skifte til root).
  • Et domænenavn, hvis DNS-zone du administrerer, så du kan oprette din PBX’s FQDN (for eksempel pbx.yourdomain.com).
  • En konto i MaxiPBX Control Plane på my.maxipbx.com.
  • Adgang til den firewall eller router, der står foran serveren, så de nødvendige porte kan åbnes.
Før installationen

Forbered netværket

  1. Trin 1 : Opret din servers FQDN

    Giv først og fremmest din PBX et fuldt kvalificeret domænenavn (FQDN), for eksempel pbx.yourdomain.com. Lad dette navn pege på din servers IP-adresse i dit domænes DNS-zone:

    BemærkFQDN’et skal allerede pege på din server, når du starter installationen (trin 8). Opret det først.

    NavnTypeVærdi
    pbx.yourdomain.com A Din servers IPv4-adressePåkrævet
    pbx.yourdomain.com AAAA Din servers IPv6-adresseHvis din server har en IPv6-adresse

    TipEn DNS-ændring kan tage nogle minutter om at slå igennem. Kør „ping pbx.yourdomain.com“ fra din computer for at kontrollere, at navnet peger på din servers IP-adresse.

  2. Trin 2 : Åbn portene i firewallen

    PBX’en har sin egen firewall, som åbner præcis de porte, den har brug for. Hvis der står en firewall eller router foran (hostingudbyderens firewall, virksomhedens router, internetboks), skal alle nedenstående porte åbnes på den, udefra og ind til PBX’en.

    BemærkPort 8443 TCP er kun nødvendig under installationen: den bruges af installationsguiden (trin 10). Åbn den, før du starter installationen, og luk den igen, når PBX’en er aktiveret: den er så ikke længere nødvendig.

    PortProtokolTjenesteAnvendelse
    8443 Kun under installationen TCP Guide Installationsguide (trin 10). Lukkes igen, når PBX’en er aktiveret
    80 TCP Nginx Provisionering af telefoner via HTTP, fornyelse af Let's Encrypt-certifikater
    443 TCP Nginx Webbrugerflade, API, mobil- og desktopapps, webtelefon (WebRTC), HTTPS-provisionering
    5060 UDP + TCP Kamailio SIP: telefoner, softphones, operatørtrunks
    5061 TCP Kamailio Krypteret SIP (TLS), ECDSA-certifikat
    5062 TCP Kamailio Krypteret SIP (TLS), RSA-certifikat til telefoner, der ikke understøtter ECDSA
    30000-40000 UDP rtpengine Tale (RTP) for alle opkald: uden disse porte er der ingen lyd
    3478-3479 UDP + TCP coturn STUN/TURN: lyd til apps og webtelefon bag NAT
    5349-5350 UDP + TCP coturn Krypteret TURN (TLS), samme funktion på restriktive netværk
    389 TCP MaxiPBX API LDAP-telefonbog til telefoner
    10389 TCP MaxiPBX API LDAP-telefonbog på en alternativ port til visse modeller
    22 TCP SSH Fjernadministration og vedligeholdelse udført af MaxiPBX. Kan begrænses til vores IP-adresser

    TipHvis PBX’en står bag NAT (privat IP-adresse), skal du oprette portvideresendelse af hele denne liste til dens interne IP-adresse med det samme RTP-interval 30000-40000 UDP.

I Control Plane

Generer din installationsnøgle

  1. Trin 3 : Log ind i Control Plane

    Åbn my.maxipbx.com i din browser, og log ind med din konto. I Control Plane administrerer du hele din PBX-flåde.

    Åbn Control Plane
  2. Trin 4 : Åbn din liste over PBX’er

    Gå i menuen til „PBX-flåde“, og klik derefter på „PBX“. Her ser du alle de PBX’er, der allerede er knyttet til din konto.

  3. Trin 5 : Generer en installationsnøgle

    Klik på „Generer en installationsnøgle“. Nøglen knytter den kommende server til din konto: når den er installeret, vises den direkte i din flåde.

  4. Trin 6 : Vis og kopier installationsscriptet

    Vis installationsscriptet, og kopier det i sin helhed. Det indeholder allerede din nøgle: du behøver ikke at ændre noget i det.

    BemærkScriptet indeholder en nøgle, der er specifik for din konto. Del det ikke, og offentliggør det ingen steder.

På din server

Kør installationen

  1. Trin 7 : Opret forbindelse via SSH med root-kontoen

    Opret fra en terminal (eller en klient som PuTTY på Windows) forbindelse til din helt nye Debian 13-server med root-kontoen. Erstat YOUR_IP med din servers IP-adresse.

    ssh root@YOUR_IP

    TipHvis du er logget ind med en anden konto, skal du skifte til root med kommandoen „su -“ eller „sudo -i“, før du fortsætter.

  2. Trin 8 : Indsæt scriptet, og tryk på Enter

    Indsæt installationsscriptet, som du kopierede i trin 6, i terminalen, og tryk derefter på Enter.

  3. Trin 9 : Lad installationen køre

    Installationens fremskridt vises løbende på skærmen. Lad den køre færdig uden at røre ved noget.

    BemærkLuk ikke terminalen, og afbryd ikke SSH-forbindelsen under installationen.

I din browser

Fuldfør konfigurationen

  1. Trin 10 : Åbn installationsguiden

    Når installationen er færdig, viser terminalen din PBX’s adresse i det format, der er vist nedenfor. Åbn den i din browser, og følg installationsguiden: den fører dig gennem den indledende konfiguration.

    https://YOUR_IP:8443

    TipHvis din browser viser en sikkerhedsadvarsel om certifikatet ved dette første besøg, kan du fortsætte til webstedet for at starte guiden.

    Brug for hjælp?Er du i tvivl undervejs i guiden, er du velkommen til at kontakte din MaxiPBX-forhandlerpartner: de står klar til at hjælpe dig.

Din PBX er installeret

Når guiden er gennemført, er din PBX klar og knyttet til din flåde i Control Plane. Du kan nu oprette dine brugere, telefoner og linjer.

Brug for hjælp?

Vores team kan hjælpe dig under installationen eller klare den for dig.