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.
Preparare la rete
-
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.
Nome Tipo Valore pbx.yourdomain.comA Indirizzo IPv4 del vostro serverObbligatorio pbx.yourdomain.comAAAA 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.
-
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ù.
Porta Protocollo Servizio A cosa serve 8443Solo durante l'installazioneTCP Procedura guidata Procedura guidata di installazione (passaggio 10). Da richiudere una volta attivato il PBX 80TCP Nginx Provisioning dei telefoni via HTTP, rinnovo del certificato Let's Encrypt 443TCP Nginx Interfaccia web, API, app mobile e desktop, telefono web (WebRTC), provisioning HTTPS 5060UDP + TCP Kamailio SIP: telefoni, softphone, trunk degli operatori 5061TCP Kamailio SIP cifrato (TLS), certificato ECDSA 5062TCP Kamailio SIP cifrato (TLS), certificato RSA per i telefoni che non supportano ECDSA 30000-40000UDP rtpengine Voce (RTP) di tutte le chiamate: senza queste porte non c'è audio 3478-3479UDP + TCP coturn STUN/TURN: audio delle app e del telefono web dietro NAT 5349-5350UDP + TCP coturn TURN cifrato (TLS), stessa funzione sulle reti restrittive 389TCP API MaxiPBX Rubrica LDAP per i telefoni 10389TCP API MaxiPBX Rubrica LDAP su porta alternativa, per alcuni modelli 22TCP 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.
Generare la chiave di installazione
-
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 -
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.
-
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.
-
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.
Avviare l'installazione
-
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_IPSuggerimentoSe siete connessi con un altro account, passate a root con il comando «su -» o «sudo -i» prima di continuare.
-
Passaggio 8 : Incollate lo script e confermate
Incollate nel terminale lo script di installazione copiato al passaggio 6, quindi premete Invio.
-
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.
Completare la configurazione
-
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:8443SuggerimentoSe 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.

