Instalacja serwera 3CX AI na macOS/Debian (NVIDIA)

Wprowadzenie

Ten przewodnik wyjaśnia, jak zainstalować serwer 3CX AI dla centrali 3CX PBX w wersji 20 Update 10 i nowszych na wspieranym komputerze Mac z procesorem Apple Silicon (np. Mac Mini). Serwer 3CX AI będzie odpowiedzialny za transkrypcję połączeń PBX oraz przeprowadzanie analizy rozmów.

Wymagania ogólne

  • Potrzebujesz dostępu do Konsoli Administracyjnej 3CX oraz dostęp do terminala (shell) lub terminala na maszynie (macOS lub Debian), na której zostanie uruchomiony serwer 3CX AI.
  • Wymagane są lokalne uprawnienia administratora (do podnoszenia uprawnień za pomocą sudo).
  • Upewnij się, że serwer 3CX AI może połączyć się z centralą PBX przez jej główny port SSL (zazwyczaj 443 lub 5001) oraz ma dostęp do serwerów pobierania 3CX.
  • Jeśli opcja „3CX AI Server” nie jest widoczna w centrali PBX, upewnij się, że używasz poprawnej wersji systemu (Build) oraz odpowiedniej licencji 3CX, a następnie sprawdź ponownie w sekcji „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja) > „3CX AI Server”.

Wymagania dla macOS

  • Obsługiwane są wyłącznie komputery Mac z procesorami Apple Silicon. Procesory Intel nie są wspierane.
  • Minimalna pamięć to 16 GB RAM. Zalecanym celem jest 24 GB RAM, a sprzęt klasy Mac Mini jest przewidywanym punktem wyjścia dla praktycznych wdrożeń.

Wymagania dla systemu Debian

  • Użyj systemu Debian 12 lub Debian 13 ze wspieraną kartą graficzną NVIDIA, najlepiej z preinstalowanymi sterownikami NVIDIA i bibliotekami CUDA.
  • Minimalne wymagania sprzętowe to 16 GB RAM, 20 GB wolnego miejsca na dysku oraz 16 GB pamięci VRAM. Zalecanym celem jest 24 GB RAM i karta graficzna klasy RTX z 24 GB pamięci.

Weryfikacja zgodności komputera Mac

Użyj komputera Mac z Apple Silicon posiadającego wystarczającą ilość wolnego miejsca na dysku i pamięci operacyjnej dla przewidywanego obciążenia transkrypcją i analizą.

uname -m ; system_profiler SPHardwareDataType | egrep 'Chip|Memory'

Prawidłowy wynik powinien wskazywać architekturę Apple Silicon oraz oczekiwaną ilość pamięci. Przykład:

arm64

2026-07-10 16:35:56.134 system_profiler[2278:79797] hw.cpufamily: 0x17d5b93a

      Chip: Apple M4 Pro

      Memory: 24 GB

Jeśli Mac raportuje procesor Intel, nie wykazuje architektury Apple Silicon lub posiada zbyt mało pamięci, należy przerwać instalację i przenieść ją na wspierany model komputera.

Przygotowanie hosta Linux

Aktualizacja systemu operacyjnego

Przed instalacją serwera 3CX AI wykonaj aktualizację pakietów:

sudo apt-get update

sudo apt-get upgrade

Zrestartuj maszynę, aby upewnić się, że uruchomione jądro systemu (kernel) i zainstalowane nagłówki są zgodne:

sudo reboot

Instalacja podstawowych narzędzi

Zainstaluj pakiety wymagane przez instalator:

sudo apt -y install curl apt-transport-https gnupg gpg wget

Sprawdź, czy sterowniki NVIDIA i CUDA są zainstalowane:

nvidia-smi

Prawidłowy wynik powinien wyglądać podobnie do poniższego:

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                                                             |

+-----------------------------------------------------------------------------------------+

Jeśli nie widzisz poprawnego wyniku dla nvidia-smi, zaloguj się jako root i upewnij się, że narzędzie (nvidia-smi) jest zainstalowane wraz z wymaganymi zależnościami:

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

Po restarcie potwierdź działanie poleceniem nvidia-smi.

Instalacja serwera 3CX AI

Po stronie centrali PBX

  • W centrali przejdź do „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja).
  • Z menu rozwijanego wybierz „3CX AI Server” i kliknij przycisk „+ Add AI Server” (+ Dodaj serwer AI).
  • Skopiuj wygenerowane polecenie instalacyjne za pomocą przycisku kopiowania.

Po stronie serwera AI

