deanturpin/asterisk

deanturpin/asterisk

该镜像提供开源IP PBX系统Asterisk的容器化部署方案，方便用户快速搭建语音通信服务。你可查看https://github.com/deanturpin/asterisk/blob/main/Dockerfile了解构建细节。

构建时，示例sip.conf和extensions.conf文件会被复制到容器内；运行时，若SECRET文件非空，密钥会被替换，随后启动Asterisk。

核心功能

• 容器化运行Asterisk，简化部署流程
• 支持运行时替换密钥，提升安全性
• 提供CLI工具rasterisk管理Asterisk实例
• 允许自定义映射配置文件，灵活适配需求

使用场景

• 企业内部语音通信系统搭建
• VoIP服务的测试与开发环境
• 小型团队的语音协作平台部署

配置说明与部署示例

从Docker Hub运行

bash
docker run --rm -it --network=host docker.xuanyuan.run/deanturpin/asterisk

查看SIP peers

使用CLI工具rasterisk：

bash
docker exec -it <容器ID> rasterisk

进入CLI后执行：

bash
> sip show peers

会显示当前配置的SIP peer状态。

导出配置

查看配置文件内容（含密钥）：

bash
docker exec -it <容器ID> cat /etc/asterisk/sip.conf

覆盖密钥

为避免使用默认密码，可在运行时指定自定义密钥文件：

bash
docker run --rm -it --network=host -v /etc/machine-id:/app/SECRET docker.xuanyuan.run/deanturpin/asterisk

也可直接映射自定义配置文件：

bash
docker run --rm -it --network=host -v /path/to/your/sip.conf:/etc/asterisk/sip.conf -v /path/to/your/extensions.conf:/etc/asterisk/extensions.conf docker.xuanyuan.run/deanturpin/asterisk

开发容器

克隆仓库https://github.com/deanturpin/dev，执行`make`本地构建运行：

bash
git clone https://github.com/deanturpin/dev.git
cd dev
make

实用技巧

• 启动容器并运行bash：make bash
• 查看容器网络接口：make ip
• 查找端点：docker run -it --rm --network=host deanturpin/shh
• 检查端口开放：ss -an | grep 5060