Dados técnicos

Do que o MonoPbx é feito, onde ele roda e como instalá-lo. A versão curta para quem decide e os detalhes para quem administra.

Resumo

Arquitetura
Um SIP back-to-back user agent escrito em Rust, rtpengine para a mídia, um console web e API REST, PostgreSQL para a configuração, Valkey para cache e eventos, ClickHouse para o histórico de chamadas e a análise.
Sinalização
SIP sobre UDP, TCP e TLS. SIP sobre WebSocket para o telefone no navegador.
Mídia
RTP e SRTP por meio do rtpengine, WebRTC para navegadores, STUN e TURN para telefones atrás de NAT.
Codecs
Opus, G.722, G.711, G.729. AMR e AMR-WB para aparelhos IMS, com transcodificação.
Várias empresas
Uma instalação pode hospedar muitas empresas. Os dados delas ficam separados linha por linha no PostgreSQL.
API
REST com um documento OpenAPI, webhooks assinados, um WebSocket de eventos e um servidor MCP.
Idiomas
Console e apps em nove idiomas: inglês, espanhol (México), português (Brasil), francês, alemão, italiano, russo, chinês e japonês.

Escala

No nosso laboratório, um nó pequeno suportou 600 chamadas simultâneas com mídia. Nenhuma chamada falhou, e o estabelecimento da chamada levou menos de 150 ms no percentil 95. Isso foi medido em uma única máquina de desenvolvimento compartilhada, então trate como uma ordem de grandeza. Para o seu próprio ambiente, use a calculadora de dimensionamento. Calculadora de dimensionamento →

Requisitos e sistemas suportados

Pacote Linux e instalador de VM
Ubuntu 24.04 LTS, amd64 ou arm64.
Docker Compose
Qualquer host Linux de 64 bits com Docker 24 ou mais recente e Compose 2.24 ou mais recente.
Kubernetes
Versão 1.30 ou mais recente. Manifestos simples com Kustomize.
Máquina para começar
2 CPUs, 4 GB de RAM, 20 GiB livres em /var/lib.
Rede
Um endereço IP público. Um nome DNS é opcional.
Modo IMS
Opcional. O P-CSCF e o ePDG rodam em Linux e precisam de CAP_NET_ADMIN. Veja a seção de IMS abaixo.

Instale no seu próprio servidor ou VM na nuvem

Em qualquer provedor de nuvem ou no seu próprio hardware, crie uma máquina virtual com Ubuntu 24.04, abra as portas listadas abaixo e rode o instalador de uma linha. Todos os métodos instalam o mesmo MonoPbx.

Pacote Linux, passo a passo

Em um servidor Ubuntu 24.04 novo, com IP público, execute:

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

A configuração pede um e-mail para o certificado Let’s Encrypt. Informe também o seu próprio domínio; sem --domain o servidor recebe o nome <ip>.sslip.io:

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

Depois

  1. Abra o console. O instalador termina exibindo o endereço do seu console e um link de configuração de uso único. Perdeu? sudo monopbx setup-url exibe um novo.
  2. Crie sua conta. E-mail, senha e depois um código do seu app autenticador. Este é o primeiro administrador do seu PBX.
  3. Seu teste grátis de 7 dias começa. Tudo vem ativado. Adicione um tronco SIP, crie ramais e entre no MonoPhone com o QR code.
ubuntu@pbx:~Como fica o final da instalação
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

Portas

80/tcpDesafio do certificado, redirecionamento para HTTPS
443/tcpConsole, API, telefone no navegador (wss://…/sip)
5060 udp+tcpSIP
5061/tcpSIP sobre TLS
30000–40000/udpÁudio RTP. Sem ela as chamadas completam, mas ninguém ouve nada.

Se o ufw estiver ativo, a configuração abre essas portas. Abra as mesmas no firewall da sua nuvem.

Modo IMS (VoLTE e VoWiFi)

Opcional e desligado até um administrador ativá-lo. Ele transforma o MonoPbx no core IMS dos seus próprios chips SIM.

Componentes
O motor do PBX, um papel opcional de P-CSCF para VoLTE e um ePDG opcional (mpbx-epdg) para VoWiFi. Eles se comunicam por enlaces autenticados em uma rede privada.
Protocolos
SIP com IPsec (TS 33.203), IKEv2 com EAP-AKA’, Diameter Cx e Rx sobre TCP ou SCTP com TLS opcional, HTTP Nudm e N5, SMS sobre IMS.
Dados de assinantes
Mantidos no MonoPbx, ou no seu HSS por Diameter Cx, ou em um UDM 5G por Nudm.
Requisitos
Linux para o P-CSCF e o ePDG, com CAP_NET_ADMIN. Um endereço público e um certificado para o ePDG. Chaves de SIM, ou um HSS ou UDM que as guarde. Um servidor de mídia capaz de codificar AMR se você usar codecs móveis.
500, 4500/udpePDG: IKEv2 e ESP em UDP (VoWiFi)
5064, 5065 (padrões)P-CSCF: SIP dos aparelhos pelo túnel IPsec (VoLTE)
Porta do peer Diameter, tcp ou sctpSaída para o seu HSS ou PCRF

IMS, VoLTE e VoWiFi → · Guia do operador →

Fatos de segurança

Aprofunde-se

Começar teste grátis Agendar uma demonstração