Instalacja 3CX SBC na Raspberry Pi 5

Wprowadzenie

Ten przewodnik opisuje proces instalacji 3CX SBC na urządzeniu Raspberry Pi 5.

3CX SBC wspiera system Raspberry Pi OS oparty na Debianie 12 (Bookworm) oraz Debianie 13 (Trixie).

Ważne: 3CX zaleca system Raspberry Pi OS 64-bit (arm64) dla wszystkich instalacji na Raspberry Pi 5. Wersja 32-bitowa (armhf) może nadal działać, ale nie jest już rutynowo testowana ani weryfikowana przez 3CX.

Krok 1: Wybór odpowiedniego modelu Raspberry Pi

  • Urządzenie: Raspberry Pi 5 – 4 GB / 8 GB RAM.
  • Karta pamięci: Markowa karta microSD, najlepiej o podwyższonej trwałości (endurance-rated).
  • Minimalny rozmiar karty to 32 GB; jeśli chcesz przechowywać większe pliki logów w celach diagnostycznych, rozważ większą pojemność.
  • Chłodzenie: Upewnij się, że urządzenie posiada solidną obudowę zapewniającą maksymalne chłodzenie.
  • Zalecana obudowa z aktywnym chłodzeniem lub moduł Raspberry Pi Active Cooler.
  • Zasilanie: Wysokiej jakości zasilacz USB-C 5V, 5A.
  • Najlepiej oryginalny zasilacz do Raspberry Pi 5.

Krok 2: Przygotowanie karty SD z systemem Raspberry Pi OS

  • Pobierz narzędzie Raspberry Pi Imager i zainstaluj je. Pełną dokumentację narzędzia znajdziesz na powiązanej stronie.
  • Uruchom program, wybierz „Raspberry Pi 5” i kliknij „NEXT” (Dalej).

  • W sekcji systemów operacyjnych przewiń w dół, wybierz „Raspberry Pi OS (other)” i kliknij tę opcję.

  • Wybierz odpowiednią wersję systemu operacyjnego Debian Bookworm lub Trixie Raspberry Pi OS Lite dla swojego urządzenia i kliknij „NEXT” (Dalej).
  • 64-bit (arm64) – Zalecane. Używaj tej opcji dla wszystkich nowych instalacji na Raspberry Pi 5. Jest to architektura przetestowana i zweryfikowana przez 3CX.
  • 32-bit (armhf) – Wyłącznie dla kompatybilności wstecznej (legacy). Wersja 32-bitowa może nadal działać, ale nie jest już testowana ani weryfikowana przez 3CX. Przyszła kompatybilność nie jest gwarantowana.

  • Wybierz kartę SD, którą chcesz przygotować.
  • Zostaw zaznaczoną opcję „Exclude system drives”, aby uniknąć przypadkowego sformatowania dysków systemowych.
  • Potwierdź wybór.
  • Zaleca się wykonanie kroków personalizacji (Customisation) teraz; jeśli je pominiesz, kreator z tymi samymi opcjami uruchomi się na urządzeniu przy pierwszym boocie.

  • Wprowadź nazwę hosta („hostname”).
  • Ustaw strefę czasową oraz układ klawiatury.
  • Utwórz domyślne konto użytkownika i ustaw silne hasło, które zapamiętasz.
  • SBC musi korzystać z połączenia przewodowego (Ethernet); Wi-Fi nie jest obsługiwane.
  • Zdecyduj, jak będziesz łączyć się z Raspberry po instalacji:
  • SSH (hasło lub klucz publiczny).
  • Raspberry Pi Connect.

  • Sprawdź podsumowanie („Summary”) i rozpocznij zapisywanie obrazu na karcie SD.
  • Program pobierze najnowszą dostępną wersję z repozytorium Raspberry przed rozpoczęciem zapisu.

Krok 3: Uruchomienie Raspberry Pi

  • Włóż przygotowaną kartę SD do gniazda w Raspberry Pi.
  • Uruchom urządzenie.
  • Połącz się z nim przez konsolę, SSH lub Pi Connect.

Krok 4: Ustawienie statycznego adresu IP

  1. Uruchom polecenie nmtui:

sudo nmtui

  1. Wybierz „Edit a connection” (Edytuj połączenie).
  2. Wybierz swoje połączenie sieciowe.
  3. Ustaw „IPv4” na „Manual” (Ręcznie) i kliknij „<Show>”.
  4. Ustaw adres (Address), bramę (Gateway) oraz serwer DNS zgodnie z ustawieniami Twojej sieci LAN, a następnie naciśnij „<OK>”.
  5. Kliknij „Back” i „Quit”, aby wyjść z kreatora.
  6. Zrestartuj urządzenie:

sudo reboot

  1. Po ponownym uruchomieniu zaloguj się na utworzone konto i zweryfikuj adres IP interfejsu „eth0”:

ip a

Uwaga: Instalacje w sieci LAN są wspierane w prawidłowo skonfigurowanych sieciach prywatnych RFC 1918:

  • 10.0.0.0/8
  • 172.16.0.0/12
  • 192.168.0.0/16

Krok 5: Dodanie SBC do centrali 3CX PBX

  1. Zaloguj się do Konsoli Administracyjnej 3CX i przejdź do sekcji „Voice & Chat” (Głos i czat).
  2. Kliknij „+ Add SBC”, wybierz „Raspberry Pi” i kliknij „Continue” (Kontynuuj).
  3. Połączenie SBC zostało utworzone po stronie centrali PBX i oczekuje na połączenie fizycznego urządzenia.

Krok 6: Instalacja 3CX SBC na Raspberry Pi

  1. Zaloguj się na Raspberry Pi na główne konto użytkownika (przez CLI lub SSH).
  2. Uruchom skrypt instalacyjny 3CX:

sudo bash -c "$(wget -qO- https://downloads-global.3cx.com/downloads/sbc/3cxsbc.zip)"

  1. Wybierz „OK”, aby zweryfikować wymagania wstępne („3CX Pre-requisites”) i zaakceptuj Umowę Licencyjną Użytkownika Końcowego (EULA), aby kontynuować.
  2. Wprowadź adres URL autokonfiguracji („Provisioning URL”) swojej centrali 3CX (np. https://example-pbx.3cx.com) i wybierz „OK”.
  3. Wprowadź „Authentication KEY ID” i wybierz „OK”.
  4. Wybierz „OK” i kontynuuj instalację oraz restart.

Krok 7: Autokonfiguracja (provisioning) telefonów IP

Gdy SBC zostanie zainstalowany, możesz konfigurować telefony IP za jego pośrednictwem, wybierając go jako opcję połączenia podczas dodawania telefonu IP.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 23 lipca 2026 r.
https://www.3cx.pl/docs/instalacja-pbx-raspberry-pi/