bettervoice/freeswitch-container

FreeSWITCH Docker容器镜像概述

该镜像用于在Docker容器中部署FreeSWITCH服务器，当前使用稳定版本1.6.x。镜像内置大量模块以适配多种通信场景，同时集成fail2ban增强安全防护（需--privileged权限运行以更新IPTables规则）。

核心功能

1. SIP信令支持：暴露5060/5080（TCP/UDP）及WebSocket端口（5066/7443 TCP）。
2. 媒体处理：支持64535-65535 UDP端口的媒体流传输。
3. 丰富模块：涵盖应用（会议、语音信箱、呼叫中心）、编解码（G.711、Opus等）、语音识别/合成、脚本语言（Lua、Python）等类别。
4. 安全防护：集成fail2ban防止***。
5. 灵活配置：支持挂载自定义配置目录，适配不同场景需求。

使用场景

• 企业内部通信系统搭建
• 呼叫中心平台部署
• VoIP服务提供商基础架构
• 语音/视频会议系统开发与测试

配置说明

端口映射

镜像暴露以下端口：

• SIP信令：5060(TCP/UDP)、5080(TCP/UDP)
• WebSocket信令：5066(TCP)、7443(TCP)
• Event Socket：8021(TCP)
• 媒体端口：64535-65535(UDP)

部署示例

Docker Run命令

bash
CID=$(sudo docker run --name freeswitch -p 5060:5060/tcp -p 5060:5060/udp -p 5080:5080/tcp -p 5080:5080/udp -p 8021:8021/tcp -p 7443:7443/tcp -p 60535-65535:60535-65535/udp -v /home/ubuntu/freeswitch/conf:/usr/local/freeswitch/conf bettervoice/freeswitch-container:1.6.6)

注意：FreeSWITCH需有权限读取挂载的配置目录。

大端口范围映射优化

由于Docker映射大端口范围存在内存占用问题，可移除端口映射并手动添加IPTables规则：

bash
CIP=$(sudo docker inspect --format='{{.NetworkSettings.IPAddress}}' $CID)
sudo iptables -A DOCKER -t nat -p udp -m udp ! -i docker0 --dport 60535:65535 -j DNAT --to-destination $CIP:60535-65535
sudo iptables -A DOCKER -p udp -m udp -d $CIP/32 ! -i docker0 -o docker0 --dport 60535:65535 -j ACCEPT
sudo iptables -A POSTROUTING -t nat -p udp -m udp -s $CIP/32 -d $CIP/32 --dport 60535:65535 -j MASQUERADE

Systemd配置

通过Systemd管理容器服务：

bash
sudo cp sysv/systemd/docker.freeswitch.service /lib/systemd/system/
sudo systemctl daemon-reload
sudo cp sysv/docker.freeswitch.py /usr/local/bin/
# 启用服务
sudo systemctl enable docker.freeswitch
# 启动服务
sudo systemctl start docker.freeswitch
# 停止服务
sudo systemctl stop docker.freeswitch

关键配置项

• 在autoload_configs/switch.conf.xml中设置rtp-start-port和rtp-end-port。
• 对每个可公开访问的配置文件设置ext-rtp-ip和ext-sip-ip。

Shell访问

bash
sudo docker exec -it freeswitch /bin/bash