ACLClouds
ACLClouds

¿Cómo instalar FreePBX 17 en un VPS con Debian 12?

Instalar FreePBX 17 y Asterisk con el script oficial, abrir los puertos SIP y RTP, ajustar el NAT, crear una extensión y un trunk SIP y proteger la

FreePBX es una interfaz web libre para Asterisk, el software de centralita telefónica (IP PBX). Instalado en un VPS, gestiona las extensiones del equipo, las líneas SIP del operador, el buzón de voz, las colas de llamadas y los horarios, sin hardware en la oficina. La versión 17 se instala con un script oficial de Sangoma que solo admite Debian 12.

Procedimiento paso a paso

  1. Preparar un VPS con Debian 12

    Elija Debian 12 al hacer el pedido o reinstale el VPS con este sistema: el script espera una instalación limpia, sin servidor web ni base de datos ya instalados. Después conéctese por SSH como root.

  2. Actualizar y dar nombre a la máquina

    Ejecute apt update && apt upgrade -y y reinicie si se instaló un kernel nuevo. Dé al VPS un nombre completo (FQDN) como pbx.example.com con hostnamectl set-hostname y una línea en /etc/hosts: el script se detiene si hostname -f no devuelve nada.

  3. Ejecutar el script oficial

    Descargue sng_freepbx_debian_install.sh del repositorio de GitHub FreePBX/sng_freepbx_debian_install y ejecútelo con bash. Instala Asterisk 22, FreePBX, Apache, PHP 8.2, MariaDB, Fail2ban y los módulos básicos; cuente de 15 a 30 minutos. El registro detallado se escribe en /var/log/pbx/.

  4. Crear la cuenta de administrador

    Abra http://VPS_IP/ en el navegador. FreePBX pide un nombre de usuario, una contraseña y una dirección de correo para las notificaciones. La activación con Sangoma es opcional: sirve para los módulos comerciales.

  5. Abrir los puertos SIP y RTP

    En el «Cortafuegos» del panel de ACLClouds, autorice 5060/UDP para la señalización SIP y el rango 10000-20000/UDP para la voz (RTP). Limite 80 y 443/TCP, la interfaz de administración, a su dirección IP.

  6. Ajustar el NAT y crear una extensión

    En «Settings» > «Asterisk SIP Settings», haga clic en «Detect Network Settings» para rellenar la dirección externa y las redes locales. Después cree una extensión PJSIP en «Applications» > «Extensions», configúrela en un softphone y haga clic en «Apply Config».

Dar nombre a la máquina e instalar FreePBX 17

apt update && apt upgrade -y
hostnamectl set-hostname pbx.example.com
echo "127.0.1.1 pbx.example.com pbx" >> /etc/hosts
hostname -f
wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh
bash /tmp/sng_freepbx_debian_install.sh

Comandos útiles después de la instalación

fwconsole restart
fwconsole reload
fwconsole ma upgradeall
fwconsole chown
asterisk -rvvv

En la consola de Asterisk

pjsip show endpoints
pjsip show registrations
core show channels

Antes de empezar

Una centralita FreePBX necesita pocos recursos para un equipo pequeño: la carga viene sobre todo del número de llamadas simultáneas, de la grabación de llamadas y de la transcodificación entre códecs. También necesita un trunk SIP, es decir, una línea de un operador de telefonía IP, para llamar al exterior y recibir las llamadas de sus números.

  • Debian 12 (bookworm) es el único sistema que acepta el script de FreePBX 17; rechaza Debian 13 y bloquea esa actualización.
  • El VPS debe conservar la misma dirección IP: el operador y los teléfonos se basan en ella.
  • Por defecto, el script instala también los módulos comerciales de Sangoma, entre ellos System Admin y Firewall; la opción --opensourceonly los elimina, módulo Firewall incluido.

Añadir un trunk SIP

En «Connectivity» > «Trunks», añada un trunk PJSIP con los datos del operador: servidor SIP, usuario, contraseña y, según el plan, registro o autenticación por dirección IP. Después cree una ruta entrante («Inbound Routes») por número y una ruta saliente («Outbound Routes») con los formatos de número autorizados.

Si el operador autentica por dirección IP, facilítele la IPv4 del VPS y abra 5060/UDP en el cortafuegos solo a sus direcciones.

