Guida all'installazione

Installare MaxiPBX sul vostro server

Dieci passaggi, dal nome di dominio del vostro PBX al primo accesso all'interfaccia. Prima preparate il FQDN e il firewall, poi il Control Plane genera uno script univoco da eseguire via SSH e infine una procedura guidata web si occupa della configurazione.

Prima di iniziare

  • Un server Debian 13 appena installato, senza altri servizi o applicazioni.
  • Un accesso SSH con l'account root (o con un account che può diventare root).
  • Un nome di dominio di cui gestite la zona DNS, per creare il FQDN del vostro PBX (ad esempio pbx.yourdomain.com).
  • Un account sul Control Plane MaxiPBX, all'indirizzo my.maxipbx.com.
  • L'accesso al firewall o al router posto davanti al server, per aprire le porte necessarie.
Prima dell'installazione

Preparare la rete

  1. Passaggio 1 : Create il FQDN del vostro server

    Prima di tutto, assegnate al vostro PBX un nome di dominio completo (FQDN), ad esempio pbx.yourdomain.com. Nella zona DNS del vostro dominio, fate puntare questo nome all'indirizzo IP del vostro server:

    AttenzioneIl FQDN deve già puntare al vostro server nel momento in cui avviate l'installazione (passaggio 8). Createlo per primo.

    NomeTipoValore
    pbx.yourdomain.com A Indirizzo IPv4 del vostro serverObbligatorio
    pbx.yourdomain.com AAAA Indirizzo IPv6 del vostro serverSe il vostro server dispone di un indirizzo IPv6

    SuggerimentoUna modifica DNS può richiedere alcuni minuti per propagarsi. Per verificare che il nome risponda con l'IP del vostro server, eseguite «ping pbx.yourdomain.com» dal vostro computer.

  2. Passaggio 2 : Aprite le porte del firewall

    Il PBX dispone di un proprio firewall, che apre esattamente le porte di cui ha bisogno. Se davanti al PBX si trova un firewall o un router (firewall del provider di hosting, router aziendale, modem-router internet), aprite su di esso tutte le porte indicate di seguito, dall'esterno verso il PBX.

    AttenzioneLa porta 8443 TCP è necessaria solo durante l'installazione: è quella della procedura guidata di installazione (passaggio 10). Apritela prima di avviare l'installazione, quindi richiudetela una volta attivato il PBX: non serve più.

    PortaProtocolloServizioA cosa serve
    8443 Solo durante l'installazione TCP Procedura guidata Procedura guidata di installazione (passaggio 10). Da richiudere una volta attivato il PBX
    80 TCP Nginx Provisioning dei telefoni via HTTP, rinnovo del certificato Let's Encrypt
    443 TCP Nginx Interfaccia web, API, app mobile e desktop, telefono web (WebRTC), provisioning HTTPS
    5060 UDP + TCP Kamailio SIP: telefoni, softphone, trunk degli operatori
    5061 TCP Kamailio SIP cifrato (TLS), certificato ECDSA
    5062 TCP Kamailio SIP cifrato (TLS), certificato RSA per i telefoni che non supportano ECDSA
    30000-40000 UDP rtpengine Voce (RTP) di tutte le chiamate: senza queste porte non c'è audio
    3478-3479 UDP + TCP coturn STUN/TURN: audio delle app e del telefono web dietro NAT
    5349-5350 UDP + TCP coturn TURN cifrato (TLS), stessa funzione sulle reti restrittive
    389 TCP API MaxiPBX Rubrica LDAP per i telefoni
    10389 TCP API MaxiPBX Rubrica LDAP su porta alternativa, per alcuni modelli
    22 TCP SSH Amministrazione e manutenzione remota da parte di MaxiPBX. Può essere limitata ai nostri indirizzi IP

    SuggerimentoSe il PBX si trova dietro NAT (indirizzo IP privato), configurate un port forwarding di tutto questo elenco verso il suo IP interno, con lo stesso intervallo RTP 30000-40000 UDP.

Nel Control Plane

Generare la chiave di installazione

  1. Passaggio 3 : Accedete al Control Plane

    Aprite my.maxipbx.com nel vostro browser e accedete con il vostro account. È dal Control Plane che gestite l'intero parco dei vostri PBX.

    Apri il Control Plane
  2. Passaggio 4 : Aprite l'elenco dei vostri PBX

    Nel menu, andate su «Parco PBX», quindi fate clic su «PBX». Qui vedete tutti i PBX già collegati al vostro account.

  3. Passaggio 5 : Generate una chiave di installazione

    Fate clic su «Genera una chiave di installazione». Questa chiave collega il futuro server al vostro account: una volta installato, comparirà direttamente nel vostro parco.

  4. Passaggio 6 : Visualizzate e copiate lo script di installazione

    Visualizzate lo script di installazione e copiatelo per intero. Contiene già la vostra chiave: non dovete modificare nulla.

    AttenzioneLo script contiene una chiave specifica del vostro account. Non condividetelo e non pubblicatelo da nessuna parte.

Sul vostro server

Avviare l'installazione

  1. Passaggio 7 : Connettetevi via SSH con l'account root

    Da un terminale (o da un client come PuTTY su Windows), connettetevi al vostro nuovo server Debian 13 con l'account root. Sostituite YOUR_IP con l'indirizzo IP del vostro server.

    ssh root@YOUR_IP

    SuggerimentoSe siete connessi con un altro account, passate a root con il comando «su -» o «sudo -i» prima di continuare.

  2. Passaggio 8 : Incollate lo script e confermate

    Incollate nel terminale lo script di installazione copiato al passaggio 6, quindi premete Invio.

  3. Passaggio 9 : Lasciate procedere l'installazione

    L'avanzamento dell'installazione viene visualizzato a schermo man mano. Lasciatela arrivare fino alla fine senza toccare nulla.

    AttenzioneNon chiudete il terminale e non interrompete la connessione SSH durante l'installazione.

Nel vostro browser

Completare la configurazione

  1. Passaggio 10 : Aprite la procedura guidata di installazione

    Al termine dell'installazione, il terminale visualizza l'indirizzo del vostro PBX nella forma riportata di seguito. Apritelo nel vostro browser, quindi seguite la procedura guidata di installazione: vi guiderà nella configurazione iniziale.

    https://YOUR_IP:8443

    SuggerimentoSe al primo accesso il browser mostra un avviso di sicurezza relativo al certificato, potete proseguire verso il sito per avviare la procedura guidata.

    Serve aiuto?In caso di dubbi durante la procedura guidata, non esitate a contattare il vostro partner rivenditore MaxiPBX: è a vostra disposizione per assistervi.

Il vostro PBX è installato

Una volta completata la procedura guidata, il vostro PBX è pronto e collegato al vostro parco nel Control Plane. Potete creare i vostri utenti, telefoni e linee.

Serve una mano?

Il nostro team può assistervi durante l'installazione o occuparsene al posto vostro.