Datos técnicos

De qué está hecho MonoPbx, dónde corre y cómo se instala. La versión corta para quien decide y el detalle para quien administra.

De un vistazo

Arquitectura
Un agente de usuario SIP back-to-back escrito en Rust, rtpengine para el audio, una consola web y API REST, PostgreSQL para la configuración, Valkey para caché y eventos y ClickHouse para el historial y la analítica de llamadas.
Señalización
SIP sobre UDP, TCP y TLS. SIP sobre WebSocket para el teléfono del navegador.
Audio
RTP y SRTP con rtpengine, WebRTC para navegadores, STUN y TURN para teléfonos detrás de NAT.
Códecs
Opus, G.722, G.711, G.729. AMR y AMR-WB para teléfonos con IMS, con transcodificación.
Varias empresas
Una instalación puede alojar muchas empresas. Sus datos se mantienen separados fila por fila en PostgreSQL.
API
REST con documento OpenAPI, webhooks firmados, un WebSocket de eventos y un servidor MCP.
Idiomas
Consola y apps en nueve idiomas: inglés, español (México), portugués (Brasil), francés, alemán, italiano, ruso, chino y japonés.

Escala

En nuestro laboratorio, un nodo pequeño sostuvo 600 llamadas simultáneas con audio. Ninguna llamada falló y el establecimiento de la llamada tardó menos de 150 ms en el percentil 95. Se midió en una sola máquina de desarrollo compartida, así que tómalo como un orden de magnitud. Para tu sitio, usa la calculadora de dimensionamiento. Calculadora de dimensionamiento →

Requisitos y sistemas compatibles

Paquete de Linux e instalador para VM
Ubuntu 24.04 LTS, amd64 o arm64.
Docker Compose
Cualquier servidor Linux de 64 bits con Docker 24 o superior y Compose 2.24 o superior.
Kubernetes
Versión 1.30 o superior. Manifiestos simples con Kustomize.
Equipo para empezar
2 CPU, 4 GB de RAM, 20 GiB libres en /var/lib.
Red
Una dirección IP pública. Un nombre DNS es opcional.
Modo IMS
Opcional. El P-CSCF y el ePDG corren en Linux y necesitan CAP_NET_ADMIN. Mira la sección de IMS más abajo.

Instala en tu propio servidor o en una VM en la nube

En cualquier proveedor de nube o en tu propio hardware, crea una máquina virtual con Ubuntu 24.04, abre los puertos de la lista y ejecuta el instalador de una línea. Cada método instala el mismo MonoPbx.

Paquete de Linux, paso a paso

En un servidor nuevo con Ubuntu 24.04 e IP pública, ejecuta:

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

La configuración pide un correo para el certificado de Let’s Encrypt. Agrega también tu dominio; sin --domain el servidor se llama <ip>.sslip.io:

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

Después

  1. Abre la consola. Al final, el instalador imprime la dirección de tu consola y un enlace de configuración de un solo uso. ¿Lo perdiste? sudo monopbx setup-url te da otro.
  2. Crea tu cuenta. Correo, contraseña y luego un código de tu app de autenticación. Es el primer administrador de tu PBX.
  3. Empieza tu prueba gratis de 7 días. Todo viene encendido. Agrega una troncal SIP, crea extensiones y entra a MonoPhone con el código QR.
ubuntu@pbx:~Así termina la instalación
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

Puertos

80/tcpValidación del certificado, redirección a HTTPS
443/tcpConsola, API, teléfono del navegador (wss://…/sip)
5060 udp+tcpSIP
5061/tcpSIP sobre TLS
30000–40000/udpAudio RTP. Sin estos puertos la llamada conecta, pero nadie se oye.

Si ufw está activo, la configuración abre estos puertos. Abre los mismos en el firewall de tu nube.

Modo IMS (VoLTE y VoWiFi)

Es opcional y está apagado hasta que un administrador lo activa. Convierte a MonoPbx en el núcleo IMS de tus propias tarjetas SIM.

Componentes
El motor de la PBX, un rol P-CSCF opcional para VoLTE y un ePDG opcional (mpbx-epdg) para VoWiFi. Se comunican por enlaces autenticados en una red privada.
Protocolos
SIP con IPsec (TS 33.203), IKEv2 con EAP-AKA’, Diameter Cx y Rx sobre TCP o SCTP con TLS opcional, HTTP Nudm y N5, SMS sobre IMS.
Datos de abonados
En MonoPbx, en tu HSS por Diameter Cx o en un UDM 5G por Nudm.
Requisitos
Linux para el P-CSCF y el ePDG, con CAP_NET_ADMIN. Una dirección pública y un certificado para el ePDG. Las claves de las SIM, o un HSS o UDM que las guarde. Un servidor de medios que codifique AMR si usas códecs móviles.
500, 4500/udpePDG: IKEv2 y ESP sobre UDP (VoWiFi)
5064, 5065 (por omisión)P-CSCF: SIP de los teléfonos por el túnel IPsec (VoLTE)
Puerto del par Diameter, tcp o sctpSaliente hacia tu HSS o PCRF

IMS, VoLTE y VoWiFi → · Guía para operadores →

Datos de seguridad

Para profundizar

Prueba gratuita Agendar una demo