Administrator
发布于 2026-11-20 / 2 阅读
0
0

FreeSWITCH 离线镜像更新:内置呼叫控制与 AI 实时推流,开箱即用

封面

我的 FreeSWITCH 1.10.12 离线 Docker 部署镜像已在 GitHub 更新 Release,内置的 AI 实时推流模块 mod_taering_stream 同步升级至 0.55,进一步增强了模块运行稳定性。老客户可直接拉取新离线包无损升级(原有配置、数据库与录音不会丢失);还没用过这套镜像的同行,也可以借这篇盘点看看镜像里都预装了哪些模块,以及内置的两个自研模块能帮你省掉多少造轮子的时间。


一、先给老客户报个信:镜像已更新至 GitHub

正在使用我这套 FreeSWITCH Docker 镜像的客户和同行,现在可以直接去 GitHub Releases 下载最新离线包升级了(仓库已清理旧版构建,目前仅保留最新可用版本,直接下载即可):

  • 镜像仓库地址:https://github.com/Taering365/freeswitch-docker
  • 最新 Release 标签:v1.10.12-fcc1.2.1
  • 离线交付包文件名:freeswitch-1.10.12-fcc1.2.1-taering0.55-offline-bundle.tar.gz

本次更新主要包含以下两方面改进,建议生产环境的老客户在维护窗口更新:

  1. 推流模块稳定性提升:将镜像内置的 AI 实时双向音频流模块 mod_taering_stream 升级至 0.55(含最新修正版),进一步增加了模块的运行稳定性;底座依然锁定经过生产验证的 FreeSWITCH 1.10.12-release 与 FCC 呼叫控制模块 mod_fcc 1.2.1-open。
  2. 启动脚本与宿主机配置保护机制升级:
    • 停止后再次启动:在原部署目录执行 ./start.sh,当镜像和 Compose 配置相同时,脚本会直接启动已有容器,完整保留宿主机的 XML 配置(包括 Event Socket 的监听地址和手工调整的模块加载列表);
    • 首次初始化中断续发:若首次初始化意外中断,在同一目录再次执行 ./start.sh,入口脚本会从暂存目录继续发布默认配置(请保留初始化过程中生成的隐藏目录 conf/.freeswitch-init-v1/);
    • 旧版留下的残缺配置保护:如果启动日志提示配置目录已有文件但缺少 freeswitch.xml,请先核对 Compose 挂载的宿主机目录;确认路径正确时,从该部署的备份恢复缺失文件,再执行 ./start.sh。

老客户最关心的一件事:升级会不会冲掉我已经调好的网关、拨号计划和录音?

放心,不会。 这套镜像把配置与数据做了严格的宿主机持久化隔离——首次切换新镜像仅重建运行容器,原有的 conf/、.env、compose.yaml 以及 Docker Volume 里的数据库、日志和录音文件都会完整沿用(具体的升级命令放在文末第五节)。


二、为什么要维护这样一套“纯离线”镜像?

最近也有不少新加过来的朋友问:“我自己装个 FreeSWITCH 或者拉个开源镜像不行吗?你这个包有什么不一样?”

在项目一线踩过 FreeSWITCH 编译坑的同行都深有体会:新开一台生产服务器,从零拉源码、配软件源、装几十个开发依赖库,往往大半天就耗进去了——国内服务器拉海外源超时、Debian 与 CentOS 不同发行版依赖库版本打架、编完才发现漏了 mod_shout(播不了 MP3)或者少了 MySQL/ODBC 驱动,推倒重编更是家常便饭。

维护 freeswitch-docker 的初衷非常纯粹:把编译好的生产级 FreeSWITCH 连同呼叫中心高频模块、数据库驱动和高清语音包,一次性打进单个离线压缩包里。

