Технические факты

Из чего состоит MonoPbx, где она работает и как её установить. Коротко для тех, кто решает, и подробно для тех, кто администрирует.

Коротко

Архитектура
SIP-сервер типа B2BUA на Rust, rtpengine для медиа, веб-консоль и REST API, PostgreSQL для настроек, Valkey для кеша и событий, ClickHouse для истории и аналитики звонков.
Сигнализация
SIP по UDP, TCP и TLS. SIP по WebSocket для телефона в браузере.
Медиа
RTP и SRTP через rtpengine, WebRTC для браузеров, STUN и TURN для телефонов за NAT.
Кодеки
Opus, G.722, G.711, G.729. AMR и AMR-WB для телефонов IMS, с перекодированием.
Несколько компаний
Одна установка может обслуживать много компаний. Их данные разделены построчно в PostgreSQL.
API
REST с документом OpenAPI, подписанные вебхуки, WebSocket событий и MCP-сервер.
Языки
Консоль и приложения на девяти языках: английский, испанский (Мексика), португальский (Бразилия), французский, немецкий, итальянский, русский, китайский и японский.

Масштаб

В нашей лаборатории один небольшой узел выдержал 600 одновременных звонков с медиа. Ни один звонок не сорвался, а установление соединения заняло меньше 150 мс на 95-м процентиле. Замер сделан на одной общей машине разработки, поэтому считайте это порядком величины. Для вашей площадки воспользуйтесь калькулятором ресурсов. Калькулятор ресурсов →

Требования и поддерживаемые системы

Пакет Linux и установщик для ВМ
Ubuntu 24.04 LTS, amd64 или arm64.
Docker Compose
Любой 64-разрядный хост с Linux, Docker 24 или новее и Compose 2.24 или новее.
Kubernetes
Версия 1.30 или новее. Обычные манифесты с Kustomize.
Машина для старта
2 процессора, 4 ГБ памяти, 20 ГиБ свободно в /var/lib.
Сеть
Публичный IP-адрес. DNS-имя необязательно.
Режим IMS
Необязателен. P-CSCF и ePDG работают на Linux и требуют CAP_NET_ADMIN. См. раздел об IMS ниже.

Установка на свой сервер или облачную ВМ

У любого облачного провайдера или на своём оборудовании создайте виртуальную машину с Ubuntu 24.04, откройте порты из списка ниже и запустите установщик одной строкой. Любой способ устанавливает один и тот же MonoPbx.

Пакет Linux, по шагам

На чистом сервере с Ubuntu 24.04 и публичным IP выполните:

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

Для сертификата Let’s Encrypt установщик попросит e-mail. Заодно укажите свой домен; без --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. Создайте аккаунт. E-mail, пароль, затем код из приложения-аутентификатора. Это первый администратор вашей АТС.
  3. Начинается 7-дневный бесплатный период. Всё уже включено. Добавьте SIP-транк, заведите внутренние номера и войдите в MonoPhone по QR-коду.
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 поверх TLS
30000–40000/udpRTP-звук. Без него звонок соединится, но никто никого не услышит.

Если включён ufw, установщик сам откроет эти порты. В облачном файрволе откройте те же.

Режим IMS (VoLTE и VoWiFi)

Необязателен и выключен, пока администратор его не включит. Превращает MonoPbx в ядро IMS для ваших собственных SIM-карт.

Компоненты
Ядро АТС, необязательная роль P-CSCF для VoLTE и необязательный ePDG (mpbx-epdg) для VoWiFi. Они связаны аутентифицированными каналами в закрытой сети.
Протоколы
SIP с IPsec (TS 33.203), IKEv2 с EAP-AKA’, Diameter Cx и Rx по TCP или SCTP с необязательным TLS, HTTP Nudm и N5, SMS поверх IMS.
Данные абонентов
В MonoPbx, в вашем HSS по Diameter Cx или в UDM 5G по Nudm.
Требования
Linux для P-CSCF и ePDG с CAP_NET_ADMIN. Для ePDG публичный адрес и сертификат. Ключи SIM или HSS либо UDM, где они хранятся. Медиасервер, умеющий кодировать AMR, если вы включаете мобильные кодеки.
500, 4500/udpePDG: IKEv2 и ESP в UDP (VoWiFi)
5064, 5065 (по умолчанию)P-CSCF: SIP от телефонов через туннель IPsec (VoLTE)
Порт узла Diameter, tcp или sctpИсходящее соединение к вашему HSS или PCRF

IMS, VoLTE и VoWiFi → · Руководство для операторов →

Факты о безопасности

Подробнее

Бесплатная проба Заказать демо