Fiche technique

De quoi MonoPbx est fait, sur quoi il s’exécute et comment l’installer. La version courte pour les décideurs, et les détails pour les administrateurs.

En un coup d’œil

Architecture
Un agent utilisateur SIP back-to-back écrit en Rust, rtpengine pour le média, une console web et une API REST, PostgreSQL pour la configuration, Valkey pour le cache et les événements, ClickHouse pour l’historique des appels et l’analytique.
Signalisation
SIP sur UDP, TCP et TLS. SIP sur WebSocket pour le téléphone dans le navigateur.
Média
RTP et SRTP via rtpengine, WebRTC pour les navigateurs, STUN et TURN pour les téléphones derrière un NAT.
Codecs
Opus, G.722, G.711, G.729. AMR et AMR-WB pour les terminaux IMS, avec transcodage.
Plusieurs entreprises
Une installation peut héberger de nombreuses entreprises. Leurs données sont isolées ligne par ligne dans PostgreSQL.
API
REST avec un document OpenAPI, webhooks signés, un WebSocket d’événements et un serveur MCP.
Langues
Console et applications en neuf langues : anglais, espagnol (Mexique), portugais (Brésil), français, allemand, italien, russe, chinois et japonais.

Capacité

Dans notre laboratoire, un petit nœud a supporté 600 appels simultanés avec média. Aucun appel n’a échoué, et l’établissement des appels a pris moins de 150 ms au 95e centile. Cela a été mesuré sur une seule machine de développement partagée : considérez-le comme un ordre de grandeur. Pour votre propre site, utilisez le calculateur de dimensionnement. Calculateur de dimensionnement →

Prérequis et systèmes pris en charge

Paquet Linux et installateur de VM
Ubuntu 24.04 LTS, amd64 ou arm64.
Docker Compose
Tout hôte Linux 64 bits avec Docker 24 ou ultérieur et Compose 2.24 ou ultérieur.
Kubernetes
Version 1.30 ou ultérieure. Manifestes simples avec Kustomize.
Machine pour démarrer
2 CPU, 4 Go de RAM, 20 Gio libres sous /var/lib.
Réseau
Une adresse IP publique. Un nom DNS est facultatif.
Mode IMS
Facultatif. Le P-CSCF et l’ePDG s’exécutent sur Linux et nécessitent CAP_NET_ADMIN. Voir la section IMS ci-dessous.

Installer sur votre propre serveur ou VM cloud

Chez n’importe quel fournisseur cloud ou sur votre propre matériel, créez une machine virtuelle Ubuntu 24.04, ouvrez les ports listés ci-dessous et lancez l’installateur en une ligne. Chaque méthode installe le même MonoPbx.

Paquet Linux, pas à pas

Sur un serveur Ubuntu 24.04 neuf avec une IP publique, exécutez :

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

L’installation demande une adresse e-mail pour le certificat Let’s Encrypt. Ajoutez aussi votre propre domaine ; sans --domain, le serveur est nommé <ip>.sslip.io :

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

Ensuite

  1. Ouvrez la console. L’installateur se termine en affichant l’adresse de votre console et un lien de configuration à usage unique. Vous l’avez perdu ? sudo monopbx setup-url en affiche un nouveau.
  2. Créez votre compte. E-mail, mot de passe, puis un code de votre application d’authentification. Il s’agit du premier administrateur de votre PBX.
  3. Votre essai gratuit de 7 jours commence. Tout est activé. Ajoutez un trunk SIP, créez des postes et connectez-vous à MonoPhone avec le code QR.
ubuntu@pbx:~À quoi ressemble la fin de l’installation
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

Ports

80/tcpDéfi de certificat, redirection vers HTTPS
443/tcpConsole, API, téléphone dans le navigateur (wss://…/sip)
5060 udp+tcpSIP
5061/tcpSIP sur TLS
30000–40000/udpAudio RTP. Sans lui, les appels aboutissent mais personne n’entend rien.

Si ufw est actif, l’installation ouvre ces ports. Ouvrez les mêmes dans le pare-feu de votre cloud.

Mode IMS (VoLTE et VoWiFi)

Facultatif et désactivé tant qu’un administrateur ne l’active pas. Il transforme MonoPbx en cœur IMS pour vos propres cartes SIM.

Composants
Le moteur PBX, un rôle P-CSCF facultatif pour la VoLTE et un ePDG facultatif (mpbx-epdg) pour le VoWiFi. Ils communiquent par des liaisons authentifiées sur un réseau privé.
Protocoles
SIP avec IPsec (TS 33.203), IKEv2 avec EAP-AKA’, Diameter Cx et Rx sur TCP ou SCTP avec TLS facultatif, HTTP Nudm et N5, SMS sur IMS.
Données des abonnés
Conservées dans MonoPbx, ou dans votre HSS via Diameter Cx, ou dans un UDM 5G via Nudm.
Prérequis
Linux pour le P-CSCF et l’ePDG, avec CAP_NET_ADMIN. Une adresse publique et un certificat pour l’ePDG. Les clés des SIM, ou un HSS ou UDM qui les détient. Un serveur média capable d’encoder l’AMR si vous utilisez les codecs mobiles.
500, 4500/udpePDG : IKEv2 et ESP dans UDP (VoWiFi)
5064, 5065 (par défaut)P-CSCF : SIP des terminaux à travers le tunnel IPsec (VoLTE)
Port du pair Diameter, tcp ou sctpSortant vers votre HSS ou PCRF

IMS, VoLTE et VoWiFi → · Guide de l’opérateur →

Sécurité en bref

Aller plus loin

Essai gratuit Réserver une démo