Konfiguracja serwera AI 3CX dla transkrypcji

Wprowadzenie

Ten przewodnik jest przeznaczony dla systemów telefonicznych 3CX w wersji 20 U9 i niższych oraz wyjaśnia, jak zainstalować i skonfigurować serwer AI 3CX (3CX AI Server) do użytku lokalnego lub w chmurze. Jeśli korzystasz z 3CX V20 U10 lub nowszej, zapoznaj się z tym przewodnikiem.

Serwer AI 3CX dodaje transkrypcję opartą na AI, wykrywanie mówców oraz analizę transkrypcji do Twojego systemu telefonicznego 3CX. Może być wdrożony lokalnie lub w chmurze i integruje się bezpośrednio z Konsolą Admina.

Uwaga: Funkcja dostępna dla edycji AI, z licencją 16SC lub wyższą.

Informacje o przykładach w tym dokumencie

W niniejszym dokumencie jako FQDN systemu 3CX wykorzystano example.com, a jako FQDN maszyny serwera AI wmr.3cx-example.com; musisz je zastąpić własnymi nazwami FQDN.

Wymagania dotyczące maszyny hosta

Specyfikacje sprzętowe

  • GPU: Minimum zalecane (Szybkie): Nvidia 24GB RTX GPU
  • CPU: Minimum: 4vCPU, Zalecane: 6vCPU
  • RAM: Minimum: 24GB
  • Pamięć masowa: Minimum: 20GB wolnego miejsca na dysku
  • Lokalizacja: Lokalnie (On-premise) lub w chmurze

Ustawienia BIOS

  • Secure Boot: Wyłączone (Disabled)
  • CSM: Wyłączone (Disabled)
  • Resize BAR Support: Wyłączone (Disabled) – może wymagać dwukrotnego restartu
  • IOMMU: Włączone (Enabled)

System operacyjny

  • OS: Debian 12 (w pełni zaktualizowany)

Konfiguracja zapory sieciowej

Otwórz następujące porty TCP dla ruchu przychodzącego do maszyny:

  • TCP 61443 – zezwalaj tylko z adresu IP centrali PBX
  • TCP 80 – dla tworzenia/odnawiania certyfikatów SSL Let’s Encrypt; zazwyczaj nie jest to konieczne, jeśli używasz własnych certyfikatów SSL

Skonfiguruj swój system

  • Zaloguj się do swojej maszyny transkrypcyjnej przez SSH i uzyskaj uprawnienia roota.
  • Zaktualizuj swój system:

apt-get update

apt-get upgrade

  • Zainstaluj wymagane komponenty:

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

  • Aby upewnić się, że wszystkie aktualizacje systemowe weszły w życie (szczególnie w przypadku aktualizacji jądra systemu), zrestartuj teraz system:

reboot

  • Sprawdź, czy sterowniki NVIDIA już działają:

nvidia-smi

  • Jeśli otrzymasz odpowiedź o braku polecenia (command not found), musisz zainstalować sterowniki 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

  • Po restarcie potwierdź, że wszystko działa poprawnie:

nvidia-smi

  • ...co wyświetli aktualny status maszyny (podobnie jak w przykładzie powyżej).

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

Uruchom polecenie instalacji

  • W Konsoli Admina 3CX przejdź do „Admin” → „Integrations” → „Transcription” (Admin → Integracje → Transkrypcja).
  • Ustaw „Transcription Provider” (Dostawca transkrypcji) na „3CX Transcription Engine (Installed Locally)” (Silnik transkrypcji 3CX (zainstalowany lokalnie)).
  • Kliknij przycisk „Proceed” (Kontynuuj).

  • Na stronie transkrypcji wyświetli się teraz polecenie instalacji, które należy uruchomić na maszynie transkrypcyjnej; kliknij przycisk „Copy” (Kopiuj), aby skopiować polecenie do schowka.
  • Zaloguj się do swojej maszyny transkrypcyjnej przez SSH i uzyskaj uprawnienia roota.
  • Uruchom polecenie instalacji, podobne do poniższego przykładu:

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

Kreator instalacji transkrypcji

Zostaniesz zapytany, czy chcesz użyć własnych certyfikatów SSL („Custom SSL Certificates”), czy certyfikatów wygenerowanych za pomocą Let's Encrypt.

Korzystanie z własnych certyfikatów SSL

  • Umieść pliki certyfikatów w formacie PEM w katalogu /opt/3cxwm/cert:
  • server.crt musi zawierać Twój klucz publiczny (i ewentualnie łańcuch certyfikatów).
  • server.key musi zawierać Twój klucz prywatny.
  • Upewnij się, że ustawiono odpowiednie uprawnienia dla plików certyfikatów:

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

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

Tworzenie certyfikatów za pomocą Certbot

Aby utworzyć własne certyfikaty za pomocą Let's Encrypt Certbot:

  • Zaloguj się do swojego serwera AI 3CX przez SSH i uzyskaj uprawnienia roota.
  • Wykonaj następujące polecenia:

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

Automatyczne odnawianie certyfikatów

Aby zautomatyzować odnawianie certyfikatów za pomocą Let's Encrypt Certbot:

  • Zaloguj się do swojego serwera AI 3CX przez SSH i uzyskaj uprawnienia roota.
  • Uruchom nano /root/certupdate.sh, aby utworzyć skrypt i ustaw jego zawartość w następujący sposób:

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

  • Nadaj skryptowi uprawnienia do wykonywania:

chmod +x /root/certupdate.sh

  • Edytuj crontab:

crontab -e

  • Dodaj do crontab następujący wpis:

0 3 * * * /root/certupdate.sh

Polityka FQDN dostarczanych przez 3CX

Jeśli używasz FQDN dostarczonego przez 3CX (np. podczas instalacji za pomocą Opcji 1), pamiętaj, że:

  • FQDN zostanie usunięty, jeśli serwer AI 3CX zostanie usunięty z interfejsu centrali PBX.
  • Jeśli Twoja centrala PBX nie skontaktuje się z wmr.3cx.net w ciągu 30 dni, FQDN zostanie automatycznie usunięty.

Weryfikacja połączenia z serwerem transkrypcji

Aby zweryfikować połączenie z centrali PBX do serwera AI 3CX, możesz wykonać następujące polecenie na centrali PBX:

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

OK

[email protected]:~$

...które w przypadku udanej odpowiedzi powinno wyświetlić „OK”.

Możesz również przejść do „Admin” → „Integrations” → „Transcription” (Admin → Integracje → Transkrypcja) w Konsoli Admina 3CX, aby sprawdzić status swojego silnika transkrypcji (Transcription Engine Status).

Aktualizacje serwera transkrypcji

Zaplanowane

Serwer AI 3CX sprawdza dostępność aktualizacji i automatycznie aktualizuje się do najnowszej wersji. Zadanie automatycznej aktualizacji jest uruchamiane w każdą niedzielę o 1:00 rano (czasu serwera).

Na żądanie

Jeśli chcesz zaktualizować system do najnowszej wersji przed planowanym oknem aktualizacji:

  • Zaloguj się do swojego serwera AI 3CX przez SSH i uzyskaj uprawnienia roota.
  • Wykonaj następujące polecenia:

sudo apt update

sudo apt -y upgrade

Skonfiguruj transkrypcję

Zapoznaj się z tym dokumentem, aby dowiedzieć się, jak włączyć i skonfigurować transkrypcję dla wybranych endpointów.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 26 sierpnia 2026 r.
https://www.3cx.pl/docs/serwer-silnika-transkrypcji/