FreeSWITCH的安装与使用
FreeSWITCH
FreeSWITCH的是一个跨平台的开源电话交换平台
环境：
[root@cen ~]# cat /etc/redhat-release
CentOS Linux release 7.7.1908 (Core)
安装：
1.准备好FreeSWITCH安装包(我用的1.6版本)，
2.安装环境以及依赖
---------------------------------------------------------------------
[root@king src]# pwd
/usr/local/src
[root@king src]# ll
-rw-r--r-- 1 root root 59842116 Dec 12 09:48 freeswitch-1.6.zip
drwxr-xr-x 24 root root 20480 Dec 12 12:25 freeswitch-1.6
2.安装依赖环境：
yum install -y http://files.freeswitch.org/freeswitch-release-1-6.noarch.rpm epel-release
yum install -y git alsa-lib-devel autoconf automake bison broadvoice-devel bzip2 curl-devel libdb4-devel e2fsprogs-devel erlang flite-devel g722_1-devel gcc-c++ gdbm-devel gnutls-devel ilbc2-devel ldns-devel libcodec2-devel libcurl-devel libedit-devel libidn-devel libjpeg-devel libmemcached-devel libogg-devel libsilk-devel libsndfile-devel libtheora-devel libtiff-devel libtool libuuid-devel libvorbis-devel libxml2-devel lua-devel lzo-devel mongo-c-driver-devel ncurses-devel net-snmp-devel openssl-devel opus-devel pcre-devel perl perl-ExtUtils-Embed pkgconfig portaudio-devel postgresql-devel python-devel python-devel soundtouch-devel speex-devel sqlite-devel unbound-devel unixODBC-devel wget which yasm zlib-devel libshout-devel libmpg123-devel lame-devel
编译安装：
进入解压目录
执行bootstrap.sh
再继续执行编译安装
- ./configure（此过程出现众多未知错误，一般是依赖包没装，百度一堆）
- make(make时 出现错误我遇到的处理方法在下下下面)
- make install
安装结果部分截图：
至此，FreeSWITCH就已经安装完了。在CentOS系统上，其默认的安装位置是/usr/local/freeswitch。两个常用的命令是bin/freeswitch和bin/fs_cli，为了便于使用，建议将这两个命令做符号链接放到你的搜索路径中，如：
ln -sf /usr/local/freeswitch/bin/freeswitch /usr/bin/
ln -sf /usr/local/freeswitch/bin/fs_cli /usr/bin/
目录结构：
|
bin
|
可执行程序
|
|
certs
|
|
|
conf**
|
配置文件
|
|
db
|
系统sqlite数据库.将呼叫信息存放到数据库，在查询时无需对核心数据结构加锁
|
|
fonts
|
|
|
grammar
|
语法，适用于ASR
|
|
htdocs
|
HTTP Web Server根目录
|
|
images
|
|
|
include
|
头文件
|
|
lib
|
库文件
|
|
log
|
日志
|
|
mod
|
可加载模块目录
|
|
recordings
|
录音
|
|
run
|
pid
|
|
scripts
|
嵌入式语言写入的脚本，
|
|
sounds
|
声音文件
|
|
storage
|
语音留言的录音(Voicemail)
|
配置文件：
由许多xml组成，
|
文件夹
|
描述
|
|
autoload_configs
|
这些配置文件会在系统启动时自动加载到FreeSWITCH中，它们包含几乎所有核心模块的配置信息。文件一般以“模块”.conf.xml称
|
|
dialplan**
|
设置拨号计划的地方。包括一些有关如何配置拨号计划的示例。
|
|
directory**
|
该目录包含所有可能注册并将freeswitch用作其PBX的用户。默认有1000-1019 20个用户
|
|
jingle_profiles
|
Jingle是FS用于处理XMPP的mod。配置文件告诉FS如何使用该协议。每个配置文件都有其自己的IP端口。
|
|
lang
|
语言
|
|
mrcp_profiles
|
MRCP用于允许FreeSWITCH使用语音识别和TTS
|
|
sip_profiles
|
告诉FS如何交谈。每个配置文件都有其自己的端口。
|
|
ivr_menus
|
存放了一些默认的IVR
|
|
配置文件
|
描述
|
|
freeswitch.xml**
|
将所有的xml配置文件“粘”在一起
|
|
vars.xml
|
定义全局变量
|
more
安装声音文件
make cd-sounds-install
make cd-moh-install
FreeSWITCH 安装后，默认配置了20个用户(1000-1019)，密码 1234，同时包含了一个功能齐全的 IVR 示例，随便使用一个分机号登陆服务器，拨5000，就可以听到菜单提示了。
启动
# 可以看到详细启动日志,启动后进入控制台模式，退出使用shutdown
freeswitch -c -nonat -rp
# 默认后台运行
freeswitch -nc ***
# 生成环境后台运行
freeswitch -rp -nc -nonat
# 关闭
freeswitch -stop ***
#进入后台:
fs_cli(直接执行，如果你创建软链接，没有创建需要到bin目录找到fs_cli执行)
查看编码：
freeswitch@FreeSWITCH> show codec
type,name,ikey
codec,ADPCM (IMA),mod_spandsp
codec,AMR,mod_amr
codec,B64 (STANDARD),mod_b64
codec,G.722,mod_spandsp
codec,G.723.1 6.3k,mod_g723_1
codec,G.726 16k,mod_spandsp
codec,G.726 16k (AAL2),mod_spandsp
codec,G.726 24k,mod_spandsp
codec,G.726 24k (AAL2),mod_spandsp
codec,G.726 32k,mod_spandsp
codec,G.726 32k (AAL2),mod_spandsp
codec,G.726 40k,mod_spandsp
codec,G.726 40k (AAL2),mod_spandsp
codec,G.729,mod_g729
codec,GSM,mod_spandsp
codec,LPC-10,mod_spandsp
codec,OPUS (STANDARD),mod_opus 17 total.
freeswitch@FreeSWITCH>
查看系统的运行状态：
freeswitch@FreeSWITCH> status
UP 0 years, 0 days, 0 hours, 3 minutes, 21 seconds, 118 milliseconds, 975 microseconds
FreeSWITCH (Version 1.6.20 64bit) is ready
3 session(s) since startup
0 session(s) - peak 1, last 5min 1
0 session(s) per Sec out of max 30, peak 1, last 5min 1
1000 session(s) max
min idle cpu 0.00/97.47
Current Stack Size/Max 240K/8192K freeswitch@king>
查看注册：
freeswitch@FreeSWITCH> sofia status profile internal reg Registrations: Call-ID: 101919ZDFhZDNhNDZmMTUwZTc5NTUzNjM2ZWIxNjI3NWQ1NGQ
User: 1001@172.17.0.8
Contact: "1001" <sip:1001@60.177.98.xx:61514;rinstance=147853e260e28850>
Agent: X-Lite release 5.8.0 stamp 101919
Status: Registered(UDP)(unknown) EXP(2019-12-12 16:39:07) EXPSECS(3572)
Ping-Status: Reachable
Ping-Time: 0.00
Host: king
IP: 60.177.98.xx
Port: 61514
Auth-User: 1001
Auth-Realm: 172.17.0.8
MWI-Account: 1001@172.17.0.8 Total items returned: 1
# 查看用户是否注册
sofia status profile internal reg 1000
# 呼叫电话，接通后park
originate user/1000 &park
# 切断电话
fsctl hupall normal_clearing dialed_ext 1000
# 呼叫电话，接通后播放音乐
originate user/1000 &playback(/tmp/music.wav)
# 查看当前通话数
show calls
freeswitch@FreeSWITCH> show calls
uuid,direction,created,created_epoch,name,state,cid_name,cid_num,ip_addr,dest,presence_id,presence_data,accountcode,callstate,callee_name,callee_num,callee_direction,call_uuid,hostname,sent_callee_name,sent_callee_num,b_uuid,b_direction,b_created,b_created_epoch,b_name,b_state,b_cid_name,b_cid_num,b_ip_addr,b_dest,b_presence_id,b_presence_data,b_accountcode,b_callstate,b_callee_name,b_callee_num,b_callee_direction,b_sent_callee_name,b_sent_callee_num,call_created_epoch
313cad28-e1eb-4ea6-910a-90d112e19655,inbound,2019-12-12 15:45:32,1576136732,sofia/internal/1003@118.89.69.x:5060,CS_EXECUTE,1003,1003,60.177.xx.241,1001,1003@118.89.69.xx,,1003,ACTIVE,,,,313cad28-e1eb-4ea6-910a-90d112e19655,king,,,e9caa3c1-ba32-4d79-b1e1-4f62b2bc2e44,outbound,2019-12-12 15:45:42,1576136742,sofia/internal/1001@60.177.98.xxx:61514,CS_EXCHANGE_MEDIA,Extension 1003,1003,60.xxx.98.241,1001,1001@172.17.0.8,,,ACTIVE,Outbound Call,1001,,,,1576136747
1 total.
------------
# 查看当前通道数
show channels
配置Freeswitch新增用户
1.添加用户
默认用户在/usr/local/freeswitch/conf/directory/default/下
2.修改拨号计划（Dialplan）使其他用户可以呼叫它(默认只能打不能接)
/usr/local/freeswitch/conf/dialplan/ default.xml
<extension name="Local_Extension">
<condition field="destination_number" expression="^(10[01][0-9]|1020|1021)$">
3.在后台重新加载配置文件
freeswitch@FreeSWITCH> reloadxml
启动
# 可以查看到详细的日志信息
freeswitch -c -nonat -rp
# 默认后台运行
freeswitch -nc
# 生成环境后台运行
freeswitch -rp -nc -nonat
#####
软件电话
X-Lite
#####
Zoiper
模块的安装
源码目录下make mod_xxx-install命令，这样就编译相应模块，并把编译后的动态库安装的/usr/local/freeswitch/mod目录下了。
给1000打电话
originate user/1000 &echo
报错：
正常情况下，直接输入 bin/fs_cli 即可连接上，并出现系统提示符。如果出现：
[ERROR] libs/esl/fs_cli.c:652 main() Error Connecting [Socket Connection Error]
这样的错误，说明 FreeSWITCH 没有启动或 mod_event_socket 没有正确加载，请检查TCP端口8021端口是否处于监听状态或被其它进程占用。(重启报错消失)
fs_cli 连接不了本机的 freeswitch 检查配置文件下的 autoload_config/event_socket.conf.xml 中的 ip,密码等信息，以及查看默认 的 8021 端口是否启动 机 查看本机 freeswitch 的运行状态
=======================================================================================
错误合集
make时出现的错误： making all mod_signalwire make[4]: Entering directory /usr/local/src/freeswitch/src/mod/applications/mod_signalwire' Makefile:916: *** You must install libks to build mod_signalwire. Stop. make[4]: Leaving directory/usr/local/src/freeswitch/src/mod/applications/mod_signalwire' make[3]: *** [mod_signalwire-all] Error 1 根据报错可以看出需要安装需要安装 libks 和 signalwire-c，安装libks前需要先安装cmake。
安装cmake
yum remove cmake #卸载yum安装的版本，若无安装则忽略
cd /usr/local/src
tar vzxf cmake-3.14.0.tar.gz
cd cmake-3.14.0
./configure
make
make install
ln -s /usr/local/bin/cmake /usr/bin #软连接
安装libks
cd /usr/local/src
yum install libatomic
git clone https://github.com/signalwire/libks.git
cd libks
cmake .
make
make install
安装signalwire-c
cd /usr/local/src
cd signalwire-c/
cmake .
make
make install
ln -sf /usr/local/lib64/pkgconfig/signalwire_client.pc /usr/lib64/pkgconfig/signalwire_client.pc
最后再次安装FreeSWITCH
make && make install
-------------------------------------------------------------------
Freeswitch 的日志上就会出现相关的 debug，notice 等信息。 如遇到红色的报警，并提示要 sleep 10 秒的，则是由于我们使用了默认密码，可以修改 Conf/vars.xml 中的 <X-PRE-PROCESS cmd="set" data="default_password=1234"/> 或修改 conf/dialplan/default.xml 中 <condition field="${default_password}" expression="^1234$" break="never"> <action application="log" data="CRIT WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING "/> <action application="log" data="CRIT Open $${conf_dir}/vars.xml and change the default_password."/> <action application="log" data="CRIT Once changed type 'reloadxml' at the console."/> <action application="log" data="CRIT WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING "/> <action application="sleep" data="10000"/> </condition>
----------------------------------------------------------------------------------------------------------------------
启动freeswitch报错：
[ERR] sofia.c:3146 Error Creating SIP UA for profile: external-ipv6
[ERR] sofia.c:3146 Error Creating SIP UA for profile: internal-ipv6
处理：禁用ipv6，如果系统不支持，可能会刷如上错误信息，禁用即可 。。查找来自https://www.cnblogs.com/lmsthoughts/p/9322816.html
禁用方式，在主目录执行
mv conf/sip_profiles/internal-ipv6.xml conf/sip_profiles/internal-ipv6.xml.bk
mv conf/sip_profiles/external-ipv6.xml conf/sip_profiles/external-ipv6.xml.bk
重新启动就没有了呵呵
----------------------------------------------------------------------------------
使用fs_cli启动报错
处理报错：[ERROR] fs_cli.c:1659 main() Error Connecting [Socket Connection Error]
编辑
vim /usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml
重启FreeSWITCH
fs_cli -H IP -P 8021 -p ****（密码）
++====================================================================
配置录音功能：
1.创建录音存储文件夹
2.修改配置文件
3.使配置文件生效
4.测试结果
1.建立一个文件夹，在/freeswitch/recordings/archive/ ，用来存储录音文件；
2.修改拨码计划，打开 \conf\dialplan\default.xml
找到下面的语句：
<extension name="Local_Extension">
<condition field="destination_number" expression="^(10[01][0-8])$">
在下面添加录音配置参数：
<action application="set" data="RECORD_TITLE=Recording ${destination_number} ${caller_id_number} ${strftime(%Y-%m-%d %H:%M)}"/>
<action application="set" data="RECORD_COPYRIGHT=(c) 2011"/>
<action application="set" data="RECORD_SOFTWARE=FreeSWITCH"/>
<action application="set" data="RECORD_ARTIST=FreeSWITCH"/>
<action application="set" data="RECORD_COMMENT=FreeSWITCH"/>
<action application="set" data="RECORD_DATE=${strftime(%Y-%m-%d %H:%M)}"/>
<action application="set" data="RECORD_STEREO=true"/>
<action application="record_session" data="$${base_dir}/recordings/archive/${strftime(%Y-%m-%d-%H-%M-%S)}_${destination_number}_${caller_id_number}.wav"/>
3.在fs_cli中使用F6或执行reloadxml使配置文件生效；
4.随便呼叫产生录音文件
FreeSWITCH 架构
FreeSWITCH 的扩展性非常强
参考链接：
FreeSWITCH的安装与使用的更多相关文章
- freeswitch编译安装，初探， 以及联合sipgateway, webrtc server的使用场景。
本文主要记录freeswitch学习过程. 一 安装freeswitch NOTE 以下两种安装方式,再安装的过程中遇到了不少问题,印象比较深刻的就是lua库找到不到这个问题.这个问题发生在make ...
- Freeswitch 各版本一键安装脚本 Freeswitch 快速安装 G729编解码库
最近有时间整理,写了freeswitch的一键安装包分享一下,里面带有 mysql=0 是否选择安装mysql. 其他提示:脚本里面集成了安装g729脚本,支持录音.转码的bcg729脚本. 1.下载 ...
- 64位FreeSWITCH编译安装（版本1.4.20）
1.安装64位的CentOS6.5操作系统(勾选的服务器版本安装). 2.下载FreeSWITCH安装包以及关联的lib库.下载地址http://files.freeswitch.org/downlo ...
- freeSWITCH之安装
freeSWITCH 安装 官网教程 https://freeswitch.org/confluence/display/FREESWITCH/FreeSWITCH+First+Steps Windo ...
- freeswitch 编译安装后的配置
--------------------FreeSWITCH configuration------------Locations: prefix: /usr/local/freeswitchexec ...
- freeswitch编译安装依赖
ncurses:提供字符界面 zlib:数据压缩 libjpeg:JPEG图片格式数据的解码/编码/其他. lua:lua解释器 libedit:一种编辑操作的库,对一些可以交互操作的场景,或转为了自 ...
- Centos 6 安装FreeSWITCH
为了安装FreeSWITCH ,我选择的Linux是CentOS,目前最新的Centos版本是6.具体安装CentOS的是步骤详见网上的其它资料,本节的主要目的是为了记录FreeSWITCH的安装过程 ...
- Freeswitch 安装爬坑记录1
2 Freeswitch的安装 2.1 准备工作 服务器安装CentOS 因为是内部环境,可以关闭一些防火墙设置,保证不会因为网络限制而不能连接 关闭防火墙 查看防火墙 systemctl statu ...
- CentOS 5下freeswitch中集成使用ekho实现TTS功能三
四:在freeswitch中调用ekho 注:在测试过程中该语音包好像没用 FreeSWITCH 中文语音包测试版fssounds.zip 在/usr/local/freeswitch/sounds/ ...
随机推荐
- Spring 声明式事务与编程式事务详解
本文转载自IBM开发者论坛:https://developer.ibm.com/zh/articles/os-cn-spring-trans 根据自己的学习理解有所调整,用于学习备查. 事务管理对于企 ...
- Angle Beats Gym - 102361A
题目链接:https://vjudge.net/problem/Gym-102361A 题意:给定N个点,q次询问每次询问给一个点,问在N个点中取2个和给定点最多可以组成几个直角三角形. 思路:htt ...
- 使用命令行编译Qt程序
code[class*="language-"], pre[class*="language-"] { color: rgba(51, 51, 51, 1); ...
- DAOS 分布式异步对象存储｜安全模型
DAOS 使用了一个灵活的安全模型,将身份验证和授权分离开来.它的设计令其对 I/O 的影响被降到最小. DAOS 对用于 I/O 传输的网络结构没有提供任何传输安全性保障.在部署 DAOS 时,管理 ...
- C++并发与多线程学习笔记--async、future、packaged_task、promise
async future packaged_task promise async std:async 是个函数,用来启动一个异步任务,启动起来一个异步任务之后,返回一个std::futre对象,启动一 ...
- Myabtis-Plus之QueryWrapper常用方法
AbstractWrapper 下的方法及使用 方法名 说明 使用 allEq(Map<R, V> params) 全部 =(或个别 isNull) allEq(params,true) ...
- 答应我，别在go项目中用init()了
前言 go的 init函数给人的感觉怪怪的,我想不明白聪明的 google团队为何要设计出这么一个"鸡肋"的机制.实际编码中,我主张尽量不要使用init函数. 首先来看看 init ...
- Img2Latex 临时方法
Img2Latex 临时方法 博客园Markdown编辑器中公式需采用Latex编写,然鹅现在并不想学习Latex 毕竟工科生,写论文也免不了的各种公式 (终极解决方案当然是学会Latex) 1.工具 ...
- 在 Docker Desktop 中启用 K8s 服务
Overview 作为目前事实上的容器编排系统标准,K8s 无疑是现代应用的基石,很多同学入门可能直接就被卡到第一关,从哪去弄个 K8s 的环境 自己搭吧,要求的硬件资源太高,基本上搭建一个 K8s ...
- Horovod-Usage
Usage 代码中要包含以下6步: 初始化 Run hvd.init() to initialize Horovod. 将每个GPU固定到单个进程以避免资源争用. 一个线程一个GPU,设置到 loca ...