Установка ИИ сервера 3CX на macOS или Debian (с NVIDIA)

Введение

В этом руководстве описано, как установить ИИ сервер 3CX для АТС 3CX Version 20 Update 10 на поддерживаемый компьютер Apple Silicon Mac, например, Mac Mini. ИИ сервер 3CX будет выполнять транскрипцию вызовов АТС и их анализ.

Общие требования

  • Вам потребуется доступ к консоли администратора 3CX, а также доступ к оболочке или терминалу на компьютере (macOS или Debian), где будет запущен ИИ сервер 3CX.
  • Вам потребуются права локального администратора (для повышения привилегий с помощью sudo).
  • Убедитесь, что ИИ сервер 3CX имеет доступ к АТС по ее основному SSL-порту (обычно 443 или 5001) и к серверам загрузки 3CX.
  • Если опция ИИ сервер 3CX не отображается в АТС, убедитесь, что вы используете правильную сборку (Build) и лицензию 3CX, а затем снова проверьте раздел Admin > Integrations > Transcription > ИИ сервер 3CX.

Требования для macOS

  • Поддерживаются только Apple Silicon Macs. Mac на базе процессоров Intel не поддерживаются.
  • Минимальный объем оперативной памяти — 16 ГБ ОЗУ. Рекомендуемый объем — 24 ГБ ОЗУ. Оборудование класса Mac Mini считается базовым вариантом для практического развертывания.

Требования для Debian

  • Используйте Debian 12 или Debian 13 с поддерживаемым графическим процессором (GPU) NVIDIA, желательно с предустановленными драйверами NVIDIA и библиотеками CUDA.
  • Минимальные аппаратные требования: 16 ГБ ОЗУ, 20 ГБ свободного места на диске и 16 ГБ видеопамяти (VRAM). Рекомендуемые требования: 24 ГБ ОЗУ и GPU класса RTX с 24 ГБ видеопамяти.

Подтверждение совместимости вашего Mac

Используйте Mac на базе Apple Silicon с достаточным объемом свободного места на диске и оперативной памяти, соответствующим ожидаемой нагрузке по транскрипции и анализу.

uname -m ; system_profiler SPHardwareDataType | egrep 'Chip|Memory'

При успешной проверке отобразится оборудование Apple Silicon и ожидаемый объем памяти. Например:

arm64

2026-07-10 16:35:56.134 system_profiler[2278:79797] hw.cpufamily: 0x17d5b93a

      Chip: Apple M4 Pro

      Memory: 24 GB

Если Mac определяет оборудование Intel, не отображает наличие Apple Silicon или показывает слишком мало памяти, остановитесь и перенесите установку на поддерживаемый Mac. Не пытайтесь принудительно развернуть систему на не поддерживаемом оборудовании.

Подготовка хоста Linux

Обновление операционной системы

Выполните обновление списка пакетов и установку новых версий пакетов перед установкой ИИ сервера 3CX:

sudo apt-get update

sudo apt-get upgrade

Перезагрузите компьютер, чтобы убедиться, что текущее ядро и установленные заголовки (headers) совпадают:

sudo reboot

Установка базовых инструментов

Установите пакеты, необходимые для работы установщика:

sudo apt -y install curl apt-transport-https gnupg gpg wget

Проверьте, установлены ли драйверы Nvidia и CUDA:

nvidia-smi

 

Если драйверы установлены корректно, вы получите вывод, похожий на следующий:

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                                                             |

+-----------------------------------------------------------------------------------------+

Если вы не видите правильного вывода для nvidia-smi, повысьте права до пользователя root и убедитесь, что nvidia-smi установлен вместе со всеми необходимыми зависимостями:

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

После перезагрузки убедитесь с помощью nvidia-smi, что стек работает успешно.

Установка ИИ сервера 3CX

На стороне АТС

  • В интерфейсе АТС перейдите в Admin > Integrations > Transcription.
  • В выпадающем меню выберите ИИ сервер 3CX и нажмите кнопку + Add AI Server.
  • Скопируйте сгенерированную команду установки, используя кнопку копирования.

На стороне ИИ сервера

