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.
Machine virtuelle ou serveur cloud
Ubuntu 24.04 LTS
L’installateur de VM met en place une installation mono-nœud sur un serveur neuf. Le paquet apt l’inclut.
guide VM →Paquet Linux
Ubuntu 24.04 LTS
Une seule commande installe Docker, l’ensemble de production et une commande monopbx, et obtient un certificat Let’s Encrypt.
guide apt →Docker Compose
Linux 64 bits avec Docker 24+
L’ensemble de production avec Postgres, Valkey, ClickHouse et rtpengine, pour les hôtes que vous gérez déjà.
guide Compose →Kubernetes
Kubernetes 1.30+
Des manifestes simples appliqués avec kubectl apply -k (Kustomize). Il n’y a pas de chart Helm. Lisez d’abord les notes sur le média derrière un NAT.
guide Kubernetes →
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
- 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.
- 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.
- 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.
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/tcp | Défi de certificat, redirection vers HTTPS |
|---|---|
443/tcp | Console, API, téléphone dans le navigateur (wss://…/sip) |
5060 udp+tcp | SIP |
5061/tcp | SIP sur TLS |
30000–40000/udp | Audio 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/udp | ePDG : 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 sctp | Sortant vers votre HSS ou PCRF |
IMS, VoLTE et VoWiFi → · Guide de l’opérateur →
Sécurité en bref
- Les enregistrements et les fichiers sont chiffrés sur disque. Les identifiants du CRM et des fournisseurs sont scellés avec la clé de votre entreprise.
- Clés d’accès, connexion à deux facteurs, authentification unique OpenID Connect, SCIM et liste d’IP autorisées pour les administrateurs. reCAPTCHA facultatif à la connexion avec vos propres clés.
- Blocage automatique d’IP côté SIP et côté web, avec une seule liste consultable.
- Blocage géographique, listes d’autorisation et de refus et STIR/SHAKEN en périphérie SIP. Le SRTP peut être facultatif ou obligatoire par trunk.
- Journal d’audit, historique des modifications et sauvegardes chiffrées planifiées qui se restaurent sur un nouvel hôte.
- Les appels, les enregistrements et l’historique ne passent jamais par nous. Seule la notification push qui réveille un téléphone utilise le relais push, et vous pouvez installer sans lui.