Технические факты
Из чего состоит 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.
Виртуальная машина или облачный сервер
Ubuntu 24.04 LTS
Установщик для ВМ разворачивает одноузловую установку на чистом сервере. Пакет apt включает его.
Инструкция для ВМ →Пакет Linux
Ubuntu 24.04 LTS
Одна команда ставит Docker, производственную сборку и команду monopbx и получает сертификат Let’s Encrypt.
Инструкция apt →Docker Compose
64-разрядный Linux с Docker 24+
Производственная сборка с Postgres, Valkey, ClickHouse и rtpengine, для хостов, которыми вы уже управляете.
Инструкция Compose →Kubernetes
Kubernetes 1.30+
Обычные манифесты, которые применяются через kubectl apply -k (Kustomize). Helm-чарта нет. Сначала прочитайте заметки о медиатрафике через NAT.
Инструкция Kubernetes →
Пакет 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
Дальше
- Откройте консоль. В конце установщик печатает адрес консоли и одноразовую ссылку настройки. Потеряли её? sudo monopbx setup-url выдаст новую.
- Создайте аккаунт. E-mail, пароль, затем код из приложения-аутентификатора. Это первый администратор вашей АТС.
- Начинается 7-дневный бесплатный период. Всё уже включено. Добавьте SIP-транк, заведите внутренние номера и войдите в MonoPhone по QR-коду.
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 поверх TLS |
30000–40000/udp | RTP-звук. Без него звонок соединится, но никто никого не услышит. |
Если включён 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/udp | ePDG: IKEv2 и ESP в UDP (VoWiFi) |
|---|---|
5064, 5065 (по умолчанию) | P-CSCF: SIP от телефонов через туннель IPsec (VoLTE) |
Порт узла Diameter, tcp или sctp | Исходящее соединение к вашему HSS или PCRF |
IMS, VoLTE и VoWiFi → · Руководство для операторов →
Факты о безопасности
- Записи и файлы хранятся на диске в зашифрованном виде. Доступы к CRM и провайдерам запечатаны ключом вашей компании.
- Passkey, двухфакторный вход, единый вход через OpenID Connect, SCIM и список разрешённых IP для администраторов. Необязательная reCAPTCHA при входе со своими ключами.
- Автоблокировка IP и для SIP, и для веба, с одним списком, который можно просматривать.
- Блокировка по странам, списки разрешённых и запрещённых адресов и STIR/SHAKEN на границе SIP. SRTP можно сделать необязательным или обязательным для каждого транка.
- Журнал аудита, история изменений и резервные копии по расписанию, зашифрованные и разворачиваемые на новом хосте.
- Звонки, записи и история не проходят через нас. Только push-уведомление, которое будит телефон, использует push-ретранслятор, и установить можно без него.