在树莓派5上安装 3CX SBC

介绍

本指南旨在介绍如何在树莓派 5 上安装 3CX SBC。

3CX SBC 支持基于 Debian-12 (Bookworm) 和 Debian-13 (Trixie) 的树莓派操作系统。

重要提示：3CX 建议所有 Raspberry Pi 5 安装均使用 64 位 Raspberry Pi OS (arm64)。32 位版本 (armhf) 可能仍然可以运行，但 3CX 已不再对其进行常规测试或验证。

步骤1： 获取正确的树莓派版本

  • 一个树莓派 5 - 4GB/8GB
  • 一个信誉良好、最好是高耐用性的 microSD 卡。
  • 最小卡容量为 32GB；如果您希望为故障排除处理更大的日志文件，应考虑更大的容量。
  • 确保设备有一个允许最大限度散热的良好外壳。
  • 主动冷却外壳或树莓派主动冷却器。
  • 一个高质量的 5V、5A USB-C 电源。
  • 最好是官方的树莓派 5 电源。

步骤2：使用树莓派操作系统准备 SD 卡

  • 运行镜像工具，选择 树莓派 5 并点击 下一步

  • 在操作系统卡片上，向下滚动并选择 树莓派操作系统 (其他)，然后点击它。

  • 为您的树莓派选择正确的 Debian Bookworm 或 Trixie 树莓派操作系统 Lite 版本，然后点击 下一步
  • 对于大多数使用 Pi 5 的用户，选择 64 位 (arm64)
  • 如果您需要支持一些旧硬件，选择 32 位 (armhf)

  • 选择您要准备的 SD 卡
  • 保持选中 排除系统驱动器 以避免对系统驱动器的意外风险
  • 确认您的选择
  • 建议现在执行 自定义 步骤；如果您跳过，在首次启动时 Pi 上会运行一个包含相同选项的向导

  • 输入主机名
  • 设置您的时区和键盘布局
  • 创建您的默认用户帐户并设置一个您会记住的强密码
  • 必须 使用有线以太网连接 SBC，不支持 Wi-Fi。
  • 决定您将在安装后如何连接树莓派：
  • 使用密码或公钥认证的 SSH
  • 树莓派连接

  • 检查摘要中的相关信息是否符合预期，然后将镜像写入您的 SD 卡。
  • 镜像工具将在开始写入之前从树莓派的存储库下载最新的可用版本。

步骤3：启动您的树莓派

  • 将刚刚准备好的 SD 卡插入 Pi
  • 启动 Pi
  • 通过控制台、SSH 或 Pi Connect 连接到它

步骤4：设置静态 IP 地址

  • 运行 nmtui 命令：

sudo nmtui

  • 选择 编辑连接（Edit a connection）。
  • 选择您的网络连接。
  • 将 IPv4 设置为手动并点击 <Show>。
  • 根据您的局域网设置设置地址、网关和 DNS 服务器，然后按 <OK>。
  • 点击返回并退出以退出向导。
  • 重启 Pi：

sudo reboot

  • 当 Pi 完成重启后，使用您创建的用户登录，并验证 “eth0” IP 地址：

ip a

注意：在正确配置的 RFC 1918 私有网络上支持局域网安装：

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

步骤5：将 SBC 添加到您的 3CX PBX

在3CX中添加SBC

  • 登录 3CX 网页客户端并导航至“管理员 > 语音和聊天”。
  • 点击“+添加SBC”，选择“树莓派”，然后点击“继续”。
  • SBC 连接已在 PBX 端创建，正在等待实际的 SBC 连接。

步骤 6：在树莓派上安装 3CX SBC

  • 通过 CLI 或 SSH 使用主用户帐户登录树莓派。
  • 运行 3CX 安装脚本：

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

  • 选择 确定 以验证 “3CX 先决条件” 并接受 “最终用户许可协议” 以继续。
  • 输入您的 3CX 的 “配置 URL”（例如 https://example-pbx.3cx.com），然后选择 确定。
  • 输入 “认证密钥 ID” 并选择 确定。
  • 选择 确定 并继续安装和重启。

步骤 7：配置您的 IP 电话

一旦您的 SBC 安装完成，您可以通过此 SBC 配置您的 IP 电话，在 IP 电话设置期间选择它作为连接选项。

另请参阅

最后更新

本文档最后更新于 2026 年 7 月 16 日

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