curl -fsSL https://wmr-cdn.3cx.net/templates/install.sh | sudo bash -s -- mypbx.example.com 22334455-6677-8899-aabb-ccddeeff0011

  • W terminalu wklej i uruchom polecenie skopiowane wcześniej z centrali PBX.
  • Na systemie Debian:

  • Jeśli używasz profesjonalnej karty graficznej, takiej jak Nvidia L4 u dostawcy chmurowego z 22 GB pamięci, możesz zostać zapytany o wyłączenie ECC na GPU. Jeśli wyrazisz zgodę (wpisz „y”), funkcja ECC zostanie wyłączona, co pozwoli odzyskać 2 GB pamięci, która inaczej pozostałaby niewykorzystana. Pamiętaj, że wyłączenie ECC spowoduje natychmiastowy restart maszyny; po restarcie będziesz musiał wrócić do pierwszego kroku instalacji.

  • Instalator zapyta następnie o zgodę na instalację oraz akceptację warunków; zaakceptuj, aby kontynuować:

  • Instalator pobierze wymagane komponenty, utworzy konfigurację, zainstaluje usługi i zarejestruje serwer AI w centrali PBX.

Potwierdzenie działania serwera 3CX AI

  • Wróć do „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja) i potwierdź, że status nowego serwera AI jest zielony.

  • Możesz wykonać kilka połączeń testowych; gdy nagrania będą przetwarzane, Konsola Administracyjna pokaże informacje o kolejce i aktywności.

Korzystanie z tego samego serwera AI przez wiele central PBX

Możesz zezwolić na korzystanie z tego samego serwera AI przez wiele systemów 3CX. Aby to zrobić, po prostu powtórz powyższy proces instalacji dla nowej centrali PBX.

Na nowej centrali przejdź do „Integrations” > „Transcription”, kliknij „Add AI Server”, a następnie na istniejącym już serwerze AI wklej nowe polecenie i naciśnij enter. Ponieważ serwer AI jest już zainstalowany na tym hoście, proces pominie gotowe komponenty i jedynie autoryzuje nową centralę PBX do korzystania z serwera.

Zarządzanie serwerem 3CX AI

Serwer 3CX AI instaluje kilka usług, w tym konwerter, transkryber oraz usługę Ollama.

Zarządzanie usługami 3CX AI na macOS

Użyj narzędzia launchctl do interakcji z usługami:

Zatrzymanie (i wyrejestrowanie) usług:

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

Uruchomienie (i zarejestrowanie) usług:

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

Zarządzanie usługami 3CX AI na Debianie

Do zarządzania stanem usług 3CX użyj następujących poleceń:

Sprawdzenie statusu:

sudo systemctl status 3cxai-converter 3cxai-transcriber 3cxai-ollama

Restart usług:

sudo systemctl restart 3cxai-converter 3cxai-transcriber 3cxai-ollama

Zatrzymanie usług:

sudo systemctl stop 3cxai-converter 3cxai-transcriber 3cxai-ollama

Uruchomienie usług:

sudo systemctl start 3cxai-converter 3cxai-transcriber 3cxai-ollama

Odinstalowanie serwera AI

Aby usunąć pakiet serwera AI z hosta, uruchom skrypt odinstalowujący z katalogu setup:

sudo /opt/3cx/aiserver/setup/3cxai-uninstall.sh

Zarządzanie połączonymi centralami PBX

Możesz zarządzać autoryzacjami central za pomocą wbudowanego skryptu connection manager. Pozwala on na podgląd, wyłączanie, ponowne włączanie lub usuwanie autoryzacji PBX.

Pomoc dla skryptu:

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --help

Lista wszystkich skonfigurowanych połączeń PBX i ich UUID:

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh

Wyłączenie połączenia PBX bez jego usuwania:

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --disable <UUID>

Ponowne włączenie wcześniej wyłączonego połączenia:

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --enable <UUID>

Trwałe usunięcie zapisanego połączenia PBX:

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --delete <UUID>

Rozwiązywanie problemów

Autoryzacje, konfiguracje i inne ustawienia serwera AI są zapisywane w plikach:

/opt/3cx/aiserver/setup/connections.json

/opt/3cx/aiserver/setup/config.json

Można zdiagnozować problem z serwerem, sprawdzając logi serwera znajdujące się w poniższej ścieżce.

/var/opt/3cx/aiserver/logs

Główne ścieżki instalacji pakietu AI Server:

/opt/3cx/aiserver

/var/opt/3cx/aiserver

  • Serwer AI nie działa: Upewnij się, że usługi są załadowane i serwer może połączyć się z PBX przez HTTPS.
  • Polecenie instalacji nie działa: Unikaj używania poleceń z poprzednich konfiguracji; usuń wpis serwera AI w PBX, utwórz nowy wpis i zainstaluj, korzystając z polecenia instalacji dla nowo wygenerowanego wpisu serwera 3CX AI.
  • nvidia-smi zgłasza błąd (tylko Debian): Napraw sterownik NVIDIA lub stan CUDA przed ponownym uruchomieniem instalatora.
  • PBX odrzuca połączenie: Usuń nieaktualną konfigurację i zainstaluj ponownie, używając polecenia z nowym identyfikatorem UUID.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 10 lipca 2026 r.
https://www.3cx.pl/docs/installing-ai-server-macos-debian/