Instalando el SBC 3CX en Raspberry Pi 5

Introducción

Esta guía tiene como objetivo explicar la instalación del SBC de 3CX en un Raspberry Pi 5.

El SBC de 3CX es compatible con el SO Raspberry Pi basado en Debian-12 (Bookworm) y Debian-13 (Trixie).

Importante: 3CX recomienda el SO Raspberry Pi de 64 bits (arm64) para todas las instalaciones en Raspberry Pi 5. La versión de 32 bits (armhf) podría seguir funcionando, pero 3CX ya no la prueba ni la valida de manera rutinaria.

Paso 1: Obtenga la Raspberry Pi Correcta

  • Un Raspberry Pi 5 - 4GB / 8GB.
  • Una tarjeta microSD de buena reputación, preferiblemente con clasificación de resistencia.
  • El tamaño mínimo de la tarjeta es de 32 GB; si desea manejar archivos de registro más grandes con fines de resolución de problemas, debería considerar una tarjeta de mayor capacidad.
  • Asegúrese de que el dispositivo tiene un buen armazón que permita la máxima refrigeración.
  • Una carcasa con enfriamiento activo o un Enfriador Activo para Raspberry Pi.
  • Un cargador USB-C de alta calidad de 5V y 5A.
  • Lo ideal sería la fuente de alimentación oficial de la Raspberry Pi 5.

Paso 2: Prepare la Tarjeta SD con el SO Raspbian Pi

  • Descargue Raspberry Pi Imager e instálelo. La documentación completa de Imager se encuentra en la página enlazada.
  • Ejecute el programa de creación de imágenes, seleccione Raspberry Pi 5 y haga clic en SIGUIENTE.

Raspberry Pi Imager

  • En la tarjeta del SO, desplácese hacia abajo, seleccione Raspberry Pi OS (otro) y haga clic en él.

Raspberry Pi OS Lite (64-bit)

  • Elija el SO Debian Bookworm o Trixie Raspberry Pi OS Lite adecuado para su Raspberry Pi y haga clic en SIGUIENTE.
  • 64 bits (arm64) - Recomendado.  Utilice esta opción para todas las nuevas instalaciones de Raspberry Pi 5. Esta es la arquitectura probada y validada por 3CX.
  • 32 bits (armhf) - Solo compatibilidad con versiones anteriores. Es posible que la versión de 32 bits siga funcionando, pero 3CX ya no la prueba ni la valida. No se garantiza la compatibilidad futura.

Dispositivo de almacenamiento

  • Seleccione la tarjeta SD que desea preparar.
  • Mantenga marcada la opción Excluir unidades del sistema para evitar riesgos accidentales en sus unidades del sistema.
  • Confirme su elección.
  • Es recomendable realizar los pasos de Personalización ahora; si los omite, al iniciar Pi por primera vez se ejecutará un asistente con las mismas opciones.

Personalización

  • Ingrese el nombre de ‘host’.
  • Configure su zona horaria y su teclado.
  • Genere su cuenta de usuario predeterminada y establezca una contraseña segura que pueda recordar.
  • El SBC debe utilizar una conexión Ethernet por cable; no es compatible con WiFi.
  • Decida cómo se conectará a su Raspberry después de la instalación:
  • SSH con autenticación mediante contraseña o clave pública.
  • Conexión de Raspberry Pi.

Escribir la imagen

  • Verifique que la información relevante en el Resumen sea la esperada y grabe la imagen en su tarjeta SD.
  • Imager descargará la última versión disponible del repositorio de Raspberry antes de que comience la escritura.

Paso 3: Instale Raspbian y Defina un Hostname

  • Inserte la tarjeta SD que acaba de preparar en la Pi.
  • Arranque la Pi.
  • Conéctese a él a través de la Consola, SSH o Pi Connect.

Paso 4: Establezca una IP Estática

Establezca una IP estática

  • Ejecute el comando  
    nmtui
    .

sudo nmtui

  • Seleccione Editar conexión.
  • Seleccione su conexión de red.
  • Establezca IPv4 en Manual y haga clic en <Mostrar>.
  • Establezca la Dirección, el Gateway y el servidor DNS en función de la Configuración de su LAN y pulse <OK>.
  • Haga clic en Atrás y Salir para salir del Asistente.
  • Reinicie el Pi:

sudo reboot

  • Cuando la Pi termine de reiniciarse, inicie sesión con el usuario que creó y verifique la dirección IP de "eth0":

ip a

Nota: Se admiten instalaciones de LAN en redes privadas RFC 1918 configuradas correctamente:

  • 10.0.0.0/8
  • 172.16.0.0/12
  • 192.168.0.0/16

Paso 5: Agregar el SBC en su PBX 3CX

Agregar SBC

  • Inicie sesión en su Consola de Administración 3CX y navegue a Voz y Chat.
  • Haga clic en + Agregar SBC, seleccione Raspberry Pi y haga clic en Continuar.
  • La conexión SBC ya se ha creado en el PBX y está a la espera de que el SBC propiamente dicho se conecte.

Paso 6: Instalar el SBC de 3CX en su Raspberry Pi

  • Inicia sesión en el Raspberry Pi con la cuenta de usuario principal, ya sea a través de la interfaz de línea de comandos (CLI) o de SSH.
  • Ejecute el script de instalación de 3CX:

sudo bash -c "$(wget -qO- https://downloads-global.3cx.com/downloads/sbc/3cxsbc.zip)"

  • Selecciona Aceptar para verificar los “Requisitos previos de 3CX” y aceptar el “Contrato de Licencia de Usuario Final” para continuar.
  • Ingrese la "URL de Aprovisionamiento" de su 3CX (por ejemplo, https://ejemplo-pbx.3cx.com) y seleccione Aceptar.
  • Ingrese el "ID de la Clave de Autenticación" y seleccione Aceptar.
  • Seleccione Aceptar y continúe con la instalación y el reinicio.

Paso 7: Aprovisionamiento de sus Teléfonos IP

Aprovisionamiento de Teléfonos IP

Una vez instalado su SBC, puede configurar sus Teléfonos IP a través de este SBC, seleccionándolo como opción de conexión durante la configuración del Teléfono IP.

Ver También

Última Actualización

Este documento se actualizó por última vez el 23 de Julio de 2026

https://www.3cx.es/docs/instalar-pbx-raspberry-pi/