Guia d'instal·lació

Instal·leu MaxiPBX al vostre servidor

Deu passos, des del nom de domini de la vostra PBX fins al primer accés a la interfície. Primer prepareu el FQDN i el tallafoc; després, el Control Plane genera un script únic que executeu per SSH i, finalment, un assistent web pren el relleu per a la configuració.

Abans de començar

  • Un servidor Debian 13 acabat d'instal·lar, sense cap altre servei ni aplicació.
  • Accés SSH amb el compte root (o amb un compte que pugui esdevenir root).
  • Un nom de domini del qual gestioneu la zona DNS, per crear el FQDN de la vostra PBX (per exemple, pbx.yourdomain.com).
  • Un compte al Control Plane de MaxiPBX, a my.maxipbx.com.
  • Accés al tallafoc o encaminador situat davant del servidor, per obrir els ports necessaris.
Abans de la instal·lació

Preparar la xarxa

  1. Pas 1 : Creeu el FQDN del servidor

    Abans de res, doneu un nom de domini complet (FQDN) a la vostra PBX, per exemple pbx.yourdomain.com. A la zona DNS del vostre domini, feu que aquest nom apunti a l'adreça IP del servidor:

    AtencióEl FQDN ja ha d'apuntar al vostre servidor en el moment d'iniciar la instal·lació (pas 8). Creeu-lo primer.

    NomTipusValor
    pbx.yourdomain.com A Adreça IPv4 del servidorObligatori
    pbx.yourdomain.com AAAA Adreça IPv6 del servidorSi el servidor té una adreça IPv6

    ConsellUn canvi de DNS pot trigar uns minuts a propagar-se. Per comprovar que el nom es resol amb la IP del servidor, executeu «ping pbx.yourdomain.com» des del vostre ordinador.

  2. Pas 2 : Obriu els ports del tallafoc

    La PBX té el seu propi tallafoc, que obre exactament els ports que necessita. Si hi ha un tallafoc o encaminador al davant (tallafoc del proveïdor d'allotjament, encaminador d'empresa, router d'internet), obriu-hi tots els ports següents, des de l'exterior cap a la PBX.

    AtencióEl port 8443 TCP només és necessari durant la instal·lació: és el de l'assistent d'instal·lació (pas 10). Obriu-lo abans d'iniciar la instal·lació i, després, tanqueu-lo un cop activada la PBX: ja no serà necessari.

    PortProtocolServeiPer a què serveix
    8443 Només durant la instal·lació TCP Assistent Assistent d'instal·lació (pas 10). Cal tancar-lo un cop activada la PBX
    80 TCP Nginx Aprovisionament de telèfons per HTTP, renovació dels certificats Let's Encrypt
    443 TCP Nginx Interfície web, API, aplicacions mòbils i d'escriptori, telèfon web (WebRTC), aprovisionament HTTPS
    5060 UDP + TCP Kamailio SIP: telèfons, telèfons de programari, troncals d'operadors
    5061 TCP Kamailio SIP xifrat (TLS), certificat ECDSA
    5062 TCP Kamailio SIP xifrat (TLS), certificat RSA per als telèfons que no admeten ECDSA
    30000-40000 UDP rtpengine Veu (RTP) de totes les trucades: sense aquests ports, no hi ha so
    3478-3479 UDP + TCP coturn STUN/TURN: so per a les aplicacions i el telèfon web darrere de NAT
    5349-5350 UDP + TCP coturn TURN xifrat (TLS), mateixa funció a les xarxes restrictives
    389 TCP MaxiPBX API Directori LDAP per als telèfons
    10389 TCP MaxiPBX API Directori LDAP en un port alternatiu, per a alguns models
    22 TCP SSH Administració i manteniment remots per part de MaxiPBX. Es pot restringir a les nostres adreces IP

    ConsellSi la PBX és darrere de NAT (adreça IP privada), configureu la redirecció de ports de tota aquesta llista cap a la seva IP interna, amb el mateix rang RTP 30000-40000 UDP.

Al Control Plane

Generar la clau d'instal·lació

  1. Pas 3 : Inicieu la sessió al Control Plane

    Obriu my.maxipbx.com al navegador i inicieu la sessió amb el vostre compte. Des del Control Plane gestioneu tot el vostre parc de PBX.

    Obrir el Control Plane
  2. Pas 4 : Obriu la llista de PBX

    Al menú, aneu a «Parc de PBX» i feu clic a «PBX». Hi veureu totes les PBX ja vinculades al vostre compte.

  3. Pas 5 : Genereu una clau d'instal·lació

    Feu clic a «Genera una clau d'instal·lació». Aquesta clau vincula el futur servidor al vostre compte: un cop instal·lat, apareixerà directament al vostre parc.

  4. Pas 6 : Mostreu i copieu l'script d'instal·lació

    Mostreu l'script d'instal·lació i copieu-lo sencer. Ja conté la vostra clau: no cal modificar-hi res.

    AtencióL'script conté una clau pròpia del vostre compte. No el compartiu ni el publiqueu enlloc.

Al vostre servidor

Executar la instal·lació

  1. Pas 7 : Connecteu-vos per SSH amb el compte root

    Des d'un terminal (o d'un client com PuTTY a Windows), connecteu-vos al vostre servidor Debian 13 acabat d'estrenar amb el compte root. Substituïu YOUR_IP per l'adreça IP del servidor.

    ssh root@YOUR_IP

    ConsellSi heu iniciat la sessió amb un altre compte, canvieu a root amb l'ordre «su -» o «sudo -i» abans de continuar.

  2. Pas 8 : Enganxeu l'script i premeu Retorn

    Enganxeu al terminal l'script d'instal·lació copiat al pas 6 i premeu Retorn.

  3. Pas 9 : Deixeu que la instal·lació s'executi

    El progrés de la instal·lació es mostra a la pantalla a mesura que avança. Deixeu-la acabar sense tocar res.

    AtencióNo tanqueu el terminal ni interrompeu la connexió SSH durant la instal·lació.

Al navegador

Completar la configuració

  1. Pas 10 : Obriu l'assistent d'instal·lació

    En acabar la instal·lació, el terminal mostra l'adreça de la vostra PBX, amb el format que es mostra a continuació. Obriu-la al navegador i seguiu l'assistent d'instal·lació: us guiarà en la configuració inicial.

    https://YOUR_IP:8443

    ConsellSi el navegador mostra un avís de seguretat sobre el certificat en aquest primer accés, podeu continuar cap al lloc per iniciar l'assistent.

    Necessiteu ajuda?Si teniu cap dubte durant l'assistent, no dubteu a contactar amb el vostre partner revenedor de MaxiPBX: és aquí per acompanyar-vos.

La vostra PBX està instal·lada

Un cop completat l'assistent, la vostra PBX està a punt i vinculada al vostre parc al Control Plane. Ara podeu crear els usuaris, els telèfons i les línies.

Necessiteu ajuda?

El nostre equip us pot acompanyar durant la instal·lació o encarregar-se'n per vosaltres.