Konfiguracja serwera AI 3CX dla transkrypcji

Wprowadzenie

Ten przewodnik dotyczy centrali 3CX Phone System w wersji 20 U9 i niższych i wyjaśnia, jak zainstalować oraz skonfigurować serwer 3CX AI na potrzeby wdrożeń lokalnych (on-premise) lub w chmurze. Jeśli używasz wersji 3CX V20 U10 lub nowszej, zapoznaj się z odpowiednim nowszym przewodnikiem.

Serwer 3CX AI dodaje do Twojej centrali 3CX Phone System funkcje transkrypcji opartej na sztucznej inteligencji, wykrywanie mówców oraz analizę transkrypcji. Może być wdrożony lokalnie lub w chmurze i integruje się bezpośrednio z konsolą administracyjną.

Uwaga: Funkcja jest dostępna dla licencji 3CX AI od 8 jednoczesnych połączeń (8SC) wzwyż.

O przykładach w tym dokumencie

W tym dokumencie użyto przykładowej nazwy FQDN centrali example.com oraz FQDN maszyny transkrypcyjnej wmr.3cx-example.com. Należy zastąpić je własnymi nazwami FQDN.

Wymagania dotyczące maszyny hosta

Specyfikacja sprzętowa

  • GPU: Minimum zalecane (szybkie): Karta graficzna Nvidia 24GB RTX GPU
  • CPU: Minimum: 4 vCPU, Zalecane: 6 vCPU
  • RAM: Minimum: 24 GB
  • Miejsce na dysku: Minimum: 20 GB wolnego miejsca
  • Środowisko: Lokalnie (On-premise) lub Chmura

Ustawienia BIOS

  • Secure Boot: Wyłączone (Disabled)
  • CSM: Wyłączone (Disabled)
  • Resize BAR Support: Wyłączone (Disabled) (może wymagać podwójnego 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 na ruch tylko z adresu IP centrali PBX
  • TCP 80 – na potrzeby tworzenia/odnawiania certyfikatów SSL Let’s Encrypt; zazwyczaj nie jest to konieczne, jeśli używasz własnych certyfikatów SSL

Konfiguracja systemu

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

apt-get update

apt-get upgrade

  • Zainstaluj wymagane pakiety:

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

  • Aby upewnić się, że wszystkie aktualizacje systemowe odniosły skutek (w szczególności aktualizacja jądra), uruchom ponownie system:

reboot

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

nvidia-smi

  • Jeśli otrzymasz odpowiedź 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 ponownym uruchomieniu potwierdź, że wszystko działa prawidłowo:

nvidia-smi

  • Wyświetli to aktualny stan maszyny:

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

Uruchomienie polecenia instalacyjnego

  • W konsoli administracyjnej przejdź do: „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja).
  • Ustaw dostawcę transkrypcji (Transcription Provider) na 3CX Transcription Engine (Installed Locally).
  • Kliknij przycisk Proceed (Kontynuuj).

  • Na stronie transkrypcji wyświetli się polecenie instalacyjne do uruchomienia na maszynie transkrypcyjnej; kliknij przycisk Copy (Kopiuj), aby skopiować polecenie do schowka.
  • Zaloguj się do maszyny transkrypcyjnej przez SSH i przełącz się na konto root.
  • Uruchom polecenie instalacyjne, podobnie jak w poniższym przykładzie:

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

Kreator instalacji transkrypcji

Zostaniesz poproszony o wybór, czy chcesz użyć własnych certyfikatów SSL, czy certyfikatów wygenerowanych za pomocą Let's Encrypt.

Używanie 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 (oraz ewentualnie łańcuch certyfikatów)
  • server.key musi zawierać Twój klucz prywatny
  • Upewnij się, że dla plików certyfikatów ustawiono odpowiednie uprawnienia:

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 serwera 3CX AI przez SSH i przełącz się na konto root.
  • 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 serwera 3CX AI przez SSH i przełącz się na konto root.
  • 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 prawa do wykonywania:

chmod +x /root/certupdate.sh

  • Edytuj tabelę crontab:

crontab -e

  • Dodaj następujący wpis do crontab:

0 3 * * * /root/certupdate.sh

Polityka FQDN dostarczanego przez 3CX

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

  • Domena FQDN zostanie usunięta, jeśli serwer 3CX AI zostanie usunięty w interfejsie użytkownika PBX.
  • Jeśli Twoja centrala PBX nie połączy się z serwerem wmr.3cx.net w ciągu 30 dni, domena FQDN zostanie usunięta automatycznie.

Weryfikacja połączenia z serwerem transkrypcji

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

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

OK

[email protected]:~$

Odpowiedź OK oznacza pomyślne nawiązanie połączenia.

Możesz również przejść do „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja), aby sprawdzić status silnika transkrypcji (Transcription Engine Status).

Aktualizacje serwera transkrypcji

Zaplanowane

Serwer 3CX AI automatycznie sprawdza i aktualizuje się do najnowszej wersji. Zadanie automatycznej aktualizacji uruchamia się w każdą niedzielę o godzinie 1:00 (czasu serwera).

Na żądanie

Jeśli chcesz zaktualizować serwer do najnowszej wersji przed zaplanowanym oknem aktualizacji:

  • Zaloguj się do serwera 3CX AI przez SSH i przełącz się na konto root.
  • Wykonaj następujące polecenia:

sudo apt update

sudo apt -y upgrade

Konfiguracja transkrypcji

Zapoznaj się z dokumentem konfiguracji transkrypcji, aby dowiedzieć się, jak włączyć i skonfigurować transkrypcję dla wybranych punktów końcowych.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 29 września 2026 r.
https://www.3cx.pl/docs/serwer-silnika-transkrypcji/