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.
Macchina virtuale o server cloud
Ubuntu 24.04 LTS
L’installer per VM configura un’installazione a nodo singolo su un server appena creato. Il pacchetto apt lo include.
guida VM →Pacchetto Linux
Ubuntu 24.04 LTS
Un solo comando installa Docker, il bundle di produzione e il comando monopbx, e ottiene un certificato Let’s Encrypt.
guida apt →Docker Compose
Linux a 64 bit con Docker 24+
Il bundle di produzione con Postgres, Valkey, ClickHouse e rtpengine, per gli host che già gestisce.
guida Compose →Kubernetes
Kubernetes 1.30+
Manifest semplici applicati con kubectl apply -k (Kustomize). Non esiste un chart Helm. Legga prima le note sul media attraverso il NAT.
guida Kubernetes →
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
- 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.
- Creare l’account. E-mail, password e poi un codice dalla Sua app di autenticazione. È il primo amministratore del Suo centralino.
- Inizia la prova gratuita di 7 giorni. Tutto è attivo. Aggiunga un trunk SIP, crei gli interni e acceda a MonoPhone con il codice QR.
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/tcp | Verifica del certificato, reindirizzamento a HTTPS |
|---|---|
443/tcp | Console, API, telefono nel browser (wss://…/sip) |
5060 udp+tcp | SIP |
5061/tcp | SIP su TLS |
30000–40000/udp | Audio 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/udp | ePDG: 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 sctp | In uscita verso il Suo HSS o PCRF |
IMS, VoLTE e VoWiFi → · Guida per operatori →
Dati sulla sicurezza
- Registrazioni e file sono cifrati su disco. Le credenziali del CRM e dei fornitori sono sigillate con la chiave della Sua azienda.
- Passkey, accesso a due fattori, single sign-on OpenID Connect, SCIM ed elenco di IP consentiti per gli amministratori. reCAPTCHA facoltativo all’accesso con le Sue chiavi.
- Blocchi IP automatici lato SIP e lato web, con un unico elenco da consultare.
- Blocco geografico, elenchi di autorizzazione e di rifiuto e STIR/SHAKEN sul bordo SIP. SRTP può essere facoltativo o obbligatorio per ogni trunk.
- Registro di audit, cronologia delle modifiche e backup cifrati pianificati che si ripristinano su un nuovo host.
- Chiamate, registrazioni e storico non passano mai da noi. Solo la notifica push che attiva un telefono usa il relay push, ed è possibile installare senza di esso.