它的工程特点可以用四点概括:

  1. 彻底免编译、零外网镜像依赖:目标服务器不需要安装 GCC、CMake、Git 或任何 FreeSWITCH 开发库,甚至不需要访问 Docker Hub,内网隔离机房也能传包即用;
  2. 跨主流 Linux 发行版即插即用:支持 Debian、Ubuntu、CentOS Stream、Rocky Linux、AlmaLinux、RHEL 等任意主流 x86_64 原生 Linux 服务器,一行 ./start.sh 自动完成 docker load、版本校验、释放完整默认 XML 配置并拉起服务;
  3. 针对实时语音调优的容器参数:默认采用 network_mode: host 直通宿主机网络(省去大范围 RTP UDP 端口映射的性能损耗与 NAT 麻烦),并预配 SYS_NICE 与 rtprio 实时线程调度优先级,降低高并发下的音频抖动;
  4. 配置可写、数据防丢:首次启动自动把完整版本匹配的默认配置释放到宿主机 ./conf,改完直接 reloadxml;数据库、日志、录音各自使用独立命名卷(Named Volume)持久化,哪怕删除重建容器也不会丢数据。

三、盘点一下:镜像里都预装了哪些模块?

为了让传统呼叫中心和 AI 智能语音项目都能“拎包入住”,镜像把日常生产中最核心的模块一次配齐了:

FreeSWITCH 1.10.12 离线镜像内置模块全景

下面按职责给大家列一张明细清单:

模块分类内置模块 / 组件核心用途说明
核心底座与信令FreeSWITCH 1.10.12-release
mod_sofia
mod_event_socket
稳定生产基线版本;完整 SIP 协议栈(内外网 Profile、网关对接);标准 ESL 事件套接字(默认仅监听 127.0.0.1:8021 保安全)
呼叫中心与调度mod_callcenter
mod_fifo
mod_conference
mod_distributor
mod_limit
技能组队列与坐席分配、先进先出呼叫排队、多方电话会议、多线路网关按权重轮询分发、并发路数与呼叫速率(CPS)限制
数据库与缓存MariaDB / MySQL
PostgreSQL / SQLite
ODBC / Redis
常见关系型数据库驱动与高速缓存支持一步到位,无需再为接外部业务库折腾驱动编译
媒体与音质资源mod_shout
CD 音质语音包 & MOH
原生支持 MP3 文件播放及 Icecast/SHOUTcast 流媒体;内置高清提示音与排队等待音乐(MOH)
自研扩展 ①(开源)mod_fcc (1.2.1-open)面向业务开发者的呼叫控制模块,用 HTTP REST + WebSocket 封装常用话务控制与坐席管理
自研扩展 ②(商用)mod_taering_stream (0.55)专为 AI 语音打造的实时双向 PCM 推流与注入模块,原生支持用户插话打断与进度回报(含 1 路免费试用)

如果你的业务只跑传统呼叫中心,上面前四类标准模块已经足够支撑外呼、入呼排队、录音和网关分发;而如果你正在做 业务系统快速集成 或 AI 电话机器人 / 智能客服 / 实时质检,镜像内置的两个自研模块就是专门为你准备的提效利器。


四、重点聊聊镜像内置的两个自研模块

为什么要在标准 FreeSWITCH 之上单独写这两个模块?因为很多团队在落地 AI 呼叫系统时,最容易卡在两件事上:一是业务研发搞不定 ESL 信令状态机,二是媒体研发搞不定低延迟双向音频流与打断。

这两个模块刚好一人管一半——mod_fcc 管信令控制,mod_taering_stream 管实时媒体进出:

FCC 与 Taering Stream 双模块协同架构

1. mod_fcc:不用啃 ESL,也能快速写好呼叫中心(MIT 开源)

  • 开源仓库:https://github.com/Taering365/mod_fcc

做过通信开发的同行都知道,FreeSWITCH 原生的 ESL(Event Socket)非常强大,但对写 Java、Python、Go 的业务工程师并不友好:要自己维护 TCP 长连接、解析文本事件头、拼装 bgapi originate 字符串,还要处理各种异步 uuid_* 指令与多腿事件关联。

