christoofar/asterisk

Asterisk PBX Docker镜像

这是一个稳定可用的Asterisk PBX服务器Docker镜像，基于Debian-slim构建。由于Asterisk 14及以后版本对Alpine的glibc支持不佳，故选择Debian-slim作为基础镜像，编译后清理不必要组件，镜像大小小于200MB，适合小型云实例或边缘设备部署。当前LTS版本为16.8.0。

镜像已配置标准编解码器和选项，建议挂载主机的/etc/asterisk目录以自定义配置；若未挂载，则使用默认配置（无SIP扩展，但包含可拨打美加 toll-free号码的PBX中继）。此外，可挂载/var/lib/asterisk/sounds添加自定义声音包，或挂载SSL证书目录以配置加密服务。

核心功能

• 支持SIP和IAX通道驱动
• 默认 outbound中继可拨打美国/加拿大 toll-free号码
• 提供测试IAX2扩展（启动容器时会生成登录凭证）
• 支持amd64、arm64、armv6、armv7多架构（适配树莓派等边缘设备）
• 可挂载自定义配置、声音文件和SSL证书

使用场景

• 快速部署企业内部VOIP电话系统
• 边缘设备（如树莓派）上搭建轻量级通信服务
• 测试VOIP客户端与服务器的连接
• 开发自定义拨号计划和通信功能

配置说明

1. 挂载配置目录：将主机的配置目录挂载到容器的/etc/asterisk，可使用仓库中的示例配置或自定义配置文件（如sip.conf、extensions.conf）。
2. 挂载声音文件：若需添加自定义声音包，挂载/var/lib/asterisk/sounds目录。
3. SSL证书：若配置加密服务（如TCP/TLS、ARI），需挂载证书目录。

部署示例

基础运行（首次运行建议不使用-d参数）

bash
docker run -p 5060:5060/udp -p 4569:4569/udp --name asterisk christoofar/asterisk

挂载自定义配置

bash
docker run -p 5060:5060/udp -p 4569:4569/udp -v ~/asteriskconfig:/etc/asterisk --name asterisk christoofar/asterisk

连接Asterisk CLI

bash
# 方法1
docker exec -it asterisk /bin/bash
asterisk -rvvvvv

# 方法2
docker exec -it asterisk asterisk -rvvvvv

测试Asterisk

1. 启动容器后，通过docker exec查看/etc/asterisk/iax.conf获取测试IAX2扩展（TESTUSER）的密码。
2. 使用Zoiper等IAX客户端连接：输入用户名TESTUSER、密码及主机公网IP，端口4569（UDP）。
3. 拨打测试号码1 (800) 444-4444验证 outbound中继功能。

RTP端口与Docker

Docker难以转发大范围UDP端口，可通过--network=host让容器直接使用主机网络（注意：此方式存在安全风险，需谨慎使用）：

bash
docker run --network=host -v ~/asteriskconfig:/etc/asterisk --name asterisk christoofar/asterisk

本地构建镜像

bash
git clone https://github.com/christoofar/asterisk/
cd asterisk
docker build -t asterisk .
docker run -p 5060:5060/udp -p 4569:4569/udp -v ~/asteriskconfig:/etc/asterisk --name asterisk asterisk