Dati tecnici

Di che cosa è fatto MonoPbx, su che cosa funziona e come installarlo. La versione breve per i decisori e i dettagli per gli amministratori.

In sintesi

Architettura
Un SIP back-to-back user agent scritto in Rust, rtpengine per i media, una console web e API REST, PostgreSQL per la configurazione, Valkey per cache ed eventi, ClickHouse per lo storico chiamate e le analisi.
Segnalazione
SIP su UDP, TCP e TLS. SIP su WebSocket per il telefono nel browser.
Media
RTP e SRTP tramite rtpengine, WebRTC per i browser, STUN e TURN per i telefoni dietro NAT.
Codec
Opus, G.722, G.711, G.729. AMR e AMR-WB per i telefoni IMS, con transcodifica.
Più aziende
Una sola installazione può ospitare molte aziende. I loro dati sono tenuti separati riga per riga in PostgreSQL.
API
REST con un documento OpenAPI, webhook firmati, un WebSocket di eventi e un server MCP.
Lingue
Console e app in nove lingue: inglese, spagnolo (Messico), portoghese (Brasile), francese, tedesco, italiano, russo, cinese e giapponese.

Scalabilità

Nel nostro laboratorio, un singolo nodo di piccole dimensioni ha gestito 600 chiamate simultanee con media. Nessuna chiamata è fallita e l’instaurazione della chiamata ha richiesto meno di 150 ms al 95º percentile. La misura è stata effettuata su una sola macchina di sviluppo condivisa, quindi va considerata un ordine di grandezza. Per la Sua sede, usi il calcolatore di dimensionamento. Calcolatore di dimensionamento →

Requisiti e sistemi supportati

Pacchetto Linux e installer per VM
Ubuntu 24.04 LTS, amd64 o arm64.
Docker Compose
Qualsiasi host Linux a 64 bit con Docker 24 o successivo e Compose 2.24 o successivo.
Kubernetes
Versione 1.30 o successiva. Manifest semplici con Kustomize.
Macchina per iniziare
2 CPU, 4 GB di RAM, 20 GiB liberi in /var/lib.
Rete
Un indirizzo IP pubblico. Un nome DNS è facoltativo.
Modalità IMS
Facoltativa. Il P-CSCF e l’ePDG funzionano su Linux e richiedono CAP_NET_ADMIN. Veda la sezione IMS più avanti.

Installazione sul Suo server o su una VM cloud

Presso qualsiasi fornitore cloud o sul Suo hardware, crei una macchina virtuale Ubuntu 24.04, apra le porte elencate qui sotto ed esegua l’installer in una riga. Ogni metodo installa lo stesso MonoPbx.

Pacchetto Linux, passo per passo

Su un server Ubuntu 24.04 appena installato, con un IP pubblico, eseguire:

curl -fsSL https://ilinaya.github.io/monopbx-apt/install.sh | sudo bash

La configurazione richiede un indirizzo e-mail per il certificato Let’s Encrypt. Aggiunga anche il Suo dominio; senza --domain il server prende il nome <ip>.sslip.io:

curl -fsSL https://ilinaya.github.io/monopbx-apt/install.sh | sudo bash -s -- --domain pbx.example.com --email you@example.com

Poi

  1. Aprire la console. L’installer termina mostrando l’indirizzo della console e un link di configurazione monouso. Smarrito? sudo monopbx setup-url ne stampa uno nuovo.
  2. Creare l’account. E-mail, password e poi un codice dalla Sua app di autenticazione. È il primo amministratore del Suo centralino.
  3. Inizia la prova gratuita di 7 giorni. Tutto è attivo. Aggiunga un trunk SIP, crei gli interni e acceda a MonoPhone con il codice QR.
ubuntu@pbx:~Come appare la fine dell’installazione
curl -fsSL https://ilinaya.github.io/monopbx-apt/install.sh | sudo bash -s -- --domain pbx.example.com --email you@example.com
==> Prerequisites
==> MonoPbx APT repository: https://ilinaya.github.io/monopbx-apt
    signing key verified: 320D C78E FDC8 439C 04F5  FCA6 3E87 FE3D 4C71 5372
==> Installing monopbx (with Ubuntu's docker.io and docker-compose-v2 unless Docker is already installed)
==> monopbx setup --domain pbx.example.com --email you@example.com
    …
==> MonoPbx is ready
    console:        https://pbx.example.com
    web softphone:  wss://pbx.example.com/sip
    SIP:            pbx.example.com port 5060 (UDP/TCP), 5061 (TLS)
    first admin:    open the single-use setup link printed above (.../setup#token=...)
    manage:         monopbx status | logs | sudo monopbx backup | upgrade | uninstall

Porte

80/tcpVerifica del certificato, reindirizzamento a HTTPS
443/tcpConsole, API, telefono nel browser (wss://…/sip)
5060 udp+tcpSIP
5061/tcpSIP su TLS
30000–40000/udpAudio RTP. Senza di essa le chiamate si collegano ma nessuno sente nulla.

Se ufw è attivo, la configurazione apre queste porte. Apra le stesse porte anche nel firewall del Suo cloud.

Modalità IMS (VoLTE e VoWiFi)

Facoltativa e disattivata finché un amministratore non la attiva. Trasforma MonoPbx nel core IMS per le Sue SIM.

Componenti
Il motore del centralino, un ruolo P-CSCF facoltativo per il VoLTE e un ePDG facoltativo (mpbx-epdg) per il VoWiFi. Comunicano tramite collegamenti autenticati su una rete privata.
Protocolli
SIP con IPsec (TS 33.203), IKEv2 con EAP-AKA’, Diameter Cx e Rx su TCP o SCTP con TLS facoltativo, HTTP Nudm e N5, SMS su IMS.
Dati degli abbonati
Conservati in MonoPbx, oppure nel Suo HSS tramite Diameter Cx, oppure in un UDM 5G tramite Nudm.
Requisiti
Linux per il P-CSCF e l’ePDG, con CAP_NET_ADMIN. Un indirizzo pubblico e un certificato per l’ePDG. Le chiavi delle SIM, oppure un HSS o un UDM che le custodisca. Un media server in grado di codificare AMR se si usano i codec mobili.
500, 4500/udpePDG: IKEv2 ed ESP in UDP (VoWiFi)
5064, 5065 (predefinite)P-CSCF: SIP dai telefoni attraverso il tunnel IPsec (VoLTE)
Porta del peer Diameter, tcp o sctpIn uscita verso il Suo HSS o PCRF

IMS, VoLTE e VoWiFi → · Guida per operatori →

Dati sulla sicurezza

Per approfondire

Inizia la prova gratuita Prenota una demo