Technische Fakten

Woraus MonoPbx besteht, worauf es läuft und wie man es installiert. Die Kurzfassung für Entscheider und die Details für Administratoren.

Auf einen Blick

Architektur
Ein SIP-Back-to-Back-User-Agent in Rust, rtpengine für Medien, eine Webkonsole und REST-API, PostgreSQL für die Konfiguration, Valkey für Cache und Ereignisse, ClickHouse für Anrufverlauf und Analysen.
Signalisierung
SIP über UDP, TCP und TLS. SIP über WebSocket für das Browsertelefon.
Medien
RTP und SRTP über rtpengine, WebRTC für Browser, STUN und TURN für Telefone hinter NAT.
Codecs
Opus, G.722, G.711, G.729. AMR und AMR-WB für IMS-Endgeräte, mit Transcodierung.
Mehrere Unternehmen
Eine Installation kann viele Unternehmen hosten. Ihre Daten werden in PostgreSQL zeilenweise getrennt gehalten.
API
REST mit einem OpenAPI-Dokument, signierte Webhooks, ein Ereignis-WebSocket und ein MCP-Server.
Sprachen
Konsole und Apps in neun Sprachen: Englisch, Spanisch (Mexiko), Portugiesisch (Brasilien), Französisch, Deutsch, Italienisch, Russisch, Chinesisch und Japanisch.

Skalierung

In unserem Labor trug ein kleiner Knoten 600 gleichzeitige Gespräche mit Medien. Kein Gespräch schlug fehl, und der Verbindungsaufbau dauerte beim 95. Perzentil unter 150 ms. Das wurde auf einem gemeinsam genutzten Entwicklungsrechner gemessen, sehen Sie es also als Größenordnung. Für Ihren eigenen Standort nutzen Sie den Dimensionierungsrechner. Dimensionierungsrechner →

Voraussetzungen und unterstützte Systeme

Linux-Paket und VM-Installer
Ubuntu 24.04 LTS, amd64 oder arm64.
Docker Compose
Jeder 64-Bit-Linux-Host mit Docker 24 oder neuer und Compose 2.24 oder neuer.
Kubernetes
Version 1.30 oder neuer. Einfache Manifeste mit Kustomize.
Rechner zum Start
2 CPUs, 4 GB RAM, 20 GiB frei unter /var/lib.
Netzwerk
Eine öffentliche IP-Adresse. Ein DNS-Name ist optional.
IMS-Modus
Optional. Der P-CSCF und der ePDG laufen unter Linux und brauchen CAP_NET_ADMIN. Siehe den Abschnitt IMS weiter unten.

Auf dem eigenen Server oder in einer Cloud-VM installieren

Bei jedem Cloud-Anbieter oder auf eigener Hardware: Legen Sie eine virtuelle Maschine mit Ubuntu 24.04 an, öffnen Sie die unten genannten Ports und starten Sie den Einzeiler-Installer. Jede Methode installiert dasselbe MonoPbx.

Linux-Paket, Schritt für Schritt

Führen Sie auf einem frischen Ubuntu-24.04-Server mit öffentlicher IP-Adresse Folgendes aus:

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

Die Einrichtung fragt nach einer E-Mail-Adresse für das Let’s-Encrypt-Zertifikat. Geben Sie auch Ihre eigene Domain an; ohne --domain heißt der Server <ip>.sslip.io:

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

Danach

  1. Konsole öffnen. Am Ende der Installation werden die Adresse Ihrer Konsole und ein einmaliger Einrichtungslink ausgegeben. Link verloren? sudo monopbx setup-url gibt einen neuen aus.
  2. Konto anlegen. E-Mail, Passwort und dann ein Code aus Ihrer Authenticator-App. Das ist der erste Administrator Ihrer Telefonanlage.
  3. Ihre 7-tägige kostenlose Testphase beginnt. Alles ist freigeschaltet. Fügen Sie einen SIP-Trunk hinzu, legen Sie Nebenstellen an und melden Sie sich per QR-Code bei MonoPhone an.
ubuntu@pbx:~So sieht das Ende der Installation aus
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/tcpZertifikatsprüfung, Weiterleitung auf HTTPS
443/tcpKonsole, API, Browsertelefon (wss://…/sip)
5060 udp+tcpSIP
5061/tcpSIP über TLS
30000–40000/udpRTP-Audio. Ohne diese Ports kommen Gespräche zustande, aber niemand hört etwas.

Ist ufw aktiv, öffnet die Einrichtung diese Ports. Öffnen Sie dieselben Ports auch in der Firewall Ihres Cloud-Anbieters.

IMS-Modus (VoLTE und VoWiFi)

Optional und aus, bis ein Administrator ihn einschaltet. Er macht MonoPbx zum IMS-Core für Ihre eigenen SIM-Karten.

Komponenten
Die Telefonanlagen-Engine, eine optionale P-CSCF-Rolle für VoLTE und ein optionaler ePDG (mpbx-epdg) für VoWiFi. Sie kommunizieren über authentifizierte Verbindungen in einem privaten Netz.
Protokolle
SIP mit IPsec (TS 33.203), IKEv2 mit EAP-AKA’, Diameter Cx und Rx über TCP oder SCTP mit optionalem TLS, HTTP Nudm und N5, SMS über IMS.
Teilnehmerdaten
In MonoPbx gehalten, oder in Ihrem HSS über Diameter Cx, oder in einem 5G-UDM über Nudm.
Voraussetzungen
Linux für den P-CSCF und den ePDG, mit CAP_NET_ADMIN. Eine öffentliche Adresse und ein Zertifikat für den ePDG. SIM-Schlüssel oder ein HSS oder UDM, der sie hält. Ein Medienserver, der AMR codieren kann, wenn Sie Mobilfunk-Codecs nutzen.
500, 4500/udpePDG: IKEv2 und ESP in UDP (VoWiFi)
5064, 5065 (Standardwerte)P-CSCF: SIP von Endgeräten durch den IPsec-Tunnel (VoLTE)
Diameter-Peer-Port, tcp oder sctpAusgehend zu Ihrem HSS oder Ihrer PCRF

IMS, VoLTE und VoWiFi → · Betreiberhandbuch →

Sicherheitsfakten

Tiefer einsteigen

Kostenlos testen Demo vereinbaren