curl -fsSL https://wmr-cdn.3cx.net/templates/install.sh | sudo bash -s -- mypbx.example.com 22334455-6677-8899-aabb-ccddeeff0011

  • Вставьте в терминал и выполните команду, ранее скопированную из АТС.
  • В Debian:

  • Если вы используете GPU корпоративного уровня (например, Nvidia L4 у облачного провайдера с 22 ГБ памяти), вам может быть предложено отключить ECC для GPU. Если вы согласитесь (введя «y»), ECC будет отключен, что позволит высвободить 2 ГБ памяти, которые иначе остались бы неиспользованными. Обратите внимание, что отключение ECC немедленно вызовет перезагрузку системы, и после нее вам придется начать установку с первого шага.

  • Затем установщик спросит, хотите ли вы выполнить установку и согласны ли вы с условиями использования; примите их, чтобы продолжить:

  • Установщик загрузит необходимые компоненты, создаст конфигурацию, установит службы и зарегистрирует ИИ сервер в АТС.

Проверка работы ИИ сервера 3CX

  • Вернитесь в раздел Admin > Integrations > Transcription и убедитесь, что статус нового ИИ сервера отображается зеленым, а не красным.

  • Вы можете сделать несколько тестовых вызовов, чтобы убедиться в правильности работы; когда записи будут обрабатываться, консоль администратора покажет информацию об очереди и активности.

Использование одного ИИ сервера для нескольких АТС

Вы также можете разрешить использование одного и того же ИИ сервер для нескольких АТС. Для этого просто выполните приведенное выше руководство по установке повторно для новой АТС.

Например, вам потребуется зайти на новую АТС в раздел Integrations > Transcription и нажать на "Add AI Server", затем перейти в терминал вашего ИИ сервера, вставить команду и нажать Enter. Поскольку ИИ сервер уже установлен на этом хосте, установка пропустит уже установленные компоненты; это фактически авторизует новую АТС на использование данного ИИ сервера.

Управление ИИ сервером 3CX

ИИ сервер 3CX устанавливает несколько служб, включая конвертер (converter), транскрибатор (transcriber) и службу Ollama.

Управление службами 3CX ИИ в macOS

Используйте launchctl для взаимодействия с установленными службами macOS.

Остановка (и отмена регистрации) служб:

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

Запуск (и регистрация) служб:

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

Управление службами 3CX ИИ в Debian

Для управления рабочим статусом служб 3CX используйте следующие команды:

Проверка статуса служб:

sudo systemctl status 3cxai-converter 3cxai-transcriber 3cxai-ollama

Перезапуск служб:

sudo systemctl restart 3cxai-converter 3cxai-transcriber 3cxai-ollama

Остановка служб:

sudo systemctl stop 3cxai-converter 3cxai-transcriber 3cxai-ollama

Запуск служб:

sudo systemctl start 3cxai-converter 3cxai-transcriber 3cxai-ollama

Удаление ИИ сервера

Чтобы удалить пакет ИИ сервера с хоста, запустите встроенный скрипт удаления из каталога установки:

sudo /opt/3cx/aiserver/setup/3cxai-uninstall.sh

Управление подключенными АТС

Для управления подключенными АТС можно использовать встроенный скрипт диспетчера подключений. С его помощью можно просматривать, отключать, повторно включать или удалять сохраненные авторизации АТС.

Сначала выведите встроенную справку:

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --help

Определение и вывод списка всех настроенных подключений АТС и просмотр их UUID.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh

Отключение подключения АТС без его удаления.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --disable <UUID>

Повторное включение ранее отключенного подключения АТС.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --enable <UUID>

Безвозвратное удаление сохраненного подключения АТС.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --delete <UUID>

Устранение неполадок

Различные авторизации АТС, конфигурации и другие настройки ИИ сервера сохраняются в следующих файлах:

/opt/3cx/aiserver/setup/connections.json

/opt/3cx/aiserver/setup/config.json

Вы можете выполнить диагностику сервера, проверив журналы (логи) сервера, расположенные по указанному ниже пути.

/var/opt/3cx/aiserver/logs

Пакет ИИ сервера устанавливается в эти основные директории.

/opt/3cx/aiserver

/var/opt/3cx/aiserver

  • ИИ сервер не работает: Убедитесь, что службы загружены и что ИИ сервер 3CX может связаться с АТС по HTTPS.
  • Команда установки не работает: Избегайте использования команды установки от предыдущей конфигурации; удалите запись ИИ сервера 3CX в АТС, создайте новую и выполните установку, используя команду для только что сгенерированной записи ИИ сервера 3CX.
  • Ошибка nvidia-smi (только для Debian): Устраните проблемы с драйвером NVIDIA или состоянием CUDA перед повторным запуском установщика.
  • АТС отклоняет подключение: Удалите устаревшую конфигурацию и выполните переустановку, используя новую команду со свежим UUID.

Дополнительная информация

Версия документа

Последнее обновление документа 30 июля 2026

https://www.3cx.ru/docs/installing-ai-server-macos-debian/