FreeSWITCH的安装与使用


FreeSWITCH

FreeSWITCH的是一个跨平台的开源电话交换平台
环境:
[root@cen ~]# cat /etc/redhat-release  CentOS Linux release 7.7.1908 (Core) 安装: 1.准备好FreeSWITCH安装包(我用的1.6版本),

2.安装环境以及依赖

---------------------------------------------------------------------

 1.源码安装 包:github获取或FreeSWITCH官网下载或本人蓝奏云并解压
[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 再继续执行编译安装
  1. ./configure(此过程出现众多未知错误,一般是依赖包没装,百度一堆)
  2. make(make时 出现错误我遇到的处理方法在下下下面)
  3. 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" 
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     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 wget https://cmake.org/files/v3.14/cmake-3.14.0.tar.gz 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 git clone https://github.com/signalwire/signalwire-c.git 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 中的 或修改 conf/dialplan/default.xml 中  ---------------------------------------------------------------------------------------------------------------------- 启动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                      找到下面的语句:                                                                    在下面添加录音配置参数:                                                                                                                                                        3.在fs_cli中使用F6或执行reloadxml使配置文件生效; 4.随便呼叫产生录音文件

FreeSWITCH 架构

FreeSWITCH 的扩展性非常强  参考链接: https://freeswitch.com/ https://www.cnblogs.com/5444de/p/12446992.html https://freeswitch.org/confluence/display/FREESWITCH/Installation http://www.freeswitch.org.cn/2010/05/08/di-wu-zhang-freeswitch-jia-gou.html https://www.kancloud.cn/ichenpeng/blog/1352178 https://cotin.tech/AI/FreeswitchSetting/ https://www.jianshu.com/p/61ce097c9026 http://www.360doc.com/content/17/0307/11/40894077_634670060.shtml https://www.cnblogs.com/Braveliu/p/10943511.html https://blog.csdn.net/zhuimeng11_/article/details/92819658 https://www.cnblogs.com/Lewis302/p/10466936.html  

相关