Cómo configurar un servidor VoIP con Asterisk y FreePBX
Aprenda a desplegar Asterisk o FreePBX en un VPS. Configure troncales SIP, rangos de puertos RTP, reglas de firewall para evitar escaneos y prevenga el fraude telefónico.
Qué es un servidor VoIP autohospedado
Un servidor VoIP autohospedado es un servidor SIP que se ejecuta en un VPS bajo su control, por lo que sus llamadas son enrutadas por su propia máquina en lugar de por un servicio telefónico alojado. VoIP (voz sobre IP) transporta la voz como paquetes UDP. SIP (protocolo de inicio de sesión) es la señalización que establece y finaliza una llamada. El audio no viaja a través de SIP, y ese hecho causa la mayoría de los problemas descritos a continuación.
Cuatro partes conforman un sistema funcional.
- El software de PBX (centralita privada). Asterisk es la opción habitual. Contiene las extensiones y el plan de marcado.
- Los puntos finales. Teléfonos de escritorio o softphones que se registran en la PBX con un nombre de usuario y una contraseña.
- El enlace SIP (SIP trunk). Una cuenta de pago con un proveedor que le conecta a la red telefónica pública y le alquila números de teléfono reales.
- La ruta de medios. Flujos RTP (protocolo de transporte en tiempo real) que transportan el audio en sus propios puertos UDP.
Autohospedar la PBX no significa autohospedar los números de teléfono. Los números provienen de un operador, y usted sigue pagando por número y por minuto. Lo que usted posee es el enrutamiento de llamadas, el buzón de voz, las grabaciones y la lista de extensiones. También posee la seguridad de un servicio que es atacado por motivos económicos.
¿Qué puertos necesita un servidor VoIP autohospedado?
La señalización SIP utiliza el puerto 5060 para UDP y TCP, y el puerto 5061 para SIP sobre TLS (seguridad de la capa de transporte). Estos puertos solo gestionan el establecimiento de llamadas. El audio de cada llamada es un flujo UDP independiente, enviado a un puerto tomado del rango RTP. Asterisk incluye un rtp.conf de ejemplo que establece rtpstart=10000 y rtpend=20000, y los valores predeterminados compilados son 5000 y 31000. Cada llamada ocupa dos puertos de ese rango, uno para RTP y otro para RTCP (protocolo de control RTP).
Esta separación es donde fallan la mayoría de los primeros intentos. La llamada se conecta, ambos teléfonos la muestran como contestada, pero ninguna de las partes escucha nada, porque el firewall permite el 5060 y descarta todos los paquetes RTP. La señalización y el contenido multimedia son flujos separados, por lo que necesitan reglas de firewall independientes. Si esta distinción es nueva, vale la pena leer cómo funcionan los puertos y los sockets de escucha en Linux antes de abrir nada.
Reduzca el rango antes de abrirlo. Veinte mil puertos son muchos más de los que necesita un sistema pequeño. Dos puertos por llamada significan que un rango de doscientos cubre cien llamadas simultáneas.
[general]
rtpstart=10000
rtpend=10200Aplíquelo con sudo asterisk -rx "core reload".
¿Debe instalar Asterisk o FreePBX?
Asterisk es el motor. Se configura con archivos de texto en /etc/asterisk y el plan de marcación se escribe manualmente. FreePBX es una interfaz web escrita en PHP y JavaScript que funciona sobre Asterisk, genera esos archivos y añade módulos para el buzón de voz y las colas de llamadas.
En un VPS, la diferencia importante es quién controla el equipo. En octubre de 2026, el instalador oficial de FreePBX 17 espera un sistema Debian 12 sin modificaciones e instala Asterisk, un servidor web, un servidor de base de datos y PHP. Si se ejecuta en un equipo que ya proporciona otros servicios, el resultado será problemático. Asigne a FreePBX su propio VPS.
wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh
sudo bash /tmp/sng_freepbx_debian_install.shEl registro de instalación se guarda en /var/log/pbx/ con un nombre basado en una marca de tiempo con el formato freepbx17-install-YYYY.MM.DD-HH.MM.SS.log, por lo que cada ejecución tiene su propio archivo. Ese es el primer lugar que debe revisar cuando el script se detiene antes de terminar, y ls -t /var/log/pbx/freepbx17-install-*.log | head -1 encuentra el más reciente.
FreePBX administra los archivos de configuración que genera. Si edita manualmente pjsip.conf en un equipo con FreePBX, el cambio desaparecerá la próxima vez que la interfaz web escriba ese archivo. FreePBX lee archivos independientes cuyo nombre contiene _custom para la configuración escrita manualmente y no los modifica.
La diferencia real es la siguiente. FreePBX proporciona una interfaz web y expone una página de inicio de sesión del sistema telefónico en Internet pública. Asterisk sin FreePBX no tiene ninguna superficie web, y cada ajuste es una directiva documentada que puede leer en un archivo y conservar en git. Si instala FreePBX, restrinja su puerto web a su propia dirección o acceda mediante una VPN, porque una interfaz de administración para una centralita es un objetivo con una ruta directa hacia el dinero.
Nota sobre las versiones, correcta en octubre de 2026: Asterisk 22 es la versión actual con soporte a largo plazo, publicada en octubre de 2024. Tiene soporte completo hasta octubre de 2028 y después recibe únicamente correcciones de seguridad hasta su fin de vida en octubre de 2029. Asterisk 23 es la versión estándar. Asterisk 24, la siguiente versión con soporte a largo plazo, estaba programada para el 15 de octubre de 2026, pero el 27 de octubre la página de versiones de Asterisk todavía la mostraba como una versión preliminar y el servidor de descargas sólo contenía 24.0.0-rc3. Ubuntu 24.04 incluye Asterisk 20.6.0 en el repositorio universe. El proyecto upstream pasó Asterisk 20 a recibir únicamente correcciones de seguridad el 19 de octubre de 2026, y su fin de vida es en octubre de 2027. Ubuntu 26.04 incluye Asterisk 22.5.2.
Instalar Asterisk en Ubuntu 24.04
El paquete de la distribución es la vía rápida. Ubuntu lo parchea y se inicia bajo systemd de forma automática.
sudo apt update
sudo apt install -y asterisk
sudo asterisk -rx "core show version"Compilar desde el código fuente le permite obtener la versión de soporte a largo plazo (LTS) actual.
sudo apt update
sudo apt install -y build-essential wget
cd /usr/local/src
sudo wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-22-current.tar.gz
sudo tar -xzf asterisk-22-current.tar.gz
cd asterisk-22.*
sudo contrib/scripts/install_prereq install
sudo ./configure
sudo make menuselect
sudo make -j"$(nproc)"
sudo make install
sudo make samples
sudo make config
sudo ldconfiginstall_prereq install descarga las dependencias de compilación para su distribución, y install_prereq test muestra los comandos que se ejecutarían sin realizar cambios. make menuselect abre el selector de módulos, donde debe habilitar codec_opus en la sección Codec Translators. Ejecute make samples solo en una instalación limpia, ya que escribe la configuración de ejemplo en /etc/asterisk. make config instala el script de inicio en /etc/init.d/asterisk, y systemd lo gestiona a través de su capa de compatibilidad SysV, por lo que sudo systemctl enable --now asterisk funciona posteriormente.
Independientemente de la vía elegida, sudo asterisk -rvvv se conecta al daemon en ejecución y le proporciona la CLI. Ejecutar core show version en ella muestra lo que realmente ha instalado.
Configurar un trunk SIP y una extensión
PJSIP es el controlador de canal SIP en las versiones actuales de Asterisk. Su configuración reside en /etc/asterisk/pjsip.conf y se construye a partir de pequeñas secciones tipadas que se referencian entre sí por nombre. Las secciones de diferentes tipos pueden compartir el mismo nombre, razón por la cual cada bloque a continuación se denomina mytrunk.
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0
[mytrunk]
type=registration
outbound_auth=mytrunk
server_uri=sip:sip.example.com
client_uri=sip:1234567890@sip.example.com
retry_interval=60
[mytrunk]
type=auth
auth_type=userpass
username=1234567890
password=REPLACE_WITH_A_LONG_RANDOM_SECRET
[mytrunk]
type=aor
contact=sip:sip.example.com:5060
[mytrunk]
type=endpoint
context=from-trunk
disallow=all
allow=ulaw
outbound_auth=mytrunk
aors=mytrunk
[mytrunk]
type=identify
endpoint=mytrunk
match=sip.example.comEl objeto registration envía el REGISTER que indica a su proveedor dónde entregar sus llamadas. El objeto identify es el método mediante el cual una llamada que llega del proveedor se vincula a este endpoint según la dirección de origen; los proveedores suelen publicar varias direcciones para listar ahí. El registro saliente y el endpoint son objetos separados a propósito: uno indica al proveedor dónde se encuentra usted, el otro decide qué sucede con las llamadas.
Un teléfono de escritorio requiere tres objetos adicionales.
[6001]
type=endpoint
context=internal
disallow=all
allow=ulaw
auth=auth6001
aors=6001
direct_media=no
[auth6001]
type=auth
auth_type=userpass
username=6001
password=REPLACE_WITH_A_LONG_RANDOM_SECRET
[6001]
type=aor
max_contacts=1direct_media=no mantiene a Asterisk en la ruta de medios. Si lo omite, Asterisk intentará que los dos endpoints envíen RTP directamente entre sí, lo cual falla cuando un teléfono se encuentra detrás de NAT (traducción de direcciones de red) en un router doméstico. Nunca permita que la contraseña coincida con el número de extensión. El ejemplo superior utiliza password=6001 para la extensión 6001 para mantener la legibilidad, pero los escáneres prueban exactamente ese patrón primero.
El plan de marcado en /etc/asterisk/extensions.conf decide qué acciones están permitidas en cada contexto.
[internal]
exten => 6001,1,Dial(PJSIP/6001,20)
exten => _9X.,1,Dial(PJSIP/${EXTEN:1}@mytrunk,60)
[from-trunk]
exten => 1234567890,1,Dial(PJSIP/6001,20)
same => n,Hangup()Esos dos contextos constituyen un límite de seguridad. from-trunk gestiona las llamadas que llegan del proveedor y solo puede hacer sonar la extensión 6001. No puede alcanzar el patrón _9X., por lo que una llamada desde el exterior no puede realizar llamadas salientes a través de su trunk. Si fusiona los contextos, habrá creado la ruta clásica para el fraude telefónico: un extraño llama a su número, su plan de marcado realiza llamadas a través de su cuenta y usted paga por ello.
Aplique la configuración y verifíquela.
sudo asterisk -rx "pjsip reload"
sudo asterisk -rx "pjsip show registrations"
sudo asterisk -rx "pjsip show endpoints"pjsip show registrations debería listar mytrunk con el estado Registered. Rejected significa que el proveedor rechazó sus credenciales. Unregistered significa que su REGISTER no recibe respuesta, por lo que debe revisar el firewall a continuación.
Reglas del firewall para SIP y RTP
La señalización y los medios requieren un tratamiento diferente porque tienen riesgos distintos. Restrinja el puerto 5060 a las direcciones que realmente usa su proveedor y a las redes donde están sus teléfonos.
sudo ufw allow proto udp from 203.0.113.10 to any port 5060
sudo ufw allow proto tcp from 203.0.113.10 to any port 5060
sudo ufw allow 10000:10200/udp
sudo ufw status verboseEl rango RTP es la parte que no puede reducir tanto, porque los medios suelen llegar desde una dirección diferente de la señalización. Pida a su proveedor las subredes que usa para los medios y restrinja el acceso a ellas si las publica. Mantenga el rango tan reducido como lo requiera su hora de mayor actividad. Las políticas predeterminadas, el orden de las reglas y el resto del modelo de ufw se explican en la guía básica del firewall ufw para un VPS.
Compruebe también IPv6. ufw permite IPv6 de forma predeterminada, y una regla sin dirección de origen, como la regla RTP anterior, se aplica a ambas familias. Las reglas para 5060 especifican un origen IPv4, por lo que sólo coinciden con IPv4. Un proveedor que use IPv6 para la señalización necesita sus propias reglas. Establecer IPV6=no en /etc/default/ufw y volver a cargar ufw no deja IPv6 sin filtrar: restringe el tráfico IPv6 a la interfaz de loopback. Apertura de puertos para IPv6 con ufw explica las diferencias entre ambas familias. La mayoría de los proveedores también ofrecen un firewall de red independiente en el panel de control. Ese firewall se aplica antes de que los paquetes lleguen al VPS, por lo que el puerto debe estar abierto en ambos lugares.
Los ataques de fuerza bruta contra SIP y el fraude de tarificación no son problemas opcionales
Exponga 5060 en una dirección pública y comenzarán los escaneos. El patrón es constante: solicitudes REGISTER e INVITE desde muchas direcciones de origen que prueban números de extensión habituales con secretos habituales. Asterisk registra cada fallo, y la línea tiene este formato.
Request 'REGISTER' from '<sip:1000@198.51.100.20>' failed for '198.51.100.20:5060' (callid: 5f1a5c0d) - No matching endpoint foundLa razón por la que esto requiere un esfuerzo real es económica. Una extensión robada se utiliza para realizar llamadas internacionales costosas, a menudo a números de tarificación especial que pagan una parte al atacante. La factura la paga usted porque las llamadas utilizaron sus credenciales. El proceso funciona a la velocidad de una máquina y normalmente se ejecuta durante la noche.
Hay seis controles obligatorios, no medidas de endurecimiento opcionales.
- No cree nunca una extensión cuyo secreto sea su propio número o una palabra corta. Genere uno con
openssl rand -base64 24y péguelo. - Mantenga desactivadas las llamadas entrantes anónimas. PJSIP rechaza las llamadas no identificadas de forma predeterminada y sólo las acepta si crea un endpoint llamado
anonymous. No cree uno. - Mantenga separado el contexto del trunk de cualquier contexto que permita realizar llamadas, como se muestra arriba.
- Restrinja la señalización por dirección de origen, tanto en ufw como en el firewall de red de su proveedor.
- Establezca un límite de gasto con su proveedor de SIP trunk y desactive los destinos internacionales a los que nunca llama. Este es el único control que limita la pérdida cuando fallan los demás.
- Ejecute fail2ban contra el registro de Asterisk.
Asterisk también genera un evento de seguridad cuando una solicitud no coincide con ningún endpoint, y fail2ban puede actuar sobre esos eventos. La sección [global] de pjsip.conf acepta unidentified_request_count, cuyo valor predeterminado es 5, y unidentified_request_period, cuyo valor predeterminado es 5 segundos, pero sólo se aplican cuando auth_username aparece en endpoint_identifier_order. Ese método debe aplazar el evento hasta que llegue una solicitud con credenciales. Entonces, esos dos ajustes determinan cuántas solicitudes sin coincidencia procedentes de una dirección dentro del período deben producirlo. Con el orden predeterminado de ip,username,anonymous, las solicitudes sin coincidencia generan eventos de seguridad sin ese aplazamiento.
Bloquear los escáneres con fail2ban
fail2ban incluye una asterisk jail ya redactada. Cubre los puertos 5060 y 5061, lee /var/log/asterisk/messages y utiliza maxretry = 10 por defecto. La jail permanece desactivada hasta que usted la habilita en /etc/fail2ban/jail.local.
[asterisk]
enabled = true
maxretry = 5
findtime = 600
bantime = 86400sudo systemctl restart fail2ban
sudo fail2ban-client status asteriskUn resultado correcto muestra el archivo de registro de la jail y un recuento de las direcciones bloqueadas actualmente. En un puerto 5060 público, ese recuento deja de ser cero en menos de un día. El filtro incluido coincide con los avisos de No matching endpoint found anteriores y también con las líneas estructuradas de SecurityEvent de Asterisk. Esos eventos se dirigen a un canal de registro independiente que aparece comentado en /etc/asterisk/logger.conf, por lo que debe habilitarlo allí y añadir el archivo a la configuración logpath de la jail si desea utilizarlos.
[logfiles]
console => notice,warning,error
messages.log => notice,warning,error
security.log => securityRecargue el registrador con sudo asterisk -rx "logger reload". El filtro también contiene un journalmatch para asterisk.service, por lo que un backend de journal funciona si prefiere no mantener archivos de registro. La instalación, la estructura de jail.local y cómo desbloquear una dirección que usted mismo bloqueó se tratan en la guía de fail2ban para Ubuntu 24.04.
Latencia y elección de códec en un VPS distante
El retardo viene determinado por la geografía y no se puede eliminar mediante configuración. La norma ITU-T G.114 recomienda mantener el retardo unidireccional por debajo de 150 ms para una conversación normal y considera aceptables valores de hasta 400 ms. El audio de un teléfono viaja a su VPS y luego al proveedor de troncales, por lo que un VPS en una región inadecuada duplica ese trayecto. Ubíquelo cerca de los teléfonos o cerca del proveedor; priorice la cercanía a los teléfonos cuando ambos puntos estén en direcciones opuestas, ya que ese tramo suele transcurrir por redes de consumo donde el jitter es mayor.
La elección del códec determina el ancho de banda por llamada. Cada códec aquí envía un paquete cada 20 ms, lo que equivale a 50 paquetes por segundo, y cada paquete transporta 40 bytes de cabeceras IP, UDP y RTP además de la carga útil de audio.
Los datos de este gráfico
[
{
"label": "G.711 ulaw",
"payload_kbps": 64,
"ip_kbps": 80
},
{
"label": "G.722",
"payload_kbps": 64,
"ip_kbps": 80
},
{
"label": "Opus at 24 kbps",
"payload_kbps": 24,
"ip_kbps": 40
},
{
"label": "G.729",
"payload_kbps": 8,
"ip_kbps": 24
}
]G.711 ulaw es el valor predeterminado en la mayoría de las troncales. Su carga útil es de 64 kbps y, sumando las cabeceras, una llamada en curso consume 80 kbps en cada dirección. Opus a 24 kbps se sitúa en 40 kbps, y G.729 se reduce a 24 kbps a costa de la calidad de audio y del tiempo de CPU. Estas cifras son cálculos aritméticos de cabeceras, no mediciones: tasa de carga útil más 40 bytes por paquete a 50 paquetes por segundo. El entramado Ethernet o VLAN añade un poco más en el medio físico.
La transcodificación consume CPU. Si sus teléfonos y su troncal utilizan ulaw, permita solo ulaw y Asterisk transmitirá el audio sin procesar. Opus funciona bien en enlaces con pérdidas, pero la transcodificación entre Opus y G.711 requiere el módulo externo codec_opus, que se selecciona en make menuselect y que no se compila de forma predeterminada.
Qué falla y qué texto verá
La llamada se conecta y nadie oye nada. No llega RTP. Confirme que el rango de rtp.conf sea el que abrió en el firewall y, mientras realiza una llamada, observe los paquetes con sudo tcpdump -ni any udp portrange 10000-10200. Una captura vacía sólo indica que no se encontró ningún paquete que coincidiera con el filtro. Es posible que los paquetes se detengan antes de llegar al servidor, por ejemplo en el firewall de red de su proveedor. También es posible que el extremo remoto los envíe a otra dirección o a un puerto fuera de este filtro. Compare los datos con la dirección y el puerto de medios que muestra pjsip set logger on en el SDP.
El audio sólo funciona en una dirección. Un extremo envía RTP a una dirección que no puede recibirlo. Es un problema de dirección, no de puerto. Si su VPS tiene la dirección pública directamente en su interfaz, no necesita gestionar NAT. Si el proveedor asigna al VPS una dirección privada con una asignación pública uno a uno, configure la dirección pública en el transporte e indique el rango privado en local_net.
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0
local_net=10.0.0.0/8
external_media_address=198.51.100.5
external_signaling_address=198.51.100.5No matching endpoint found en el registro. La solicitud no coincidió con ningún endpoint por dirección IP ni por nombre de usuario. Esto es normal cuando procede de un escáner y fail2ban lo gestionará. Si procede de su propio proveedor, significa que la sección identify no incluye la dirección desde la que le llaman.
El estado del registro es Rejected. El proveedor rechazó las credenciales de la sección auth. Ejecute pjsip set logger on en la CLI, observe un REGISTER y su respuesta, y compare client_uri y username con los datos que le proporcionó el proveedor.
No aparece nada útil en el registro. De forma predeterminada, Asterisk escribe en messages.log los mensajes de nivel notice y superiores. Aumente el nivel con core set verbose 4 y pjsip set logger on mientras reproduce el problema. Después desactive ambas opciones, porque el registrador SIP escribe cada paquete.
Antes de exponerlo
Una centralita PBX no es como otros servicios que aloja usted mismo. Una aplicación web que falla solo le cuesta una página inaccesible. Una PBX que falla se convierte en una factura telefónica elevada en cuestión de horas, mientras usted duerme. Ejecútela en un VPS dedicado exclusivamente a esta tarea, restrinja el puerto 5060 a direcciones conocidas, asigne una contraseña aleatoria a cada extensión y establezca un límite de gasto en la cuenta del troncal. El resto del servidor requiere la misma configuración base que cualquier otro equipo expuesto, la cual se detalla en este análisis sobre la seguridad real del alojamiento VPS.
FAQ
¿Qué puertos debo abrir para un servidor VoIP autohospedado?
El puerto 5060 para la señalización SIP mediante UDP y TCP, el puerto 5061 si usa SIP mediante TLS y un rango de puertos UDP para el tráfico multimedia RTP. El ejemplo de Asterisk rtp.conf usa del 10000 al 20000, y los valores predeterminados compilados son del 5000 al 31000. Cada llamada consume dos puertos del rango, por lo que un rango de doscientos puertos admite cien llamadas simultáneas. Abra el rango RTP como UDP y restrinja 5060 a las direcciones de su proveedor y a sus propias redes, en lugar de dejarlo abierto a todo el mundo.
¿Debo instalar Asterisk por separado o usar FreePBX?
Instale Asterisk sin interfaz adicional si quiere una superficie de ataque reducida, archivos de configuración que pueda mantener en git y está dispuesto a escribir el dialplan. Instale FreePBX si quiere una interfaz gráfica para extensiones, buzón de voz y colas de llamadas. En octubre de 2026, el instalador de FreePBX 17 espera una máquina Debian 12 estándar e instala Asterisk, un servidor web, un servidor de bases de datos y PHP, por lo que debe asignarle un VPS propio. FreePBX regenera los archivos de configuración que administra, así que las modificaciones manuales deben hacerse en sus archivos _custom.
¿Por qué no hay audio después de conectar la llamada?
La señalización funcionó, pero el tráfico multimedia no. SIP estableció la llamada mediante el puerto 5060, y el audio usa un flujo UDP independiente hacia un puerto del rango RTP que algo está descartando. Compruebe que el rango de rtp.conf coincida con el rango abierto en el firewall y revise también el firewall de red de su proveedor, además del firewall del servidor. Ejecute sudo tcpdump -ni any udp portrange 10000-10200 durante una llamada. Una captura vacía sólo significa que no se observaron paquetes coincidentes: pueden estar bloqueados antes de llegar o enviarse a una dirección o un puerto que quede fuera del filtro.
¿Cómo detengo los ataques de fuerza bruta contra SIP y el fraude de tarificación?
Asigne a cada extensión un secreto aleatorio largo, que nunca coincida con su número de extensión. Mantenga separado el context usado por su trunk de cualquier context que pueda realizar llamadas salientes, para que una llamada entrante no pueda volver a salir mediante su cuenta. Restrinja el puerto 5060 a las direcciones de su proveedor. Habilite el jail asterisk en fail2ban; este lee /var/log/asterisk/messages y bloquea las direcciones que producen No matching endpoint found fallos. Después establezca un límite de gasto y bloquee los destinos internacionales no utilizados con su proveedor, porque ese es el único control que limita la pérdida si todo lo demás falla.
¿Un VPS en una región distante perjudica la calidad de las llamadas?
Sí, porque el audio recorre dos tramos: del teléfono al VPS y del VPS al proveedor del trunk. ITU-T G.114 recomienda una latencia unidireccional inferior a 150 ms, y un VPS mal ubicado puede consumir gran parte de ese margen sólo por la distancia. Elija una región cercana a los teléfonos, ya que ese tramo suele utilizar Internet residencial, donde la variación del retardo suele ser mayor. El códec no puede eliminar la latencia de red. Modifica el ancho de banda y añade cierta latencia propia de codificación y paquetización (RFC 6716 indica latencias algorítmicas de Opus de 5 ms a 65.2 ms), por lo que G.729 ahorra bytes, pero no solucionará una ruta de 200 ms.