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.
Máquina virtual ou servidor na nuvem
Ubuntu 24.04 LTS
O instalador de VM configura uma instalação de nó único em um servidor novo. O pacote apt o inclui.
guia de VM →Pacote Linux
Ubuntu 24.04 LTS
Um comando instala o Docker, o pacote de produção e o comando monopbx, e obtém um certificado Let’s Encrypt.
guia do apt →Docker Compose
Linux de 64 bits com Docker 24+
O pacote de produção com Postgres, Valkey, ClickHouse e rtpengine, para hosts que você já administra.
guia do Compose →Kubernetes
Kubernetes 1.30+
Manifestos simples aplicados com kubectl apply -k (Kustomize). Não há chart do Helm. Leia antes as notas sobre mídia atrás de NAT.
guia do Kubernetes →
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
- 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.
- Crie sua conta. E-mail, senha e depois um código do seu app autenticador. Este é o primeiro administrador do seu PBX.
- 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.
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/tcp | Desafio do certificado, redirecionamento para HTTPS |
|---|---|
443/tcp | Console, API, telefone no navegador (wss://…/sip) |
5060 udp+tcp | SIP |
5061/tcp | SIP 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/udp | ePDG: 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 sctp | Saída para o seu HSS ou PCRF |
IMS, VoLTE e VoWiFi → · Guia do operador →
Fatos de segurança
- Gravações e arquivos são criptografados em disco. As credenciais de CRM e de provedores são seladas com a chave da sua empresa.
- Passkeys, login com dois fatores, login único com OpenID Connect, SCIM e uma lista de IPs permitidos para administradores. reCAPTCHA opcional no login com as suas próprias chaves.
- Bloqueios automáticos de IP no lado SIP e no lado web, com uma única lista que você pode revisar.
- Bloqueio geográfico, listas de permissão e bloqueio e STIR/SHAKEN na borda SIP. O SRTP pode ser opcional ou obrigatório por tronco.
- Registro de auditoria, histórico de alterações e backups criptografados agendados que restauram em um novo host.
- Chamadas, gravações e histórico nunca passam por nós. Apenas a notificação push que acorda o celular usa o relay de push, e você pode instalar sem ele.