Руководство по установке сервера 3CX Transcription Engine

Введение

Это руководство описывает процесс установки и настройки сервера 3CX Transcription Engine. Сервер можно использовать локально или в облаке.

3CX Transcription Engine добавляет в АТС 3CX транскрипцию на базе ИИ, определение спикера и анализ расшифровки. Его можно развернуть локально (on-premise) или в облаке, и он

интегрируется напрямую с консолью администратора.

Примечание: Доступно для редакции AI или выше с лицензией 16ОВ или более.

О примерах в этом документе

В этом документе используется example.com как FQDN 3CX и wmr.3cx-example.com как FQDN сервера транскрипции; необходимо заменить их на собственные FQDN.

Требования к серверу

Спецификация оборудования

  • GPU: Минимально рекомендованный (Быстрый): Nvidia 24GB RTX GPU
  • CPU: Минимум: 4vCPU, Рекомендуется: 6vCPU
  • RAM: Минимум: 24GB
  • Storage: Минимум: 20GB свободного дискового пространства
  • Локально (on-premise) или в облаке

Настройки BIOS

  • Secure Boot: Disabled (Отключено)
  • CSM: Disabled (Отключено)
  • Resize BAR Support: Disabled (Отключено — может потребоваться двойная перезагрузка)
  • IOMMU: Enabled (Включено)

Операционная система

  • OS: Debian 12 (Полностью обновленная)

Конфигурация сетевого экрана

Откройте следующие TCP-порты для входящего трафика на машину:

  • TCP 61443 – разрешить только с IP-адреса АТС
  • TCP 80 – для создания/обновления SSL-сертификата Let’s Encrypt; обычно это не требуется, если используются собственные SSL-сертификаты

Настройка системы

  • Войдите на сервер транскрипции по SSH и повысьте права до root.
  • Обновите систему:

apt-get update

apt-get upgrade

  • Установите необходимые предварительные компоненты:

apt -y install curl apt-transport-https gnupg gpg wget iptables-persistent build-essential dkms

  • Чтобы убедиться, что все системные обновления вступили в силу (в частности, обновления образа ядра), перезагрузите систему сейчас:

reboot

  • Проверьте, что запущены и работают драйверы NVIDIA:

nvidia-smi

  • Если получен ответ "command not found", требуется установить драйверы NVIDIA:

apt -y install linux-headers-$(uname -r)

wget https://developer.download.nvidia.com/compute/cuda/repos/debian12/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

  • …что показывает текущий статус машины.

user@wmr-3cx-example-com:~$ 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                                                             |

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

user@wmr-3cx-example-com:~$

Выполнение команды установки

  • В консоли администратора перейдите в "Admin → Integrations → Transcription".
  • Установите параметр Transcription Provider на 3CX Transcription Engine (Installed Locally).
  • Нажмите кнопку Proceed.

  • Страница Transcription теперь отображает команду установки для запуска на машине транскриптора; нажмите кнопку Copy, чтобы скопировать команду в буфер обмена.
  • Войдите на машину транскрипции по SSH и повысьте права до root.
  • Запустите команду установки, аналогичную следующему примеру:

source <(curl -s https://example.com/webmeeting/onboardai/99887766-aabb-1122-ccdd-abcdef123456)

Мастер установки транскрипции

Будет предложено выбрать использование собственных SSL-сертификатов или сертификатов, сгенерированных с помощью Let's Encrypt.

Использование пользовательских SSL-сертификатов

  • Поместите файлы сертификатов в формате PEM в /opt/3cxwm/cert:
  • server.crt должен содержать публичный ключ (и, возможно, цепочку сертификатов)
  • server.key должен содержать приватный ключ.
  • Убедитесь, что для файлов сертификатов установлены правильные права доступа:

sudo chown www-data:www-data /opt/3cxwm/cert/server.*

sudo chmod 600 /opt/3cxwm/cert/server.*

Создание сертификатов с помощью Certbot

Чтобы создать собственные сертификаты с помощью Let's Encrypt Certbot:

  • Войдите на машину транскрипции по SSH и повысьте права до root
  • Выполните следующие команды:

sudo apt-get install certbot

sudo certbot certonly --standalone --preferred-challenges http -d wmr.3cx-example.com

cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key

Автоматическое продление сертификатов

Чтобы автоматизировать продление сертификатов с помощью Let's Encrypt Certbot:

  • Войдите на машину транскрипции по SSH и повысьте права до root.
  • Запустите nano /root/certupdate.sh для создания скрипта и задайте следующее содержимое:

#!/bin/bash

cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key

chown www-data:www-data /opt/3cxwm/cert/server.*

chmod 600 /opt/3cxwm/cert/server.*

  • Сделайте скрипт исполняемым:

chmod +x /root/certupdate.sh

  • Отредактируйте crontab:

crontab -e

  • Добавьте следующее в crontab:

0 3 * * * /root/certupdate.sh

Политика использования FQDN, предоставленного 3CX

Если вы используете FQDN, предоставленный 3CX (например, при установке через Опцию 1), обратите внимание:

  • FQDN будет удален, если Transcription Engine удалить из интерфейса АТС.
  • Если ваша PBX не обращается к wmr.3cx.net в течение 30 дней, FQDN будет автоматически удалён.

Проверка связи с Transcription Server

Чтобы проверить подключение от АТС к серверу транскрипции, можно выполнить следующую команду на АТС:

[email protected]:~$ curl -w "\n" https://wmr.3cx-example.com:61443/webmeeting

OK

[email protected]:~$

  • …что должно показать OK при успешном ответе.

Также есть возможность перейти в "Admin → Integrations → Transcription" в консоли администратора, чтобы проверить статус сервера транскрипции.

Обновления сервера транскрипции

По расписанию

Сервер транскрипции проверяет и автоматически обновляется до последнего релиза. Задача автообновления запускается каждое воскресенье в 1:00 AM (по времени сервера).

По требованию

Если требуется обновиться до последней версии:

  • Войдите на машину транскрипции по SSH и повысьте права до root.
  • Выполните следующие команды:

sudo apt update

sudo apt -y upgrade

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

Последнее обновление документа 28 января 2026 г.

https://www.3cx.ru/docs/transcription-engine-server/