FreeSWITCH的安装与使用

V2AS问路

FreeSWITCH的安装与使用

阅读原文时间：2023年07月13日阅读：1

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

再继续执行编译安装

./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**

配置文件

系统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

定义全局变量

安装声音文件

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]