mod_fcc(FreeSWITCH Call Control)把这些高频呼叫控制能力直接封装成了业务研发最顺手的 HTTP REST + WebSocket 接口(原生 C 模块实现,内置轻量 WebSocket 服务端,无额外第三方库依赖):

  • 外呼与入呼全覆盖:调一个 JSON 接口即可发起外呼(支持走拨号计划或直指 Sofia 网关);入呼只需在拨号计划里配一行 fcc_inbound,业务后端就能在限定时间内动态决定应答、拒接还是转接;
  • 完整话务动作:应答、预应答、挂机、保持/取消保持(自动处理桥接对端音乐恢复)、发 DTMF、播音、转接、桥接一应俱全;
  • 单 WebSocket 订阅多路并发 + 断线续传:不必为每通电话开连接或轮询,一条 WebSocket 实时接收所有通话状态流转(dialing → ringing → answered → hangup),每个事件带全局递增 sequence,网络闪断重连后可自动重放最近多达 4096 条事件;
  • 内置坐席与运维能力:可直接管理 mod_callcenter 的 callback 坐席(创建、签入、签出、示忙、恢复、查队列),自带 Bearer Token 鉴权、IP 防暴破以及 /metrics Prometheus 监控指标。

💡 客观说明:mod_fcc 采用 MIT 协议完全开源。它并非为了取代 ESL,而是帮不熟悉 FreeSWITCH 底层的团队用最短路径把业务跑通;等业务规模扩大需要极致定制时,你依然可以随时结合原生 ESL 深入控制。

2. mod_taering_stream:让 FreeSWITCH 丝滑接上流式大模型(本次更新主角)

  • 项目主页与完整集成手册:https://github.com/Taering365/freeswitch_stream_mod

做 AI 外呼、语音客服机器人时,接通阿里云、腾讯云、讯飞、火山引擎、豆包、通义、DeepSeek 或自建 FunASR/CosyVoice 往往只要一两天,真正让人掉头发的是 FreeSWITCH 这一层的实时声音收发:

  • 用传统的“录文件 + playback”?延迟动辄两三秒,客户说话时机器人根本停不下来;
  • 找社区开源推流模块改?很多方案只解决了“上行推流给 ASR”,下行回注还得走 base64 或落盘文件,一旦碰上流式 TTS 注入、插话打断统计已播字数、loopback 呼叫方向反了、高并发环形缓冲丢帧等问题,到处都是深坑。

mod_taering_stream 就是专门把这一层打磨成了独立、低延迟、可商用的原生模块(最新 0.55 版已内置于本次镜像):

  • 20ms 低延迟全双工裸 PCM 流:上行通话音频通过 ws:// 或 wss:// 实时推送给你的媒体后端;后端流式 TTS 合成的裸 PCM16LE 二进制帧直接注入通话媒体流,不落盘、不走 playback,首包一到立刻出声;
  • 原生插话打断(Barge-in)+ 已播进度回报:当你的后端检测到客户插话,调用 interrupt_playback 或发一条 WebSocket clear 指令,模块瞬间清空播放队列,并精准回报实际已播放的毫秒数与采样数——方便业务端只把“AI 真正说出口的那半句话”写进大模型上下文,不乱套;
  • 三种声道模式适配不同场景:支持 mono(单声道喂实时 ASR)、mixed(双方混音归档)、stereo(左声道读、右声道写,天然适合实时语音质检与坐席辅助的说话人分离);
  • 五种控制方式,和 mod_fcc 天然绝配:除了 Dialplan、CLI、ESL taering_stream_json、同进程 C API 外,还自带 HTTP REST 控制接口(Bearer Token 鉴权),支持 request_id 启动幂等,并能通过 external_id 直接绑定 mod_fcc 的业务 call_id;
  • 省心的工程细节:自动识别 loopback_leg=A 并修正采集/注入方向;内置断线指数退避重连、多后端地址轮询分流、taering_stream stats 实时丢帧与缓冲水位观测。

关于免费试用与商业授权:
镜像预装的 mod_taering_stream 在未授权状态下默认提供 1 路完整并发免费试用——没有任何功能阉割,拉起镜像就能直接对接你的 ASR + LLM + TTS 把全流程联调跑通。等验证满意准备上并发生产时,再联系开通商业授权即可(授权后不限并发路数,上限仅取决于你的服务器硬件与网络性能;采用在线授权 + 本地签名缓存机制,外网短暂波动不影响通话业务)。


五、老客户无损升级与新用户快速上手

1. 老客户(含已有 0.55 部署)如何安全更新镜像?

请在业务维护窗口操作,首次切换镜像会重建容器。先备份现有配置,将新版离线包解压到单独目录(下面示例假设新版已解压到 /tmp/freeswitch-1.10.12-fcc1.2.1-taering0.55),然后在原部署目录执行以下命令,沿用原有的 conf/、.env、compose.yaml 和数据卷:

