Konfiguration des 3CX AI-Servers für die Transkription

Einführung

Anleitung gültig für 3CX-Telefonanlagen auf Version 20 U9 und darunter. Erklärt die Installation und Konfiguration des 3CX AI Servers für On-Premise- oder Cloud-Nutzung. Wenn Sie 3CX V20 U10 oder höher nutzen, lesen Sie bitte diese Anleitung.

Der 3CX AI Server erweitert Ihre 3CX-Telefonanlage um KI-gestützte Transkription, Sprechererkennung und Transkriptanalyse. Er kann On-Premise oder in der Cloud bereitgestellt werden und integriert sich direkt in die Verwaltungskonsole.

Hinweis: Verfügbar für die AI-Edition ab 8SC.

Über Beispiele in diesem Dokument

Dieses Dokument verwendet beispiel.de als 3CX-FQDN und wmr.3cx-beispiel.de als FQDN der Transkriptionsmaschine; Sie müssen diese durch Ihre eigenen FQDNs ersetzen.

Anforderungen an den Maschinenhost

Hardware-Spezifikationen

  • GPU: Empfohlenes Minimum (Schnell): Nvidia 24GB RTX GPU
  • CPU: Minimum: 4vCPU, Empfohlen: 6vCPU
  • RAM: Minimum: 24GB
  • Speicherplatz: Minimum: 20GB freier Speicherplatz
  • On-Premise oder Cloud

BIOS-Einstellungen

  • Secure Boot: Deaktiviert
  • CSM: Deaktiviert
  • Resize BAR Support: Deaktiviert (erfordert möglicherweise einen doppelten Neustart)
  • IOMMU: Aktiviert

Betriebssystem

  • Betriebssystem: Debian 12 (Vollständig aktualisiert)

Firewall-Konfiguration

Öffnen Sie die folgenden TCP-Ports für eingehenden Verkehr zum Server:

  • TCP 61443 – nur von der PBX-IP zulassen
  • TCP 80 – für die Erstellung/Erneuerung von Let’s Encrypt SSL-Zertifikaten; normalerweise nicht erforderlich, wenn Sie benutzerdefinierte SSL-Zertifikate verwenden

Konfigurieren Sie Ihr System

  • Melden Sie sich über SSH an Ihrem Transkriptionsserver an und erhöhen Sie die Rechte auf root
  • Aktualisieren Sie Ihr System:

apt-get update

apt-get upgrade

  • Installieren Sie die erforderlichen Voraussetzungen:

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

  • Um sicherzustellen, dass alle Systemaktualisierungen wirksam werden (insbesondere Kernel-Image-Upgrades), starten Sie das System jetzt neu:

reboot

  • Prüfen Sie, ob die NVIDIA-Treiber bereits ordnungsgemäß laufen:

nvidia-smi

  • Wenn Sie eine Antwort wie Befehl nicht gefunden erhalten, müssen Sie die NVIDIA-Treiber installieren:

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

  • Befehl nach dem Neustart erneut ausführen, um den Erfolg zu bestätigen:

nvidia-smi

  • …wodurch Ihnen der aktuelle Status der Maschine angezeigt wird:

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:~$

Installationsbefehl ausführen

Installationsbefehl ausführen

  • Gehen Sie in der Verwaltungskonsole zu Konsole > Integrationen > Transkription
  • Stellen Sie den Transkriptionsanbieter auf 3CX Transcription Engine (Lokal installiert)
  • Klicken Sie auf die Schaltfläche Weiter

Installationsbefehl ausführen

  • Die Seite Transkription zeigt nun den Installationsbefehl an, der auf Ihrem Transkriptionsserver ausgeführt werden muss; klicken Sie auf die Schaltfläche Kopieren, um den Befehl in die Zwischenablage zu kopieren
  • Melden Sie sich über SSH an Ihrem Transkriptionsserver an und erhöhen Sie die Rechte auf root
  • Führen Sie den Installationsbefehl aus, ähnlich dem folgenden Beispiel:

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

Installationsassistent für Transkriptionen 

Sie werden aufgefordert zu wählen, ob Sie benutzerdefinierte SSL-Zertifikate oder mit Let's Encrypt generierte Zertifikate verwenden möchten.

Verwendung benutzerdefinierter SSL-Zertifikate

  • Legen Sie Ihre Zertifikatsdateien im PEM-Format in /opt/3cxwm/cert ab:
  • server.crt muss Ihren öffentlichen Schlüssel (und gegebenenfalls Ihre Zertifikatskette) enthalten
  • server.key muss Ihren privaten Schlüssel enthalten
  • Stellen Sie sicher, dass die korrekten Berechtigungen für Ihre Zertifikatsdateien gesetzt sind:

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

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

Zertifikate mit Certbot erstellen

So erstellen Sie Ihre eigenen Zertifikate mit Let's Encrypt Certbot:

  • Melden Sie sich über SSH an Ihrem 3CX AI Server an und erhöhen Sie die Rechte auf root
  • Führen Sie die folgenden Befehle aus:

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

Automatische Zertifikatserneuerung

So automatisieren Sie die Erneuerung von Zertifikaten mit Let's Encrypt Certbot:

  • Melden Sie sich über SSH an Ihrem 3CX AI Server an und erhöhen Sie die Rechte auf root
  • Führen Sie nano /root/certupdate.sh aus, um das Skript zu erstellen, und legen Sie den Inhalt wie folgt fest:

#!/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.*

  • Machen Sie das Skript ausführbar:

chmod +x /root/certupdate.sh

  • Bearbeiten Sie die Crontab:

crontab -e

  • Fügen Sie der Crontab Folgendes hinzu:

0 3 * * * /root/certupdate.sh

3CX-Richtlinie für FQDN

Wenn Sie einen von 3CX bereitgestellten FQDN verwenden (z. B. bei der Installation über Option 1), beachten Sie bitte Folgendes:

  • Der FQDN wird gelöscht, wenn der 3CX AI Server aus der PBX-Benutzeroberfläche entfernt wird
  • Wenn Ihre PBX wmr.3cx.net nicht innerhalb von 30 Tagen kontaktiert, wird der FQDN automatisch gelöscht.

Überprüfen Sie die Verbindung zum 3CX AI Server

Um die Verbindung von der PBX zum 3CX AI Server zu überprüfen, können Sie den folgenden Befehl auf der PBX ausführen:

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

OK

[email protected]:~$

…was bei einer erfolgreichen Antwort OK anzeigen sollte.

Überprüfen Sie die Verbindung zum 3CX AI Server

Sie können auch zu Konsole > Integrationen > Transkription navigieren, um den Status Ihrer Transkriptions-Engine zu überprüfen.

Aktualisierungen des 3CX AI Server

Geplant

Der 3CX AI Server prüft und aktualisiert sich automatisch auf das neueste Release. Die automatische Aktualisierung läuft jeden Sonntag um 01:00 Uhr (Serverzeit).

Auf Anfrage

Wenn Sie vor dem geplanten Aktualisierungsfenster auf die neueste Version aktualisieren möchten:

  • Melden Sie sich über SSH an Ihrem 3CX AI Server an und erhöhen Sie die Rechte auf root
  • Führen Sie die folgenden Befehle aus:

sudo apt update

sudo apt -y upgrade

Transkription konfigurieren

In diesem Dokument erfahren Sie, wie Sie die Transkription für Ihre ausgewählten Endpunkte aktivieren und konfigurieren.

Siehe auch

Letztes Update

Dieses Dokument wurde zuletzt am 30. September 2026 aktualisiert.

https://www.3cx.de/docs/transkriptions-engine-server/