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

Wprowadzenie

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

Wymagania ogólne

  • Dostęp do Konsoli Administracyjnej 3CX oraz dostęp do powłoki/terminala na maszynie (macOS lub Debian), na której uruchomiony zostanie serwer 3CX AI.
  • Lokalne uprawnienia administratora (możliwość użycia sudo).
  • Upewnij się, że serwer 3CX AI może połączyć się z centralą PBX na jej głównym porcie SSL (zazwyczaj 443 lub 5001) oraz ma dostęp do serwerów pobierania 3CX.
  • Jeśli opcja serwera 3CX AI nie jest widoczna w centrali PBX, upewnij się, że używasz odpowiedniej wersji kompilacji 3CX oraz licencji, a następnie sprawdź ponownie w zakładce „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja) > „3CX AI Server”.

Wymagania dotyczące systemu macOS

  • Obsługiwane są wyłącznie komputery Mac z procesorami Apple Silicon. Komputery Mac z procesorami Intel nie są obsługiwane.
  • Minimalna ilość pamięci RAM wynosi 16 GB. Zalecanym celem jest 24 GB RAM, a klasa sprzętowa Mac Mini stanowi oczekiwaną podstawową ścieżkę wdrożenia.

Wymagania dotyczące systemu Debian

  • Wymagany system Debian 12 lub Debian 13 z obsługiwaną kartą graficzną NVIDIA, najlepiej z fabrycznie zainstalowanymi sterownikami NVIDIA oraz bibliotekami CUDA.
  • Minimalne wymagania sprzętowe: 16 GB RAM, 20 GB wolnego miejsca na dysku oraz 16 GB VRAM. Zalecany cel to 24 GB RAM oraz karta graficzna klasy RTX z 24 GB VRAM.

Weryfikacja zgodności komputera Mac

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

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

Prawidłowy wynik ukaże architekturę Apple Silicon oraz oczekiwaną wielkość pamięci, na 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 komputer Mac zgłasza procesor Intel, nie wykrywa układu Apple Silicon lub posiada zbyt mało pamięci, zatrzymaj proces i przenieś instalację na obsługiwaną maszynę.

Przygotowanie hosta Linux

Aktualizacja systemu operacyjnego

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

sudo apt-get update

sudo apt-get upgrade

Uruchom ponownie maszynę, aby upewnić się, że uruchomione jądro i zainstalowane nagłówki są spójne:

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 oraz środowisko CUDA są zainstalowane:

nvidia-smi

 

Jeśli sterowniki są zainstalowane prawidłowo, pojawi się wynik podobny 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 polecenie nvidia-smi nie zwróci prawidłowego wyniku, przełącz się na konto root i zainstaluj sterownik NVIDIA 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 ponownym uruchomieniu potwierdź działanie stosu NVIDIA za pomocą polecenia nvidia-smi.

Instalacja serwera 3CX AI

Po stronie centrali PBX

  • W centrali PBX przejdź do: „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja).
  • Z listy rozwijanej 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 maszyny AI wklej i uruchom skopiowane polecenie.
  • 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 jednego 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 „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja) i 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.

Wyświetlenie pomocy 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 PBX:

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 9 września 2026 r.
https://www.3cx.pl/docs/installing-ai-server-macos-debian/