# 1. 进入原部署目录,先备份现有配置
cd /opt/你的原部署目录
cp -a ./conf "/opt/freeswitch-conf-backup-$(date +%F)"

# 2. 将新版离线包解压到单独的临时目录(示例路径如下)
mkdir -p /tmp/freeswitch-1.10.12-fcc1.2.1-taering0.55
tar -xzf /path/to/freeswitch-1.10.12-fcc1.2.1-taering0.55-offline-bundle.tar.gz \
  -C /tmp/freeswitch-1.10.12-fcc1.2.1-taering0.55 --strip-components=1

# 3. 回到原部署目录,更新镜像包与启动脚本并执行升级(沿用原有 conf/、.env、compose.yaml 与数据卷)
cd /opt/你的原部署目录
cp -f /tmp/freeswitch-1.10.12-fcc1.2.1-taering0.55/image/*.tar ./image/
cp -f /tmp/freeswitch-1.10.12-fcc1.2.1-taering0.55/start.sh ./start.sh
chmod +x ./start.sh
./start.sh

# 4. 验证服务健康度与模块状态
docker compose ps
docker compose exec -T freeswitch fs_cli -x status
docker compose exec -T freeswitch fs_cli -x 'module_exists mod_fcc'
docker compose exec -T freeswitch fs_cli -x 'module_exists mod_taering_stream'
docker compose exec -T freeswitch fs_cli -x 'taering_stream stats'

📌 运维避坑贴士:

  • 日常重启:停止后再次启动只需在原部署目录执行 ./start.sh,镜像与 Compose 配置不变时会直接启动已有容器,保留你手工改过的 Event Socket 监听地址与模块加载列表;
  • 初始化与配置校验:若首次初始化中断,保留隐藏目录 conf/.freeswitch-init-v1/ 并重跑 ./start.sh 即可继续发布默认配置;若提示配置目录非空但缺少 freeswitch.xml,核对挂载路径后从备份恢复再启动;
  • 保护数据卷:切记不要在生产环境执行 docker compose down -v,以免误删数据库与录音卷。

2. 新朋友 3 分钟开箱体验

准备一台装好 Docker Engine 与 Docker Compose V2 的 x86_64 Linux 服务器,从 GitHub Releases 下载离线包后只需三行命令:

tar -xzf freeswitch-1.10.12-fcc1.2.1-taering0.55-offline-bundle.tar.gz
cd freeswitch-1.10.12-fcc1.2.1
sudo ./start.sh

首次启动完成后,记得在正式对外服务前修改 ./conf/vars.xml 默认密码、Event Socket 密码以及 ./conf/autoload_configs/mod_fcc.conf.xml 中的默认 api_token,切勿将 8021 端口或未改密码的测试分机直接暴露在公网。


六、开源地址与技术交流

文中涉及的三个仓库文档与完整 API 手册均已在 GitHub 公开(微信公众号正文不支持外链跳转,大家可直接复制下方地址到浏览器打开,顺手点个 Star 不迷路):

  • FreeSWITCH 离线 Docker 镜像:https://github.com/Taering365/freeswitch-docker
  • FCC 开源呼叫控制模块:https://github.com/Taering365/mod_fcc
  • Taering Stream AI 实时推流模块:https://github.com/Taering365/freeswitch_stream_mod

如果你在镜像升级、mod_fcc 接入,或者 mod_taering_stream 商业授权、高并发压测与定制编译上有任何需求,欢迎随时联系我交流:

  • 公众号直接沟通:在本文下方留言,或直接在公众号后台发私信
  • 联系邮箱:taering@vip.qq.com / taering4417@gmail.com
  • 个人主页:https://www.liaoxinghui.com

联系商业授权或架构咨询时,建议顺带说明你的操作系统版本、FreeSWITCH 版本、预计并发路数以及业务场景(AI 外呼 / 智能客服 / 实时质检等),方便第一时间给你最匹配的部署建议。

合规提示:开展外呼业务请务必使用合规线路与号码资源,严格遵守国家关于呼叫时段、频次限制及客户拒接意愿的管理规定,做好通话录音与个人信息的加密存储与合规保护。


评论