ferdytao/3cx

ferdytao/3cx: 树莓派4 ARM64架构的3CX IP PBX镜像

镜像概述

ferdytao/3cx是一个专为树莓派4（ARM64架构）构建的3CX IP PBX镜像，基于farfui/3cx项目开发，用于在ARM64设备上部署IP电话系统。该镜像支持系统级配置、网络隔离及数据持久化，适合小型企业或个人在树莓派环境中搭建 VoIP 通信系统。

核心功能与特性

• ARM64架构支持：专为树莓派4优化，适配ARM64处理器
• macvlan网络：支持创建独立网络接口，实现容器与物理网络的直接通信
• 数据持久化：通过卷挂载实现备份、录音和日志数据的持久化存储
• 系统级权限：包含必要的系统权限配置（如apparmor、capabilities），确保3CX服务正常运行
• 时区配置：支持通过命令行设置自定义时区
• 初始向导：提供3CX初始化配置向导，简化系统部署流程

使用场景

• 树莓派4设备上部署小型IP电话系统
• 家庭或小型办公室的VoIP通信解决方案
• ARM64架构设备的3CX PBX测试与学习环境

使用方法

前置要求

• 树莓派4（ARM64架构）
• Docker环境已安装
• 支持macvlan网络的网络接口（如eth0）

1. 创建macvlan网络

需根据实际网络环境调整子网、网关和父接口参数：

sh
docker network create -d macvlan --subnet 192.168.1.0/24 --gateway 192.168.1.1 -o parent=eth0 mv_eth0

参数说明：

• --subnet：容器网络子网（需与物理网络匹配）
• --gateway：网关IP（物理网络网关）
• -o parent：物理网络接口（如eth0、wlan0）

2. 运行容器

sh
docker run -d \
--hostname {你的主机名} \
--memory {内存限制，如2g} \
--memory-swap {交换内存限制，如4g} \
--ip {容器IP地址，如192.168.1.100} \
--network mv_eth0 \
--restart unless-stopped \
-v 3cx_backup:/mnt/backup \
-v 3cx_recordings:/mnt/recordings \
-v 3cx_log:/var/log \
-v /sys/fs/cgroup:/sys/fs/cgroup:ro \
--security-opt apparmor=unconfined \
--cap-add SYS_ADMIN \
--cap-add NET_ADMIN \
--name 3cx \
ferdytao/3cx:latest

参数说明：

• --hostname：容器主机名
• --memory/--memory-swap：内存和交换内存限制（建议至少2GB内存）
• --ip：容器在macvlan网络中的静态IP
• --network：使用步骤1创建的macvlan网络
• 卷挂载：
  • 3cx_backup：3CX备份数据
  • 3cx_recordings：通话录音
  • 3cx_log：系统日志
• 权限配置：--security-opt和--cap-add为必要权限，确保3CX服务正常运行

3. 设置时区

时区列表可在容器内/usr/share/zoneinfo/目录下查看：

sh
docker exec 3cx timedatectl set-timezone {时区，如Asia/Shanghai}

4. 启动3CX初始化向导

sh
docker exec -ti 3cx /usr/sbin/3CXWizard --cleanup

执行后将进入3CX图形化配置向导，按提示完成系统初始化。

技术细节

暴露端口

容器暴露以下端口（用于3CX服务通信）：

• TCP: 5015, 5001, 5060, 5061, 5090
• UDP: 5060, 5090, 9000-9500

环境变量

• DEBIAN_FRONTEND=noninteractive：非交互模式安装Debian包
• LANG=en_US.UTF-8：默认语言编码
• container=docker：标识容器环境

构建信息

该镜像基于Debian Stretch构建，通过build.sh脚本自动化构建流程，包含3CX PBX依赖安装及系统服务配置。