技术资料
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。
虚拟机或云服务器
Ubuntu 24.04 LTS
虚拟机安装程序会在全新的服务器上完成单节点安装。apt 软件包已包含它。
虚拟机指南 →Linux 软件包
Ubuntu 24.04 LTS
一条命令即可安装 Docker、生产环境套件和 monopbx 命令,并获取 Let’s Encrypt 证书。
apt 指南 →Docker Compose
安装了 Docker 24+ 的 64 位 Linux
包含 Postgres、Valkey、ClickHouse 和 rtpengine 的生产环境套件,适用于您已在管理的主机。
Compose 指南 →Kubernetes
Kubernetes 1.30+
使用 kubectl apply -k(Kustomize)应用的纯清单文件。没有 Helm chart。请先阅读关于经 NAT 传输媒体的说明。
Kubernetes 指南 →
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
然后
- 打开控制台. 安装程序在结束时会打印控制台地址和一次性设置链接。丢了?运行 sudo monopbx setup-url 即可重新生成。
- 创建您的账户. 填写电子邮箱和密码,再输入身份验证器应用中的验证码。这就是您的 PBX 的第一位管理员。
- 7 天免费试用开始. 所有功能均已开启。添加 SIP 中继线,创建分机,并用二维码登录 MonoPhone。
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+tcp | SIP |
5061/tcp | SIP over TLS |
30000–40000/udp | RTP 音频。没有它,通话能接通但听不到声音。 |
如果 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/udp | ePDG:IKEv2 和 UDP 封装的 ESP(VoWiFi) |
|---|---|
5064, 5065(默认值) | P-CSCF:来自手机、经 IPsec 隧道的 SIP(VoLTE) |
Diameter 对端端口,tcp 或 sctp | 出站连接到您的 HSS 或 PCRF |
IMS、VoLTE 和 VoWiFi → · 运营商指南 →
安全要点
- 录音和文件在磁盘上加密。CRM 和服务商凭据由您的公司密钥加密封存。
- 通行密钥、双重验证登录、OpenID Connect 单点登录、SCIM,以及管理员 IP 允许名单。可选使用您自己的密钥为登录启用 reCAPTCHA。
- SIP 侧和网页侧自动封禁 IP,统一在一份名单中查看。
- SIP 边界上的地理封锁、允许和拒绝名单以及 STIR/SHAKEN。每条中继线的 SRTP 可设为可选或必选。
- 审计日志、变更历史,以及可恢复到新主机上的定时加密备份。
- 通话、录音和历史记录从不经过我们。只有为话机唤醒而发送的推送通知使用推送中继,您也可以在没有它的情况下安装。