Freeswitch Mrcp

mod_unimrcp 编译安装

前置条件

在安装 mod_unimrcp 之前，请先完成 FreeSWITCH 的安装，详见 Freeswitch 安装指南。

环境要求

• Linux 64位系统（Ubuntu/Debian/CentOS）
• GCC 8.2 或更高版本
• 已安装 FreeSWITCH（参考 Freeswitch 安装指南）
• 4核8G内存（推荐配置，支持约20并发）

编译步骤

1. 编译 UniMRCP 依赖（APR、APR-Utils）

# 下载 UniMRCP 依赖包
wget https://www.unimrcp.org/project/component-view/unimrcp-deps-1-6-0-tar-gz/download -O unimrcp-deps-1.6.0.tar.gz
tar xvzf unimrcp-deps-1.6.0.tar.gz
cd unimrcp-deps-1.6.0

# 编译 APR
cd libs/apr
./configure --prefix=/usr/local/apr
make
sudo make install
cd ..

# 编译 APR-Util
cd apr-util
./configure --prefix=/usr/local/apr --with-apr=/usr/local/apr
make
sudo make install
cd ../..

2. 编译 UniMRCP

# 克隆 UniMRCP 源码
git clone https://github.com/unispeech/unimrcp.git
cd unimrcp

# 编译安装
./bootstrap
./configure
make
sudo make install
cd ..

3. 编译并安装 mod_unimrcp

# 克隆 mod_unimrcp 源码
git clone https://github.com/freeswitch/mod_unimrcp.git
cd mod_unimrcp

# 设置 PKG_CONFIG_PATH 环境变量
export PKG_CONFIG_PATH=/usr/local/freeswitch/lib/pkgconfig:/usr/local/unimrcp/lib/pkgconfig

# 编译安装
./bootstrap.sh
./configure
make
sudo make install

4. 启用模块

编辑 FreeSWITCH 模块配置文件：

vim /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml

在 <modules> 节点中添加：

<load module="mod_unimrcp"/>

5. 验证安装

# 检查模块文件是否存在
ls -l /usr/local/freeswitch/mod/mod_unimrcp.so

# 重启 FreeSWITCH
freeswitch -stop
freeswitch -nc

# 连接到 FreeSWITCH CLI 并验证模块加载
fs_cli
# 在 CLI 中执行：
show modules | grep unimrcp
# 应该看到 mod_unimrcp 已加载

常见问题

1. 编译错误：找不到 FreeSWITCH 头文件

   • 确保 FreeSWITCH 已正确安装
   • 检查 PKG_CONFIG_PATH 环境变量设置是否正确

2. 编译错误：找不到 UniMRCP 库

   • 确认 UniMRCP 已成功编译安装
   • 检查 /usr/local/unimrcp 目录是否存在
   • 运行 sudo ldconfig 更新系统库缓存

3. 模块加载失败

   • 检查 FreeSWITCH 日志：tail -f /usr/local/freeswitch/log/freeswitch.log
   • 确认模块文件权限正确
   • 验证依赖库是否完整

4. 权限问题

   • 某些操作需要 sudo 权限
   • 确保有足够的权限访问安装目录

对接

百度云MRCP

• 请参考百度呼叫中心语音MRCP用户指南

概述

百度云 MRCP Server 集成了呼叫中心 8K 采样率语音识别（ASR）和语音合成（TTS）能力，支持单独或同时使用。

前置准备

1. 获取百度 AI 凭证

   • 访问百度 AI 开放平台
   • 创建应用，获取 AppID、API Key、Secret Key

