3CX AI Server auf macOS oder Debian (mit NVIDIA) installieren
- Einführung
- Allgemeine Anforderungen
- macOS-Anforderungen
- Debian-Anforderungen
- Prüfen Sie, ob Ihr Mac geeignet ist
- Vorbereitung Ihres Linux-Hosts
- Aktualisieren Sie das Betriebssystem
- Installieren Sie die Basiswerkzeuge
- Installation des 3CX AI-Servers
- PBX-Seite
- KI-Serverseitig
- Prüfen Sie, ob der 3CX AI-Server funktioniert
- Mehrere Telefonanlagen nutzen denselben KI-Server
- Verwaltung des 3CX KI-Servers
- Verwaltung von macOS 3CX AI-Diensten
- Verwaltung von Debian 3CX KI-Diensten
- Deinstallieren des KI-Servers
- Verwaltung verbundener Telefonanlagen
- Fehlerbehebung
- Siehe auch
Einführung
Diese Anleitung erklärt, wie Sie den 3CX AI Server für eine 3CX PBX Version 20 Update 10 oder höher auf einem unterstützten Mac mit Apple Silicon (z. B. ein Mac Mini) installieren. Der 3CX AI Server transkribiert Anrufe der Telefonanlage und führt Anrufanalysen durch.
Allgemeine Anforderungen
- Sie benötigen Zugriff auf die 3CX-Verwaltungskonsole sowie Shell- oder Terminalzugriff auf dem Gerät (macOS oder Debian), auf dem der 3CX AI Server ausgeführt werden soll.
- Sie benötigen lokale Administratorrechte (zur Rechteausweitung mittels sudo).
- Stellen Sie sicher, dass der 3CX AI Server die Telefonanlage über ihren Haupt-SSL-Port (in der Regel 443 oder 5001) sowie die 3CX-Downloadserver erreichen kann.
- Falls die Option "3CX AI Server" in der Telefonanlage nicht angezeigt wird, überprüfen Sie, ob Sie die richtige 3CX-Build-Version und 3CX-Lizenz verwenden, und prüfen Sie die Einstellung erneut unter Admin > Integrationen > Transkription > 3CX AI Server.
macOS-Anforderungen
- Es werden nur Macs mit Apple Silicon unterstützt. Intel-basierte Macs werden nicht unterstützt.
- Der Arbeitsspeicher muss mindestens 16 GB RAM betragen. Empfohlen werden 24 GB RAM; Hardware der Mac Mini Klasse bildet den erwarteten Einstieg für den praktischen Einsatz.
Debian-Anforderungen
- Verwenden Sie Debian 12 oder Debian 13 mit einer unterstützten NVIDIA-GPU, vorzugsweise mit vorinstallierten NVIDIA-Treibern und CUDA-Bibliotheken.
- Die Mindesthardware umfasst 16 GB RAM, 20 GB freien Festplattenspeicher und 16 GB VRAM. Empfohlen werden 24 GB RAM und eine GPU der RTX-Klasse mit 24 GB VRAM.
Prüfen Sie, ob Ihr Mac geeignet ist
Verwenden Sie einen Mac mit Apple Silicon, der über ausreichend freien Speicherplatz und Arbeitsspeicher für die erwartete Transkriptions- und Analyseauslastung verfügt.
uname -m ; system_profiler SPHardwareDataType | egrep 'Chip|Memory'
Ein korrektes Ergebnis zeigt Apple Silicon Hardware und die erwartete Arbeitsspeichergröße an. Beispiel:
arm64
2026-07-10 16:35:56.134 system_profiler[2278:79797] hw.cpufamily: 0x17d5b93a
Chip: Apple M4 Pro
Memory: 24 GB
Falls der Mac Intel-Hardware meldet, Apple Silicon nicht anzeigt oder zu wenig Arbeitsspeicher aufweist, brechen Sie die Installation ab und wechseln Sie zu einem unterstützten Mac, anstatt die Installation auf nicht unterstützter Hardware zu erzwingen.
Vorbereitung Ihres Linux-Hosts
Aktualisieren Sie das Betriebssystem
Führen Sie vor der Installation des 3CX AI Servers eine Paketaktualisierung und ein Upgrade durch:
sudo apt-get update
sudo apt-get upgrade
Starten Sie das Gerät neu, um sicherzustellen, dass der laufende Kernel und die installierten Header übereinstimmen:
sudo reboot
Installieren Sie die Basiswerkzeuge
Installieren Sie die vom Installationsprogramm benötigten Pakete:
sudo apt -y install curl apt-transport-https gnupg gpg wget
Prüfen Sie, ob NVIDIA-Treiber und CUDA installiert sind:
nvidia-smi
Wenn die Treiber korrekt installiert sind, erhalten Sie eine Ausgabe ähnlich der folgenden:
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 |
+-----------------------------------------------------------------------------------------+
Falls Sie nicht die korrekte Ausgabe für nvidia-smi sehen, wechseln Sie zum root-Nutzer und stellen Sie sicher, dass nvidia-smi mit den erforderlichen Abhängigkeiten installiert ist:
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
Bestätigen Sie nach dem Neustart mit nvidia-smi, dass der Stack erfolgreich läuft.
Installation des 3CX AI-Servers
PBX-Seite
- Gehen Sie in der Telefonanlage zu Admin > Integrationen > Transkription.
- Wählen Sie aus dem Dropdown-Menü "3CX AI Server" aus und klicken Sie auf die Schaltfläche + AI Server hinzufügen.
- Kopieren Sie den generierten Installationsbefehl über die Schaltfläche Kopieren.
KI-Serverseitig
curl -fsSL https://wmr-cdn.3cx.net/templates/install.sh | sudo bash -s -- mypbx.example.com 22334455-6677-8899-aabb-ccddeeff0011
- Fügen Sie den zuvor aus der Telefonanlage kopierten Befehl in Ihr Terminal ein und führen Sie ihn aus.
- Unter Debian:
- Wenn Sie eine GPU der Enterprise-Klasse wie eine NVIDIA L4 bei einem Cloud-Anbieter mit 22 GB nutzen, werden Sie möglicherweise gefragt, ob Sie ECC auf der GPU deaktivieren möchten. Wenn Sie zustimmen (Eingabe von „y“), wird ECC deaktiviert, wodurch 2 GB Arbeitsspeicher freigegeben werden, die andernfalls ungenutzt blieben. Beachten Sie, dass das Deaktivieren von ECC sofort einen Neustart auslöst und Sie nach dem Neustart wieder zum ersten Schritt zurückkehren müssen.
- Das Installationsprogramm fragt Sie anschließend, ob Sie die Installation durchführen möchten und den Geschäftsbedingungen zustimmen; akzeptieren Sie, um fortzufahren:
- Das Installationsprogramm lädt die erforderlichen Komponenten herunter, erstellt die Konfiguration, installiert die Dienste und registriert den AI Server an der Telefonanlage.
Prüfen Sie, ob der 3CX AI-Server funktioniert
- Kehren Sie zu Admin > Integrationen > Transkription zurück und vergewissern Sie sich, dass der Status des neuen AI Servers als grün und nicht rot angezeigt wird.
- Sie können Testanrufe tätigen, um die ordnungsgemäße Funktion zu überprüfen; während Aufzeichnungen verarbeitet werden, zeigt die Verwaltungskonsole Warteschleifen- und Aktivitätsinformationen an.
Mehrere Telefonanlagen nutzen denselben KI-Server
Sie können die Nutzung desselben KI-Servers auch für mehrere Telefonanlagen zulassen. Führen Sie dazu einfach die obige Installationsanleitung für die neue Telefonanlage erneut aus.
Gehen Sie beispielsweise bei der neuen Telefonanlage unter Admin > Integrationen > Transkription auf "AI Server hinzufügen", wechseln Sie dann zu Ihrem KI-Server, fügen Sie den Befehl ein und drücken Sie die Eingabetaste. Da der KI-Server auf diesem Host bereits installiert ist, überspringt die Installation bereits installierte Komponenten; dadurch wird die neue Telefonanlage zur Nutzung des KI-Servers autorisiert.
Verwaltung des 3CX KI-Servers
Der 3CX AI Server installiert mehrere Dienste, darunter den Converter-, Transcriber- und Ollama-Dienst.
Verwaltung von macOS 3CX AI-Diensten
Verwenden Sie launchctl, um mit den installierten macOS-Diensten zu interagieren.
Stoppen (und Deregistrieren) der Dienste:
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
Starten (und Registrieren) der Dienste:
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
Verwaltung von Debian 3CX KI-Diensten
Verwenden Sie die folgenden Befehle, um den Ausführungsstatus der 3CX-Dienste zu verwalten:
Dienststatus prüfen:
sudo systemctl status 3cxai-converter 3cxai-transcriber 3cxai-ollama
Dienste neu starten:
sudo systemctl restart 3cxai-converter 3cxai-transcriber 3cxai-ollama
Dienste stoppen:
sudo systemctl stop 3cxai-converter 3cxai-transcriber 3cxai-ollama
Dienste starten:
sudo systemctl start 3cxai-converter 3cxai-transcriber 3cxai-ollama
Deinstallieren des KI-Servers
Um das KI-Server-Paket vom Host zu entfernen, führen Sie das mitgelieferte Deinstallationsskript aus dem Setup-Verzeichnis aus:
sudo /opt/3cx/aiserver/setup/3cxai-uninstall.sh
Verwaltung verbundener Telefonanlagen
Um verbundene Telefonanlagen zu verwalten, können Sie das integrierte Verbindungsmanager-Skript verwenden. Damit können Sie gespeicherte Telefonanlagen-Autorisierungen überprüfen, deaktivieren, erneut aktivieren oder löschen.
Zuerst die integrierte Hilfe anzeigen.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --help
Alle konfigurierten Telefonanlagen-Verbindungen identifizieren und auflisten & deren UUID anzeigen
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh
Eine Telefonanlagen-Verbindung deaktivieren, ohne sie zu löschen.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --disable <UUID>
Eine zuvor deaktivierte Telefonanlagen-Verbindung erneut aktivieren.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --enable <UUID>
Eine gespeicherte Telefonanlagen-Verbindung dauerhaft löschen.
sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --delete <UUID>
Fehlerbehebung
Die verschiedenen Autorisierungen, Konfigurationen und sonstigen Einstellungen des KI-Servers der Telefonanlage werden in den folgenden Dateien gespeichert:
/opt/3cx/aiserver/setup/connections.json
/opt/3cx/aiserver/setup/config.json
Sie können Fehler auf dem Server untersuchen, indem Sie die Server-Protokolle unter dem folgenden Pfad prüfen:
/var/opt/3cx/aiserver/logs
Das AI Server-Paket wird in diesen Hauptpfaden installiert:
/opt/3cx/aiserver
/var/opt/3cx/aiserver
- KI-Server ist nicht erreichbar: Stellen Sie sicher, dass die Dienste geladen sind und der 3CX AI Server die Telefonanlage über HTTPS erreichen kann.
- Installationsbefehl funktioniert nicht – Vermeiden Sie es, einen Installationsbefehl aus einer vorherigen Konfiguration zu verwenden; löschen Sie den Eintrag für den 3CX AI Server aus der Telefonanlage, erstellen Sie einen neuen und führen Sie die Installation mit dem Installationsbefehl für den neu generierten 3CX AI Server-Eintrag durch.
- nvidia-smi schlägt fehl (nur Debian): Beheben Sie den Zustand des NVIDIA-Treibers oder von CUDA, bevor Sie das Installationsprogramm erneut ausführen.
- Die Telefonanlage lehnt die Verbindung ab: Entfernen Sie veraltete Konfigurationen und führen Sie die Neuinstallation mit einem frischen, UUID-basierten Befehl durch.
Siehe auch
Letztes Update
Dieses Dokument wurde zuletzt am 21. September 2026 aktualisiert
Copyright © 2025