
我的 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
本次更新主要包含以下两方面改进,建议生产环境的老客户在维护窗口更新:
- 推流模块稳定性提升:将镜像内置的 AI 实时双向音频流模块
mod_taering_stream升级至0.55(含最新修正版),进一步增加了模块的运行稳定性;底座依然锁定经过生产验证的 FreeSWITCH1.10.12-release与 FCC 呼叫控制模块mod_fcc 1.2.1-open。 - 启动脚本与宿主机配置保护机制升级:
- 停止后再次启动:在原部署目录执行
./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 连同呼叫中心高频模块、数据库驱动和高清语音包,一次性打进单个离线压缩包里。
它的工程特点可以用四点概括:
- 彻底免编译、零外网镜像依赖:目标服务器不需要安装 GCC、CMake、Git 或任何 FreeSWITCH 开发库,甚至不需要访问 Docker Hub,内网隔离机房也能传包即用;
- 跨主流 Linux 发行版即插即用:支持 Debian、Ubuntu、CentOS Stream、Rocky Linux、AlmaLinux、RHEL 等任意主流
x86_64原生 Linux 服务器,一行./start.sh自动完成docker load、版本校验、释放完整默认 XML 配置并拉起服务; - 针对实时语音调优的容器参数:默认采用
network_mode: host直通宿主机网络(省去大范围 RTP UDP 端口映射的性能损耗与 NAT 麻烦),并预配SYS_NICE与rtprio实时线程调度优先级,降低高并发下的音频抖动; - 配置可写、数据防丢:首次启动自动把完整版本匹配的默认配置释放到宿主机
./conf,改完直接reloadxml;数据库、日志、录音各自使用独立命名卷(Named Volume)持久化,哪怕删除重建容器也不会丢数据。
三、盘点一下:镜像里都预装了哪些模块?
为了让传统呼叫中心和 AI 智能语音项目都能“拎包入住”,镜像把日常生产中最核心的模块一次配齐了:

下面按职责给大家列一张明细清单:
| 模块分类 | 内置模块 / 组件 | 核心用途说明 |
|---|---|---|
| 核心底座与信令 | FreeSWITCH 1.10.12-releasemod_sofiamod_event_socket | 稳定生产基线版本;完整 SIP 协议栈(内外网 Profile、网关对接);标准 ESL 事件套接字(默认仅监听 127.0.0.1:8021 保安全) |
| 呼叫中心与调度 | mod_callcentermod_fifomod_conferencemod_distributormod_limit | 技能组队列与坐席分配、先进先出呼叫排队、多方电话会议、多线路网关按权重轮询分发、并发路数与呼叫速率(CPS)限制 |
| 数据库与缓存 | MariaDB / MySQL PostgreSQL / SQLite ODBC / Redis | 常见关系型数据库驱动与高速缓存支持一步到位,无需再为接外部业务库折腾驱动编译 |
| 媒体与音质资源 | mod_shoutCD 音质语音包 & 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 管实时媒体进出:

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 防暴破以及/metricsPrometheus 监控指标。
💡 客观说明:
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或发一条 WebSocketclear指令,模块瞬间清空播放队列,并精准回报实际已播放的毫秒数与采样数——方便业务端只把“AI 真正说出口的那半句话”写进大模型上下文,不乱套; - 三种声道模式适配不同场景:支持
mono(单声道喂实时 ASR)、mixed(双方混音归档)、stereo(左声道读、右声道写,天然适合实时语音质检与坐席辅助的说话人分离); - 五种控制方式,和
mod_fcc天然绝配:除了 Dialplan、CLI、ESLtaering_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 外呼 / 智能客服 / 实时质检等),方便第一时间给你最匹配的部署建议。
合规提示:开展外呼业务请务必使用合规线路与号码资源,严格遵守国家关于呼叫时段、频次限制及客户拒接意愿的管理规定,做好通话录音与个人信息的加密存储与合规保护。