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.
Máquina virtual o servidor en la nube
Ubuntu 24.04 LTS
El instalador de VM deja una instalación de un solo nodo en un servidor nuevo. El paquete apt lo incluye.
Guía de VM →Paquete de Linux
Ubuntu 24.04 LTS
Un comando instala Docker, el paquete de producción y el comando monopbx, y obtiene un certificado de Let’s Encrypt.
Guía de apt →Docker Compose
Linux de 64 bits con Docker 24+
El paquete de producción con Postgres, Valkey, ClickHouse y rtpengine, para hosts que ya administras.
Guía de Compose →Kubernetes
Kubernetes 1.30+
Manifiestos simples que se aplican con kubectl apply -k (Kustomize). No hay chart de Helm. Antes, lee las notas sobre el audio a través de NAT.
Guía de Kubernetes →
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
- 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.
- Crea tu cuenta. Correo, contraseña y luego un código de tu app de autenticación. Es el primer administrador de tu PBX.
- 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.
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/tcp | Validación del certificado, redirección a HTTPS |
|---|---|
443/tcp | Consola, API, teléfono del navegador (wss://…/sip) |
5060 udp+tcp | SIP |
5061/tcp | SIP sobre TLS |
30000–40000/udp | Audio 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/udp | ePDG: 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 sctp | Saliente hacia tu HSS o PCRF |
IMS, VoLTE y VoWiFi → · Guía para operadores →
Datos de seguridad
- Las grabaciones y los archivos se cifran en disco. Las credenciales de CRM y de proveedores se sellan con la llave de tu empresa.
- Llaves de acceso, inicio de sesión con dos factores, acceso único con OpenID Connect, SCIM y una lista de IP permitidas para administradores. reCAPTCHA opcional al iniciar sesión, con tus propias claves.
- Bloqueo automático de IP en la parte SIP y en la web, con una sola lista que puedes revisar.
- Bloqueo por país, listas de permitidos y bloqueados y STIR/SHAKEN en el borde SIP. SRTP puede ser opcional u obligatorio por troncal.
- Bitácora de auditoría, historial de cambios y respaldos cifrados programados que se restauran en un servidor nuevo.
- Las llamadas, las grabaciones y el historial nunca pasan por nosotros. Solo la notificación push que despierta al teléfono usa el relé push, y puedes instalar sin él.