Servidor 3CX IA en macOS o Debian (con NVIDIA)
- Introduction
- Requisitos Generales
- Requisitos macOS
- Requisitos Debian
- Compruebe la Compatibilidad de su Mac
- Preparación de su Servidor Linux
- Actualizar el sistema operativo
- Instalar las herramientas básicas
- Instalación del Servidor 3CX IA
- Lado del PBX
- Lado del Servidor IA
- Compruebe que el Servidor 3CX IA funcione
- Varios PBXs que utilizan el mismo Servidor IA
- Administración del Servidor 3CX IA
- Administración de los Servicios IA de 3CX en macOS
- Administración de los Servicios IA de 3CX en Debian
- Desinstalar el Servidor IA
- Administración de PBXs Conectadas
- Solución de Problemas
- Ver También
Introduction
Esta guía explica cómo instalar el Servidor 3CX IA para un PBX 3CX Versión 20 Update 10, en una computadora Mac con Apple Silicon compatible, como un Mac Mini. El Servidor 3CX IA transcribirá las llamadas del PBX y realizará análisis de llamadas.
Requisitos Generales
- Necesita acceso a la Consola de Administración de 3CX y acceso al shell o al terminal en la máquina (macOS o Debian) en la que se ejecutará el Servidor 3CX IA.
- Necesitará derechos de administrador local (para elevar los privilegios con sudo).
- Asegúrese de que el Servidor 3CX IA pueda comunicarse con el PBX a través de su puerto SSL principal, que suele ser el 443 o el 5001, y de que pueda comunicarse con los servidores de descarga de 3CX.
- Si la opción Servidor 3CX IA no aparece en el PBX, compruebe que está utilizando la Versión correcta de 3CX y la licencia 3CX adecuadas, y vuelva a verificar en Admin > Integraciones > Transcripción > Servidor 3CX IA.
Requisitos macOS
- Solo se admiten las computadoras Mac con Apple Silicon. Las computadoras Mac con procesadores Intel no son compatibles.
- La memoria mínima es de 16GB de RAM. El objetivo recomendado es de 24GB de RAM, y se espera que la implementación práctica inicial se realice con hardware de la clase Mac Mini.
Requisitos Debian
- Utilice Debian 12 o Debian 13 con un GPU NVIDIA compatible, preferiblemente con los controladores de NVIDIA y las bibliotecas CUDA preinstalados.
- Los requisitos mínimos de hardware son 16GB de RAM, 20GB de espacio libre en disco y 16GB de VRAM. Los requisitos recomendados son 24GB de RAM y una GPU de clase RTX de 24GB.
Compruebe la Compatibilidad de su Mac
Utilice una computadora Mac con Apple Silicon que cuente con suficiente espacio libre en disco y memoria para la carga prevista de transcripción y análisis.
uname -m ; system_profiler SPHardwareDataType | egrep 'Chip|Memory'
Un resultado correcto mostrará el hardware Apple Silicon y la capacidad de memoria esperada. Por ejemplo:
arm64
2026-07-10 16:35:56.134 system_profiler[2278:79797] hw.cpufamily: 0x17d5b93a
Chip: Apple M4 Pro
Memory: 24 GB
Si la Mac detecta hardware Intel, no reconoce Apple Silicon o muestra muy poca memoria, detenga el proceso y realice la instalación en una Mac compatible, en lugar de forzar la instalación en hardware no compatible.
Preparación de su Servidor Linux
Actualizar el sistema operativo
Actualice y mejore los paquetes antes de instalar el Servidor 3CX IA:
sudo apt-get update
sudo apt-get upgrade
Reinicie la máquina para asegurarse de que el kernel en ejecución y los encabezados instalados coincidan:
sudo reboot
Instalar las herramientas básicas
Instale los paquetes que requiere el instalador:
sudo apt -y install curl apt-transport-https gnupg gpg wget
Verifique si los controladores de Nvidia y CUDA están instalados:
nvidia-smi
Si los controladores están instalados correctamente, obtendrá un resultado similar al siguiente:
user@aiserver:~$ nvidia-smi
Mon Jan 26 09:04:40 2026
+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 590.48.01 Driver Version: 590.48.01 CUDA Version: 13.1 |
+-----------------------------------------+------------------------+----------------------+
| GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC |
| Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. |
| | | MIG M. |
|=========================================+========================+======================|
| 0 NVIDIA L4 On | 00000000:00:03.0 Off | 0 |
| N/A 40C P8 12W / 72W | 0MiB / 23034MiB | 0% Default |
| | | N/A |
+-----------------------------------------+------------------------+----------------------+
+-----------------------------------------------------------------------------------------+
| Processes: |
| GPU GI CI PID Type Process name GPU Memory |
| ID ID Usage |
|=========================================================================================|
| No running processes found |
+-----------------------------------------------------------------------------------------+
Si no ve el resultado correcto al ejecutar nvidia-smi, cambie a la cuenta de usuario root y asegúrese de que nvidia-smi esté instalado junto con las dependencias necesarias:
apt -y install linux-headers-$(uname -r)
DEB_VERSION=$(VERSION_ID=; . /etc/os-release; echo "$VERSION_ID")
wget "https://developer.download.nvidia.com/compute/cuda/repos/debian${DEB_VERSION}/x86_64/cuda-keyring_1.1-1_all.deb"
dpkg -i cuda-keyring_1.1-1_all.deb
apt update
apt -y install nvidia-open
apt -y install nvidia-driver-cuda nvidia-kernel-open-dkms
reboot
Después de reiniciar, confirme que los servicios se estén ejecutando correctamente con nvidia-smi.
Instalación del Servidor 3CX IA
Lado del PBX
- En el PBX, vaya a Admin > Integraciones > Transcripción.
- En el menú desplegable, seleccione Servidor 3CX IA y haga clic en el botón +Agregar Servidor IA.
- Copie el comando de instalación generado utilizando el botón de copiar que se proporciona.
Lado del Servidor IA
curl -fsSL https://wmr-cdn.3cx.net/templates/install.sh | sudo bash -s -- mypbx.example.com 22334455-6677-8899-aabb-ccddeeff0011
- En su terminal, pegue y ejecute el comando que copió anteriormente del PBX.
- En Debian:
- Si está utilizando un GPU de nivel empresarial, como un Nvidia L4, en un proveedor de servicios en la nube con 22GB, es posible que se le pregunte si desea desactivar el ECC en el GPU. Si acepta (escriba "y"), esto desactivará el ECC, lo que le permitirá recuperar 2GB de memoria que, de lo contrario, quedarían sin usar. Tenga en cuenta que desactivar el ECC provocará un reinicio inmediato, y tendrá que volver al primer paso después del reinicio.
- A continuación, el instalador le preguntará si desea realizar la instalación y si acepta los términos y condiciones; acepte para continuar:
- El instalador descarga los componentes necesarios, crea la configuración, instala los servicios y registra el Servidor IA en el PBX.
Compruebe que el Servidor 3CX IA funcione
- Regrese a Admin > Integraciones > Transcripción y confirme que el estado del nuevo Servidor IA aparezca en verde y no en rojo.
- Puede realizar algunas llamadas de prueba para verificar que todo funcione correctamente; mientras se procesan las grabaciones, la Consola de Administración mostrará información sobre las colas y la actividad.
Varios PBXs que utilizan el mismo Servidor IA
También puede permitir que varios PBXs utilicen el mismo Servidor IA. Para ello, simplemente siga nuevamente la guía de instalación anterior para el nuevo PBX.
Por ejemplo, tendría que ir al nuevo PBX en Integraciones > Transcripción, hacer clic en "Agregar Servidor IA", luego ir a su servidor IA, pegar el comando y presionar Enter. Dado que el Servidor IA ya está instalado en ese host, la instalación omitirá los componentes que ya estén instalados; esto autorizará efectivamente al nuevo PBX a utilizar también el Servidor IA.
Administración del Servidor 3CX IA
El Servidor 3CX IA instala varios servicios, entre ellos el convertidor, el transcriptor y el servicio Ollama.
Administración de los Servicios IA de 3CX en macOS
Utilice launchctl para interactuar con los servicios de macOS instalados.
Detiene (y desregistra) los servicios:
sudo launchctl bootout system/com.3cx.converter
sudo launchctl bootout system/com.3cx.transcriber
sudo launchctl bootout system/com.3cx.logrotate
sudo launchctl bootout system/com.ollama.serve
Inicia (y registra) los servicios:
sudo launchctl bootstrap system /Library/LaunchDaemons/com.3cx.converter.plist
sudo launchctl bootstrap system /Library/LaunchDaemons/com.3cx.transcriber.plist
sudo launchctl bootstrap system /Library/LaunchDaemons/com.3cx.logrotate.plist
sudo launchctl bootstrap system /Library/LaunchDaemons/com.ollama.serve.plist
Administración de los Servicios IA de 3CX en Debian
Para administrar el estado de funcionamiento de los servicios de 3CX, utilice los siguientes comandos:
Verificar el estado del servicio:
sudo systemctl status 3cxai-converter 3cxai-transcriber 3cxai-ollama
Reiniciar los servicios:
sudo systemctl restart 3cxai-converter 3cxai-transcriber 3cxai-ollama
Detener los servicios:
sudo systemctl stop 3cxai-converter 3cxai-transcriber 3cxai-ollama
Iniciar los servicios:
sudo systemctl start 3cxai-converter 3cxai-transcriber 3cxai-ollama
Desinstalar el Servidor IA
Para eliminar el paquete del Servidor IA del host, ejecute el script de desinstalación incluido en el directorio de instalación:
sudo /opt/3cx/aiserver/setup/3cxai-uninstall.sh
Administración de PBXs Conectadas
Para administrar los PBXs conectados, puede utilizar el script del administrador de conexiones integrado. Con él, puede revisar, desactivar, volver a activar o eliminar las autorizaciones del PBX almacenadas.
Muestra primero la ayuda integrada.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --help
Identifica y enumera todas las conexiones de PBX configuradas y muestra su UUID.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh
Desactivar una conexión de PBX sin eliminarla.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --disable <UUID>
Vuelve a habilitar una conexión de PBX que se había deshabilitado anteriormente.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --enable <UUID>
Eliminar de forma permanente una conexión de PBX guardada.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --delete <UUID>
Solución de Problemas
Las distintas autorizaciones del PBX, las configuraciones y otros ajustes del servidor IA se guardan en los siguientes archivos:
/opt/3cx/aiserver/setup/connections.json
/opt/3cx/aiserver/setup/config.json
Puede solucionar los problemas del servidor revisando los registros del servidor que se encuentran en la ruta que se indica a continuación.
/var/opt/3cx/aiserver/logs
El paquete del Servidor IA se instala en estas rutas principales.
/opt/3cx/aiserver
/var/opt/3cx/aiserver
- El Servidor IA está fuera de servicio: Verifica que los servicios estén cargados y que el Servidor 3CX IA pueda comunicarse con el PBX a través de HTTPS.
- El comando install no funciona - Evite utilizar un comando de instalación de una configuración anterior; elimine la entrada del Servidor 3CX IA del PBX, genere una nueva e instálela utilizando el comando de instalación correspondiente a la entrada del Servidor 3CX IA recién creado.
- nvidia-smi falla (solo en Debian): Corrige el controlador de NVIDIA o el estado de CUDA antes de volver a ejecutar el instalador.
- El PBX rechaza la conexión: Elimina la configuración obsoleta y vuelve a instalarla utilizando un comando nuevo basado en un UUID.
Ver También
Última Actualización
Este documento se actualizó por última vez el 30 de Julio de 2026
Copyright © 2025