Установка 3CX SBC на Raspberry Pi 5

Введение

В данном руководстве описывается процесс установки 3CX SBC на Raspberry Pi 5.

3CX SBC поддерживает операционную систему Raspberry Pi OS на базе Debian-12 (Bookworm) и Debian-13 (Trixie).

Важно: для всех установок на Raspberry Pi 5 компания 3CX рекомендует использовать 64-разрядную версию Raspberry Pi OS (arm64). 32-разрядная версия (armhf) по-прежнему может функционировать, однако 3CX больше не проводит ее регулярное тестирование и валидацию.

Шаг 1: Подбор подходящей модели Raspberry Pi

  • Raspberry Pi 5 - 4GB/8GB
  • Надежная карта памяти microSD, желательно класса endurance
  • Минимальный объем карты составляет 32 ГБ; однако, если требуется работа с объемными файлами журналов для устранения неполадок, следует рассмотреть карту большего объема.
  • Убедитесь, что устройство имеет хороший корпус, обеспечивающий максимальное охлаждение.
  • Корпус с активным охлаждением или Raspberry Pi Active Cooler.
  • Высококачественный блок питания USB-C на 5В, 5А.
  • В идеале — официальный блок питания Raspberry Pi 5.

Шаг 2: Подготовьте SD-карту с Raspberry Pi OS

  • Скачайте и установите Raspberry Pi Imager. Полная документация по Imager доступна на соответствующей странице.
  • Запустите imager, выберите Raspberry Pi 5 и нажмите NEXT

  • На вкладке OS прокрутите вниз, выберите Raspberry Pi OS (other) и нажмите на этот пункт.

  • Выберите подходящую версию Debian Bookworm или Trixie Raspberry Pi OS Lite для Raspberry и нажмите NEXT
  • 64-разрядная (arm64) — Рекомендуется. Используйте этот вариант для всех новых установок на Raspberry Pi 5. Данная архитектура проходит регулярное тестирование и валидацию со стороны 3CX.
  • 32-разрядная (armhf) — Только для обратной совместимости. 32-разрядная версия по-прежнему может функционировать, однако 3CX больше не проводит ее тестирование и валидацию. Совместимость в будущем не гарантируется.

  • Выберите SD-карту для подготовки
  • Оставьте флажок Exclude system drives включенным во избежание случайного риска для системных дисков
  • Подтвердите выбор
  • Рекомендуется выполнить шаги по настройке (Customisation) на этом этапе; если их пропустить, мастер с аналогичными опциями запустится на Pi при первой загрузке

  • Введите имя хоста
  • Настройте часовой пояс и раскладку клавиатуры
  • Создайте учетную запись пользователя по умолчанию и установите надежный пароль, который легко запомнить
  • SBC должен использовать проводное подключение Ethernet, поскольку WiFi не поддерживается.
  • Определите способ подключения к Raspberry после установки:
  • SSH с аутентификацией по паролю или открытому ключу
  • Raspberry Pi connect

  • Проверьте правильность соответствующей информации в разделе Summary, после чего запишите образ на SD-карту.
  • Imager скачает последнюю доступную версию из репозитория Raspberry перед началом записи.

Шаг 3: Загрузка Raspberry Pi

  • Вставьте подготовленную SD-карту в Pi
  • Загрузите Pi
  • Подключитесь к устройству через консоль, SSH или Pi Connect

Шаг 4: Задайте статический IP-адрес

  • Выполните команду nmtui:

sudo nmtui

  • Выберите Edit a connection.
  • Выберите сетевое подключение.
  • Установите для IPv4 значение Manual и нажмите <Show>.
  • Настройте параметры Address, Gateway и DNS server в соответствии с настройками локальной сети, затем нажмите <OK>.
  • Нажмите Back и Quit для выхода из мастера
  • Перезагрузите Pi:

sudo reboot

  • После завершения перезагрузки Pi выполните вход под созданным пользователем и проверьте IP-адрес интерфейса "eth0":

ip a

Примечание: Установки в локальной сети поддерживаются в правильно настроенных частных сетях RFC 1918:

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

Шаг 5: Добавьте SBC в АТС 3CX

  • Войдите в консоль администратора 3CX и перейдите в раздел Voice & Chat
  • Нажмите + Add SBC, выберите Raspberry Pi и нажмите Continue.
  • Подключение SBC на стороне АТС создано и ожидает подключения фактического устройства SBC.

Шаг 6: Установка SBC 3CX на Raspberry Pi

  • Выполните вход в Raspberry Pi с использованием основной учетной записи через CLI или SSH.
  • Запустите установочный скрипт 3CX:

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

  • Выберите OK для проверки "3CX Pre-requisites" и примите "End-user License Agreement", чтобы продолжить.
  • Введите "Provisioning URL" для АТС 3CX (например, [https://example-pbx.3cx.com](https://example-pbx.3cx.com)) и выберите OK.
  • Введите "Authentication KEY ID" и выберите OK.
  • Выберите OK, затем продолжите установку и перезагрузку.

Шаг 7: Автонастройка IP-телефонов

После установки SBC можно выполнить настройку IP-телефонов через этот SBC, выбрав его в качестве варианта подключения во время настройки IP-телефона.

Дополнительная информация

Версия документа

Последнее обновление документа 23 июля 2026

https://www.3cx.ru/docs/installing-pbx-raspberry-pi/