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.
Virtuelle Maschine oder Cloud-Server
Ubuntu 24.04 LTS
Der VM-Installer richtet auf einem frischen Server eine Einzelknoten-Installation ein. Das apt-Paket enthält ihn.
VM-Anleitung →Linux-Paket
Ubuntu 24.04 LTS
Ein Befehl installiert Docker, das Produktionspaket und den Befehl monopbx und besorgt ein Let’s-Encrypt-Zertifikat.
apt-Anleitung →Docker Compose
64-Bit-Linux mit Docker 24+
Das Produktionspaket mit Postgres, Valkey, ClickHouse und rtpengine, für Hosts, die Sie bereits selbst betreiben.
Compose-Anleitung →Kubernetes
Kubernetes 1.30+
Einfache Manifeste, angewendet mit kubectl apply -k (Kustomize). Es gibt kein Helm-Chart. Lesen Sie zuerst die Hinweise zu Medien hinter NAT.
Kubernetes-Anleitung →
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
- 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.
- Konto anlegen. E-Mail, Passwort und dann ein Code aus Ihrer Authenticator-App. Das ist der erste Administrator Ihrer Telefonanlage.
- 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.
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 | Zertifikatsprüfung, Weiterleitung auf HTTPS |
|---|---|
443/tcp | Konsole, API, Browsertelefon (wss://…/sip) |
5060 udp+tcp | SIP |
5061/tcp | SIP über TLS |
30000–40000/udp | RTP-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/udp | ePDG: 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 sctp | Ausgehend zu Ihrem HSS oder Ihrer PCRF |
IMS, VoLTE und VoWiFi → · Betreiberhandbuch →
Sicherheitsfakten
- Aufzeichnungen und Dateien werden auf der Festplatte verschlüsselt. CRM- und Anbieter-Zugangsdaten werden mit Ihrem Firmenschlüssel versiegelt.
- Passkeys, Zwei-Faktor-Anmeldung, OpenID-Connect-Single-Sign-on, SCIM und eine IP-Zulassungsliste für Administratoren. Optionales reCAPTCHA bei der Anmeldung mit Ihren eigenen Schlüsseln.
- Automatische IP-Sperren auf der SIP- und der Webseite, mit einer Liste, die Sie einsehen können.
- Geo-Blocking, Zulassungs- und Sperrlisten und STIR/SHAKEN am SIP-Rand. SRTP kann pro Trunk optional oder verpflichtend sein.
- Audit-Protokoll, Änderungsverlauf und geplante verschlüsselte Backups, die sich auf einem neuen Host wiederherstellen lassen.
- Anrufe, Aufzeichnungen und Verlauf laufen nie über uns. Nur die Push-Benachrichtigung, die ein Telefon weckt, nutzt das Push-Relay, und Sie können auch ohne es installieren.