Proteger la centralita

Un puerto SIP público recibe intentos de conexión automáticos en las horas siguientes a su puesta en línea. El riesgo principal es el fraude: llamadas a números de tarificación especial o internacionales hechas desde una extensión pirateada y facturadas en su cuenta del operador.

  • Mantenga Fail2ban, que instala el script: banea las direcciones tras varios fallos de autenticación SIP.
  • Dé a cada extensión una clave larga y aleatoria, nunca el número de la extensión.
  • Rechace las llamadas anónimas: ponga «Allow Anonymous Inbound SIP Calls» y «Allow SIP Guests» en «No» en «Asterisk SIP Settings».
  • Limite las rutas salientes a los destinos útiles y pida al operador un límite de gasto o el bloqueo de los números de tarificación especial e internacionales.

Errores habituales y soluciones

La mayoría de los problemas de voz vienen del NAT o de los puertos RTP. pjsip show endpoints y el registro /var/log/asterisk/full dan la causa casi siempre.

  • Llamada establecida pero sin sonido, o con sonido en un solo sentido: el rango 10000-20000/UDP está cerrado o la dirección externa está vacía en «Asterisk SIP Settings». Corríjalo y haga clic en «Apply Config».
  • La extensión no se registra y recibe 401 Unauthorized: usuario o clave incorrectos. Si después de varios intentos ya no recibe ninguna respuesta, Fail2ban ha baneado su dirección.
  • El script se detiene con Unsupported OS version: el sistema no es Debian 12. Reinstale el VPS con Debian 12 y vuelva a ejecutarlo.
  • El script se detiene en Fully qualified domain name (FQDN) is not set correctly: dé a la máquina un nombre completo con hostnamectl y /etc/hosts.
  • La interfaz muestra una página en blanco o un error tras una actualización: ejecute fwconsole chown y luego fwconsole restart.

¿Qué VPS para FreePBX?

En ACLClouds, a 17 de noviembre de 2026, el VPS Mini (2 vCPU, 8 GB de RAM, 40 GB de almacenamiento) cuesta 4,99 € al mes sin permanencia, o 3,99 € al mes con permanencia de un año: suficiente para la centralita de una pequeña empresa y sus buzones de voz. El VPS Essentiel (4 vCPU, 16 GB de RAM, 80 GB), a 9,99 € al mes, deja margen para grabar llamadas y mantener muchas comunicaciones simultáneas. La red llega hasta 1 Gbit/s; una llamada en G.711 consume unos 90 kbit/s en cada sentido.

Verificación rápida

  • http://VPS_IP/ muestra el inicio de sesión de FreePBX.
  • pjsip show endpoints muestra la extensión disponible.
  • Una llamada entre dos extensiones funciona con sonido en ambos sentidos.
  • El trunk aparece como registrado en pjsip show registrations.
  • La interfaz de administración solo es accesible desde sus direcciones.

Preguntas frecuentes

¿FreePBX es gratuito?

Sí. FreePBX y Asterisk son software libre, sin licencia por extensión. Solo algunos módulos comerciales de Sangoma son de pago, como EndPoint Manager; una centralita completa funciona sin ellos. Las llamadas al exterior las factura su operador SIP.

¿Se puede instalar FreePBX 17 en Debian 13 o Ubuntu?

No con el script oficial, que se detiene en cualquier sistema que no sea Debian 12. Una instalación manual sigue siendo posible, pero Sangoma no le da soporte: para una centralita en producción, elija Debian 12.

¿Hace falta un certificado HTTPS para la interfaz?

Es recomendable en cuanto abra la interfaz o el portal de usuarios (UCP) a Internet. Haga apuntar un nombre de dominio al VPS y solicite un certificado Let’s Encrypt; el módulo «Certificate Management» de FreePBX también puede obtenerlo y renovarlo.

¿Cuántas llamadas simultáneas soporta un VPS pequeño?

Sin transcodificación ni grabación, unas decenas de llamadas caben en 2 vCPU: Asterisk sobre todo reenvía paquetes. La transcodificación (por ejemplo de G.722 a G.729) y la grabación de cada llamada aumentan claramente la carga de CPU y disco. Mida con core show channels en horas punta antes de añadir extensiones.