2. 下载 MRCP Server

   方式一：浏览器下载

   • 访问呼叫中心语音解决方案 MrcpServer 下载页面
   • 下载后上传到服务器

   方式二：服务器命令下载（推荐）

   # 创建下载目录
   mkdir -p ~/baidu-mrcp && cd ~/baidu-mrcp
   
   # 使用 wget 下载（如果下载链接有效）
   # 注意：百度可能需要登录才能下载，如果以下命令失败，请使用方式一
   wget -O baidu-mrcp-server.tar.gz "https://www.weiyuai.cn/download/mrcp_server_baidu.tar.gz"
   
   # 或使用 curl 下载
   curl -L -o baidu-mrcp-server.tar.gz "https://www.weiyuai.cn/download/mrcp_server_baidu.tar.gz"
   
   # 解压文件
   tar -xzf baidu-mrcp-server.tar.gz
   
   # 查看解压后的目录结构
   ls -la

   提示：

   • 由于百度 AI 平台的下载可能需要登录认证，直接使用 wget/curl 可能无法下载
   • 如果命令下载失败，建议使用浏览器下载后，通过 scp 或 sftp 上传到服务器
   • 上传命令示例：scp baidu-mrcp-server.tar.gz user@server:/path/to/destination/

3. 环境要求

   • Linux 64位（CentOS 6u3、CentOS 7+ 或 Ubuntu）
   • GCC 8.2 或以上版本
   • 4核8G内存（支持约20并发）

音频格式要求

参数	要求
编码格式	PCMU、PCMA、L16
采样率	8KHz
采样精度	16bits
声道	单声道

配置步骤

1. 初始化环境

# 解压下载的 MRCP Server 包
cd ${SERVER_ROOT}/
sudo ./bootstrap.sh  # 配置 gcc8.2 环境（仅首次需要）

2. 配置 IP 地址

编辑主配置文件 ${SERVER_ROOT}/mrcp-server/conf/unimrcpserver.xml：

<!-- 方式1：自动获取（推荐） -->
<ip type="auto">auto</ip>

<!-- 方式2：指定网卡 -->
<ip type="iface">eth0</ip>

<!-- 方式3：手动指定IP -->
<ip>10.10.0.1</ip>

3. 配置鉴权信息

语音识别配置（conf/mrcp-asr.conf）：

# 修改以下配置项
AUTH_APPID=your_app_id          # 百度 AppID
AUTH_APPKEY=your_api_key        # 百度 API Key
NEED_SAVE_AUDIO=1               # 是否保存识别音频（1-保存，0-不保存）

语音合成配置（conf/mrcp-proxy.conf）：

# 修改以下配置项
AUTH_APPID=your_app_id          # 百度 AppID
AUTH_APPKEY=your_api_key        # 百度 API Key

4. 配置启动监测

编辑 ${SERVER_ROOT}/mrcp-server/conf/unimrcpserver_control.conf：

# 如果使用 auto 方式配置 IP，保持默认
_check_cmd_pro="./bin/check 127.0.0.1 1544"

# 如果手动指定 IP，修改为对应 IP
_check_cmd_pro="./bin/check 10.10.0.1 1544"

5. 防火墙配置

确保以下端口开放：

• 5060：SIP 信令端口
• 1544：MRCP 控制端口
• 1554：RTP 媒体端口

# CentOS/RHEL 防火墙配置示例
sudo firewall-cmd --permanent --add-port=5060/tcp
sudo firewall-cmd --permanent --add-port=1544/tcp
sudo firewall-cmd --permanent --add-port=1554/tcp
sudo firewall-cmd --reload

启动服务

调试模式（推荐测试时使用）

cd ${SERVER_ROOT}/mrcp-server/
./bin/unimrcpserver -r . &

# 验证服务是否启动
netstat -nlp | grep unimrcp
# 应该看到 5060、1544、1554 端口正在监听

生产模式（守护进程）

cd ${SERVER_ROOT}/mrcp-server/

# 启动服务
./bin/unimrcpserver_control start

# 停止服务
./bin/unimrcpserver_control stop

# 重启服务
./bin/unimrcpserver_control restart

# 查看进程状态
ps aux | grep mrcp

测试验证

1. 配置测试工具

