技术资料

MonoPbx 由什么构成、运行在什么上、如何安装。给决策者的简要版本,以及给管理员的详细内容。

概览

架构
用 Rust 编写的 SIP 背靠背用户代理,rtpengine 负责媒体,网页控制台和 REST API,PostgreSQL 保存配置,Valkey 用于缓存和事件,ClickHouse 用于通话历史和分析。
信令
SIP over UDP、TCP 和 TLS。浏览器电话使用 SIP over WebSocket。
媒体
通过 rtpengine 传输 RTP 和 SRTP,浏览器使用 WebRTC,NAT 后的话机使用 STUN 和 TURN。
编解码器
Opus、G.722、G.711、G.729。面向 IMS 手机的 AMR 和 AMR-WB,带转码。
多家公司
一次安装可托管多家公司。它们的数据在 PostgreSQL 中按行相互隔离。
API
带 OpenAPI 文档的 REST、签名 webhook、事件 WebSocket 和 MCP 服务器。
语言
控制台和应用支持九种语言:英语、西班牙语(墨西哥)、葡萄牙语(巴西)、法语、德语、意大利语、俄语、中文和日语。

规模

在我们的实验室中,一个小型节点承载了 600 路带媒体的并发通话。没有任何通话失败,第 95 百分位的呼叫建立时间不到 150 毫秒。这是在一台共享开发机上测得的,请只把它当作数量级参考。针对您自己的站点,请使用容量计算器。 容量计算器 →

要求和支持的系统

Linux 软件包和虚拟机安装程序
Ubuntu 24.04 LTS,amd64 或 arm64。
Docker Compose
任何安装了 Docker 24 或更高版本以及 Compose 2.24 或更高版本的 64 位 Linux 主机。
Kubernetes
1.30 或更高版本。使用 Kustomize 的纯清单文件。
起步配置
2 个 CPU、4 GB 内存、/var/lib 下 20 GiB 可用空间。
网络
一个公网 IP 地址。DNS 域名为可选。
IMS 模式
可选。P-CSCF 和 ePDG 运行在 Linux 上,需要 CAP_NET_ADMIN。见下方 IMS 部分。

安装在您自己的服务器或云虚拟机上

在任意云服务商或您自己的硬件上,创建一台 Ubuntu 24.04 虚拟机,开放下方列出的端口,然后运行一行安装命令。每种方式运行的都是同一个 MonoPbx。

Linux 软件包,分步说明

在带有公网 IP 的全新 Ubuntu 24.04 服务器上运行:

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

安装过程会询问用于 Let’s Encrypt 证书的电子邮箱。也请加上您自己的域名;不使用 --domain 时,服务器名称为 <ip>.sslip.io:

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

然后

  1. 打开控制台. 安装程序在结束时会打印控制台地址和一次性设置链接。丢了?运行 sudo monopbx setup-url 即可重新生成。
  2. 创建您的账户. 填写电子邮箱和密码,再输入身份验证器应用中的验证码。这就是您的 PBX 的第一位管理员。
  3. 7 天免费试用开始. 所有功能均已开启。添加 SIP 中继线,创建分机,并用二维码登录 MonoPhone。
ubuntu@pbx:~安装结束时的画面
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

端口

80/tcp证书验证,重定向到 HTTPS
443/tcp控制台、API、浏览器电话(wss://…/sip)
5060 udp+tcpSIP
5061/tcpSIP over TLS
30000–40000/udpRTP 音频。没有它,通话能接通但听不到声音。

如果 ufw 处于启用状态,安装程序会开放这些端口。请在云防火墙中开放同样的端口。

IMS 模式(VoLTE 和 VoWiFi)

可选功能,在管理员开启之前保持关闭。它把 MonoPbx 变成您自有 SIM 卡的 IMS 核心。

组件
PBX 引擎、用于 VoLTE 的可选 P-CSCF 角色,以及用于 VoWiFi 的可选 ePDG(mpbx-epdg)。它们通过专用网络上的认证链路通信。
协议
带 IPsec 的 SIP(TS 33.203)、使用 EAP-AKA’ 的 IKEv2、基于 TCP 或 SCTP 并可选 TLS 的 Diameter Cx 和 Rx、HTTP Nudm 和 N5、IMS 短信。
用户数据
保存在 MonoPbx 中,或通过 Diameter Cx 保存在您的 HSS 中,或通过 Nudm 保存在 5G UDM 中。
要求
P-CSCF 和 ePDG 需要 Linux 并具有 CAP_NET_ADMIN。ePDG 需要公网地址和证书。需要 SIM 卡密钥,或保存这些密钥的 HSS 或 UDM。如使用移动编解码器,还需要能编码 AMR 的媒体服务器。
500, 4500/udpePDG:IKEv2 和 UDP 封装的 ESP(VoWiFi)
5064, 5065(默认值)P-CSCF:来自手机、经 IPsec 隧道的 SIP(VoLTE)
Diameter 对端端口,tcp 或 sctp出站连接到您的 HSS 或 PCRF

IMS、VoLTE 和 VoWiFi → · 运营商指南 →

安全要点

深入了解

免费试用 预约演示