3CX 转录引擎服务器安装指南

介绍

本指南介绍了如何安装和配置适用于本地或云端使用的 3CX 转录引擎服务器。该引擎可为您的系统提供高级智能转录、说话人分离（声纹识别）以及转录内容分析功能。

3CX 转录引擎为您的 3CX 电话系统增加了由智能驱动的语音转录、说话人检测和转录分析功能。该引擎既可部署在本地，也可部署于云端，并能直接与管理控制台集成。

注意：此功能仅对许可证等级为 32SC 或更高的版本（企业版）可用。

1. 启用集成

登录您的 PBX 管理控制台并转到：管理 → 集成 → 转录 → “3CX 转录引擎（本地安装）”

2.主机硬件要求

  • GPU：最低推荐（快速处理）：Nvidia 24GB RTX 显卡
  • CPU：最低：4核虚拟CPU，推荐：6核虚拟CPU
  • 内存 (RAM)：最低：24GB
  • 存储空间：最低：20GB 可用磁盘空间
  • 部署环境：本地或云端
  • 操作系统 (OS)：Debian 12（已完全更新）

3.BIOS设置

  • 安全启动：禁用
  • CSM（兼容性支持模块）：禁用
  • Resize BAR 支持：禁用（可能需要重新启动两次）
  • IOMMU：启用

4.更新系统

apt-get update

apt-get upgrade

重要提示：如果升级过程中安装了新的内核版本，则需要重启系统。否则，驱动程序安装将失败。

reboot

5.防火墙配置

开放以下 TCP 端口：

  • TCP 61443：仅允许来自 PBX 的 IP 访问
  • TCP 80：用于 Let’s Encrypt SSL 证书的创建/续期（如果您未设置自定义证书）

6. 安装先决条件

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

7.NVIDIA 驱动程序设置

nvidia-smi


# If not present, install:

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

sudo reboot

# After reboot:

nvidia-smi

8.运行安装命令

从您的管理控制台中复制安装命令，路径如下：

集成 → 转录 → 3CX 转录引擎

例子：

source <(curl -s https://yourpbx.fqdn.tld/webmeeting/onboardai/<uuid>)

9. 安装向导

系统会要求您选择使用自定义 SSL 证书还是使用 Cerbot 生成的证书。

使用自定义 SSL 证书

将 PEM 格式的证书文件放入：

/opt/3cxwm/cert


server.crt - Public Key

server.key - Private Key

确保适当的权限：

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

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

使用 Certbot 创建证书

apt-get install certbot
sudo certbot certonly --standalone --preferred-challenges http -d someFQDN.myDomain.xyz


# Copy certs:

cp /etc/letsencrypt/live/someFQDN.myDomain.xyz/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/someFQDN.myDomain.xyz/privkey.pem /opt/3cxwm/cert/server.key

自动证书更新

nano /root/certupdate.sh


# Script contents:

#!/bin/bash

cp /etc/letsencrypt/live/someFQDN.myDomain.xyz/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/someFQDN.myDomain.xyz/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 -e


# Add to crontab:

0 3 * * * /root/certupdate.sh

3CX 提供的 FQDN 策略

如果您使用 3CX 提供的 FQDN（例如通过选项 1 安装时），请注意：

  • 如果从 PBX UI 中删除转录引擎，则 FQDN 将被删除。
  • 如果您的 PBX 在 30 天内未连接 wmr.3cx.net，FQDN 将被自动删除。

10. 验证与转录服务器的连接

要验证从 PBX 到转录服务器的连接，您可以使用以下命令：

curl https://someFQDN.myDomain.xyz:61443/webmeeting[/code]

将 someFQDN.myDomain.xyz 替换为您的转录服务器的实际 FQDN。

预期返回结果应为：“OK”

上次更新

本文件最后更新于 2025 年 10 月 23 日

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