编辑 conf/client-profiles/unimrcp.xml，修改服务器 IP：

<sip-settings>
    <server-ip>your_server_ip</server-ip>  <!-- 修改为实际服务器IP -->
    <server-port>5060</server-port>
</sip-settings>

2. 测试语音识别

# 设置环境变量
export LD_LIBRARY_PATH=${SERVER_ROOT}/mrcp-server/lib:$LD_LIBRARY_PATH

# 进入测试目录
cd ${SERVER_ROOT}/mrcp-server/bin

# 运行识别测试
./asrclient
# 在交互界面输入命令：
run grammar.xml xeq.pcm
# 查看识别结果后输入 quit 退出

3. 查看日志

# 查看识别日志
tail -f ${SERVER_ROOT}/mrcp-server/log/mrcp_debug.log

# 查看系统日志
tail -f ${SERVER_ROOT}/mrcp-server/log/comlog.log

集成 FreeSWITCH

1. 配置 FreeSWITCH MRCP Profile

创建或编辑 /usr/local/freeswitch/conf/mrcp_profiles/baidu.xml：

<profile name="baidu" version="2">
  <param name="server-ip" value="百度MRCP服务器IP"/>
  <param name="server-port" value="5060"/>
  <param name="resource-location" value=""/>
  <param name="sip-transport" value="udp"/>
  
  <!-- 语音识别配置 -->
  <synthparams>
  </synthparams>
  
  <!-- 语音合成配置 -->
  <recogparams>
    <param name="start-input-timers" value="false"/>
  </recogparams>
</profile>

2. 在 Dialplan 中使用

<extension name="baidu_asr_test">
  <condition field="destination_number" expression="^9001$">
    <!-- 播放提示音 -->
    <action application="answer"/>
    <action application="sleep" data="1000"/>
    <action application="speak" data="请说话"/>
    
    <!-- 调用语音识别 -->
    <action application="play_and_detect_speech" 
            data="silence_stream://2000 mrcp:baidu {start-input-timers=false}builtin:grammar/boolean grammar.xml"/>
    
    <!-- 获取识别结果 -->
    <action application="log" data="INFO 识别结果: ${detect_speech_result}"/>
  </condition>
</extension>

识别结果格式

默认返回 XML 格式：

<?xml version="1.0" encoding="UTF-8" ?>
<result>
    <asr confidence="100">今天天气怎么样</asr>
    <ext>
        <logid>6a373e36722811e9_2_1</logid>
    </ext>
</result>

可在 conf/mrcp-asr.conf 中通过 XML_ASR_RESULT_TEMPLATE 自定义返回格式。

高级功能

1. 自训练模型

对于专业术语、人名等特殊词汇，可使用百度语音自训练平台训练专属模型。

训练完成后，在 MRCP 请求的 vendor_specific_params 参数中添加模型 ID：

lmid=your_model_id

2. 单字过滤

避免因噪声误识别单字（如"嗯"、"啊"），可配置白名单：

在 conf/mrcp-asr.conf 中：

DETECT_START_OF_INPUT_BY_VAD=0
SINGLE_WORD_WHTIL_LIST=/path/to/whitelist.txt

常见问题faq

1. 服务启动失败

   • 检查端口是否被占用：netstat -nlp | grep -E '5060|1544|1554'
   • 查看日志文件排查具体错误

2. 识别无结果

   • 确认 AppID 和 API Key 配置正确
   • 检查音频格式是否符合要求（8K、16bit、单声道）
   • 查看 log/mrcp_debug.log 日志

3. 频繁掉线

   • 检查网络连接稳定性
   • 确认并发数未超过服务器承载能力

4. 识别率低

   • 确保音频清晰，无明显噪音
   • 考虑使用自训练模型优化特定词汇识别

Docker 镜像部署

Bytedesk 已将百度 MRCP Server 打包为 Docker 镜像，开箱即用，省去手动编译 GCC 8.2 和配置依赖的繁琐步骤。

