drachtio/drachtio-freeswitch-mrf

docker-drachtio-freeswitch-mrf 镜像文档

镜像概述

docker-drachtio-freeswitch-mrf是一个轻量级Freeswitch 1.8镜像（约127 MB），基于https://hub.docker.com/r/drachtio/drachtio-freeswitch-base/%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%93%E4%B8%BAhttp://davehorton.github.io/drachtio-fsmrf/%E6%A1%86%E6%9E%B6%E8%AE%BE%E8%AE%A1%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%9E%81%E5%85%B6%E7%B2%BE%E7%AE%80%EF%BC%8C%E4%BB%85%E6%94%AF%E6%8C%81%E6%8B%A8%E5%8F%B7%E8%AE%A1%E5%88%92%E5%92%8C%E4%BA%8B%E4%BB%B6%E5%A5%97%E6%8E%A5%E5%AD%97%EF%BC%88%E6%9C%AA%E7%BC%96%E8%AF%91Lua%E6%88%96JavaScript%E7%AD%89%E8%84%9A%E6%9C%AC%E8%AF%AD%E8%A8%80%EF%BC%89%EF%BC%8C%E4%B8%8D%E5%8C%85%E5%90%AB%E5%A3%B0%E9%9F%B3%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B9%B6%E4%BB%85%E5%8A%A0%E8%BD%BD%E6%9C%80%E5%B0%8F%E5%8C%96%E7%9A%84%E6%A8%A1%E5%9D%97%E9%9B%86%E3%80%82

核心功能与特性

• 轻量级设计：镜像大小约127 MB，资源占用低
• 核心功能支持：仅包含拨号计划和事件套接字功能，无脚本语言支持
• 端口可配置：支持自定义SIP端口、TLS端口、事件套接字端口及RTP端口范围，便于在同一主机运行多个容器
• 卷支持：暴露声音文件、录音和日志卷，支持主机挂载
• 最小模块集：仅加载核心必要模块，减少资源占用

使用场景

• 主要用于drachtio-fsmrf框架环境
• 适合需要在同一主机部署多个Freeswitch容器的场景
• 适用于对资源占用敏感、仅需基础通话功能的环境

使用方法

基本运行

使用默认配置运行容器：

bash
docker run -d --rm --name FS1 docker.xuanyuan.run/drachtio/drachtio-freeswitch-mrf freeswitch

进入容器

进入Freeswitch控制台

bash
docker exec -ti FS1 fs_cli

进入容器Shell

bash
docker exec -ti FS1 bash

高级配置示例

自定义端口、挂载卷的完整示例：

bash
docker run -d --rm --name FS1 --net=host \
-v /home/deploy/log:/usr/local/freeswitch/log  \
-v /home/deploy/sounds:/usr/local/freeswitch/sounds \
-v /home/deploy/recordings:/usr/local/freeswitch/recordings \
docker.xuanyuan.run/drachtio/drachtio-freeswitch-mrf freeswitch --sip-port 5038 --tls-port 5039 --rtp-range-start 20000 --rtp-range-end 21000

卷说明

容器暴露以下卷，支持主机挂载：

• /usr/local/freeswitch/sounds：用于提供Freeswitch声音文件
• /usr/local/freeswitch/recordings：用于将录音保存到主机文件系统
• /usr/local/freeswitch/log：用于保存Freeswitch日志文件

配置参数

支持通过命令行参数配置Freeswitch端口及相关设置：

模块配置（modules.conf.xml）

以下是镜像中加载模块的配置文件内容，定义了加载的模块集：

xml
<configuration name="modules.conf" description="Modules">
  <modules>
    <!-- 日志模块（建议首先加载） -->
    <load module="mod_console"/>
    <load module="mod_logfile"/>

    <load module="mod_audio_fork"/>

    <!-- 事件处理模块 -->
    <load module="mod_cdr_csv"/>
    <load module="mod_event_socket"/>

    <!-- 端点模块 -->
    <load module="mod_sofia"/>

    <!-- 应用程序模块 -->
    <load module="mod_commands"/>
    <load module="mod_conference"/>
    <load module="mod_dptools"/>
    <load module="mod_httapi"/>

    <!-- 拨号计划接口 -->
    <load module="mod_dialplan_xml"/>

    <!-- 编解码器接口 -->
    <load module="mod_spandsp"/>
    <load module="mod_g723_1"/>
    <load module="mod_g729"/>
    <load module="mod_h26x"/>
    <load module="mod_opus"/>

    <!-- 文件格式接口 -->
    <load module="mod_sndfile"/>
    <load module="mod_native_file"/>
    <load module="mod_local_stream"/>
    <load module="mod_tone_stream"/>

    <!-- 语音合成模块 -->
    <load module="mod_say_en"/>

  </modules>
</configuration>

模块说明：

• 日志模块：加载控制台日志（mod_console）和文件日志（mod_logfile）
• 事件处理：加载CSV格式CDR（mod_cdr_csv）和事件套接字（mod_event_socket）
• 端点：加载SIP端点模块（mod_sofia）
• 应用程序：包含命令（mod_commands）、会议（mod_conference）、拨号工具（mod_dptools）等基础应用
• 拨号计划：使用XML拨号计划（mod_dialplan_xml）
• 编解码器：支持G.723.1、G.729、***等常用编解码器
• 文件格式：支持音频文件处理（mod_sndfile、mod_native_file）和本地流（mod_local_stream）
• 语音合成：仅加载英文语音合成模块（mod_say_en）