镜像仓库地址：

• 阿里云（国内推荐）：registry.cn-hangzhou.aliyuncs.com/bytedesk/mrcp
• Docker Hub：bytedesk/mrcp

平台支持

镜像仅支持 linux/amd64 架构。在 Apple Silicon (ARM64) 机器上构建时需设置 DOCKER_DEFAULT_PLATFORM=linux/amd64。

快速启动（从镜像仓库拉取）

1. 准备配置文件

镜像内置了默认配置，如需自定义，先创建外部配置目录：

mkdir -p conf docker/log docker/audio
cp mrcp-server/conf/unimrcpserver.xml conf/
cp mrcp-server/conf/mrcp-asr.conf conf/

编辑 conf/unimrcpserver.xml 修改 IP 地址，编辑 conf/mrcp-asr.conf 修改鉴权信息：

# conf/mrcp-asr.conf 中修改
AUTH_APPID=your_app_id          # 百度 AppID
AUTH_APPKEY=your_api_key        # 百度 API Key

⚠️ 重要：如果使用外部 conf 目录挂载，必须包含完整的配置文件（至少 unimrcpserver.xml、mrcp-asr.conf、dirlayout.xml），否则容器将因缺少配置而启动失败。

1. 编写 docker-compose.yaml

services:
  mrcp-server:
    image: registry.cn-hangzhou.aliyuncs.com/bytedesk/mrcp:latest
    pull_policy: always
    container_name: mrcp-server
    ports:
      - "1544:1544"         # MRCP 控制端口
      - "1554:1554"         # RTSP 端口
      - "5060:5060/udp"     # SIP 信令 (UDP)
      - "5060:5060/tcp"     # SIP 信令 (TCP)
      - "5000-6000:5000-6000/udp"  # RTP 媒体端口范围
    volumes:
      - ./mrcp-server/conf:/opt/mrcp-server/conf:ro
      - ./docker/log:/opt/mrcp-server/log
      - ./docker/audio:/opt/mrcp-server/audio
 restart: unless-stopped

1. 拉取并启动

docker compose up -d

1. 查看日志

docker compose logs -f mrcp-server

1. 停止服务

docker compose down

环境变量

变量	默认值	说明
MRCP_IMAGE	registry.cn-hangzhou.aliyuncs.com/bytedesk/mrcp	镜像地址
MRCP_TAG	latest	镜像标签
MRCP_CONTAINER_NAME	mrcp-server	容器名
MRCP_PORT	1544	MRCP 端口
RTSP_PORT	1554	RTSP 端口
SIP_PORT	5060	SIP 端口
RTP_PORT_RANGE	5000-6000	RTP 端口范围
MRCP_CONF_DIR	./mrcp-server/conf	配置文件目录
MRCP_LOG_DIR	./docker/log	日志目录
MRCP_AUDIO_DIR	./docker/audio	音频目录

使用 Docker Hub 镜像：

MRCP_IMAGE=bytedesk/mrcp docker compose up -d

本地构建镜像

如需修改源码或插件后自行构建：

# 拉取 Git LFS 大文件
git lfs pull

# 构建镜像（Apple Silicon 需指定平台）
DOCKER_DEFAULT_PLATFORM=linux/amd64 docker compose build

# 启动
docker compose up -d

端口说明

端口	协议	说明
1544	TCP	MRCP 控制端口
1554	TCP	RTSP 端口
5060	TCP/UDP	SIP 信令端口
5000-6000	UDP	RTP 媒体端口范围

注意：部署到云主机或容器平台时需同步放通以上端口段。

腾讯云MRCP

科大讯飞MRCP

阿里云MRCP

参考

• mod_unimrcp github
• mod_unimrcp freeswitch docs
• 百度呼叫中心语音MRCP用户指南
• FunASR
• MRCP在美团语音交互中的实践和应用
• 腾讯MRCP Server
• Bytedesk MRCP Docker 镜像