FreeSwitch 安装部署
v1.10.7 源码编译安装
一、环境&软件版本说明
- 服务器
硬件服务器：腾讯云轻量应用服务器，4核8G 100G
操作系统：CentOS 8.2 64bit
- 安装软件
FreeSWITCH版本：v1.10.7 Release
sofia-sip版本：v1.13.8
spandsp版本：无
二、源文件下载
- Freeswitch模块
freeswitch-1.10.7.tar.gz，访问官方仓库：https://github.com/signalwire/freeswitch下载，本次安装时使用当前最新版本：FreeSWITCH v1.10.7 Release，tag下载地址：（https://github.com/signalwire/freeswitch/tags）
- sofia-sip模块
sofia-sip-1.13.8.tar.gz，访问官方仓库：https://github.com/freeswitch下载，本次安装时使用当前最新版本：sofia-sip-1.13.8，tag下载地址：（https://github.com/freeswitch/sofia-sip/tags）
- spandsp模块
spandsp-master.zip，访问官方仓库：https://github.com/freeswitch下载，该模块无release版本区分，直接下载：https://github.com/freeswitch/spandsp
三、目录规划
- 源码路径
将freeswitch、sofia-sip、spandsp三个源码包上传到该目录下：
/app/package/repository/freeswitch-1.10.7.tar.gz
/app/package/repository/sofia-sip-1.13.8.tar.gz
/app/package/repository/spandsp-master.zip
- 编译路径
将三个源码包解压到/app/package/source/目录进行编译，如下：
- 安装路径
- FreeSWITCH
主程序目录：/app/rainbow/freeswitch/
录音文件：/app/rainbow/data/recordings/
应用程序目录：/app/rainbow/webapps/
四、安装流程简述
- 安装gcc编译器
源码安装需要使用c、c++编译器，执行：yum install gcc gcc-c++，当前服务器已自带gcc8.2，执行：yum install gcc-c++
- 安装sofia-sip和spandsp
由于FreeSwitch-1.10.x某个版本将sofia-sip和spandsp模块分离了，所以在安装freeswitch前需要单独编译安装这两个模块，否则会提示：
checking for spandsp >= 3.0... configure: error: no usable spandsp; please install spandsp3 devel package or equivalent
checking for sofia-sip-ua >= 1.xx.xx... configure: error: no usable sofia-sip; please install sofia-sip-ua devel package or equivalent
- 安装FreeSWITCH
五、编译安装步骤
- 安装包上传
（1）将freeswitch、sofia-sip、spandsp三个模块的源码包解压到/app/package/source/目录下，如下所示：
- 安装sofia-sip模块
（1）进入目录：cd sofia-sip-1.13.8
（2）编译：./bootstrap.sh
如执行后提示autoreconf：command not found，见问题附录一处理后再继续。
（3）编译：./configure
（4）安装：make
如执行后提示openssl/ssl.h:No such or directory，见问题附录二处理后再继续。
（5）安装：make install
- 安装spandsp模块
（1）进入目录：cd spandsp-master/
（2）编译：./bootstrap.sh
（3）编译：./configure
如执行后提示configure: error: "Cannot build without libtiff (does your system require a libtiff-devel package?)"，见问题附录三处理后再继续。
如执行后提示configure: error: "Cannot build without libtiff (does your system require a libjpeg-devel or libjpeg-turbo-devel package?)"，见问题附录四处理后再继续。
（4）安装：make
（5）安装：make install
- 安装freeswitch模块
（1）在完成上述前置模块的安装后，执行如下命令重载库缓存配置和环境变量：
ldconfig
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
（1）进入目录：cd freeswitch-1.10.7/
（2）编译：./bootstrap.sh
（3）编译：./configure
如需指定安装目录和文件结构编译：
./configure --prefix=/app/rainbow/freeswitch --disable-fhs
如执行后提示configure: error: Library requirements (sqlite3 >= 3.6.20) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them.，见问题附录五处理后再继续。
如执行后提示configure: error: Library requirements (libcurl >= 7.19) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them.，见问题附录六处理后再继续。
如执行后提示configure: error: Library requirements (libpcre >= 7.8) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them.，见问题附录七处理后再继续。
如执行后提示configure: error: Library requirements (speex >= 1.2rc1 speexdsp >= 1.2rc1) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them.，见问题附录八处理后再继续。
如执行后提示configure: error: You need to either install libldns-dev or disable mod_enum in modules.conf，见问题附录九处理后再继续。
如执行后提示configure: error: You need to either install libedit-dev (>= 2.11) or configure with --disable-core-libedit-support，见问题附录十处理后再继续。
编译成功后如下所示：
Freeswitch的标准安装目录为/usr/local/freeswitch，为了将文件统一安装某一个目录下，可设置编译参数，重新编译：
./configure --prefix=/ownswitch/fshome
如下所示：
由于FreeSwitch安装目录结构遵循了FHS（Filesystem Hierarchy Standard，即文件系统层次结构标准）指定安装目录后，可以看到在prefix目录内部又自动划分了多层级目录，vi configure文件，看到如下内容：
由上可知，可以修改configure文件判断条件来达成保持缺省目录结构的目的，同时可以增加编译参数禁用FHS来达成，如下：
./configure --prefix=/app/rainbow/freeswitch --disable-fhs
执行后看到如下内容：
（4）安装：make
如执行后提示Neither yasm nor nasm have been found. See the prerequisites section in the README for more info.，见问题附录十一处理后再继续。
如执行后提示Makefile:1476: *** You must install libavformat-dev and libswscale-dev to build mod_av. Stop.，见问题附录十二处理后再继续。
如执行后提示mod_lua.cpp:37:10: fatal error: lua.h: No such file or directory、[Makefile:1040: libluamod_la-mod_lua.lo] Error 1，见问题附录十三处理后再继续。
如执行后提示Makefile:967: *** You must install libopus-dev to build mod_opus. Stop.，见问题附录十四处理后再继续。
如执行后提示Makefile:965: *** You must install libpq-dev to build mod_pgsql. Stop.，见问题附录十五处理后再继续。
如执行后提示Makefile:976: *** You must install libks to build mod_signalwire. Stop.，见问题附录十六处理后再继续。
如执行后提示Makefile:971: *** You must install signalwire-client-c to build mod_signalwire. Stop.，见问题附录十七处理后再继续。
如执行后提示Makefile:1451: *** You must install libsndfile-dev to build mod_sndfile. Stop.，见问题附录十八处理后再继续。
Make成功后如下所示：
（5）安装：make install，安装成功如下所示：
进入/app/rainbow/freeswitch/目录查看，结构如下所示：
创建软连接：
ln -sf /app/rainbow/freeswitch/bin/freeswitch /usr/bin/
ln -sf /app/rainbow/freeswitch/bin/fs_cli /usr/bin/
启动服务到后台：
freeswitch -nc
查看启动日志，显示IPv6的支持问题，如下所示：
如不需要ipv6，进入sip_profiles目录下去掉ipv6配置文件即可，执行：
mv external-ipv6.xml external-ipv6.xml_bak
mv internal-ipv6.xml internal-ipv6.xml_bak
然后重新启动
- 启用freeswitch-portal（可选）
freeswitch portal为内置模块，开箱即用，安装完成之后只需要启用就可以，如下：
fs_cli
load mod_xml_rpc
启用后可访问：http://服务IP:8080/portal，默认账户为：freeswitch/works，可以在 conf/autoload_configs/xml_rpc.conf.xml中修改，修改后可直接在控制台reload mod_xml_rpc生效。
如果想跟随freeswitch启动则直接操作配置文件具体如下
#conf/autoload_configs/modules.xml 中去掉如下注释：
<load module="mod_xml_rpc"/>
启用后，访问结果如下：
如果在浏览器右上角出现：Socket Disconnected,表示数据的自动更新使用Ajax轮询的方式获得；如果想使用Websocket自动更新数据，只需要在xml_rpc.conf.xml中添加<param name="enable-websocket" value="true"/>
- 对接postgresQL
基于公司1.10.7版本
在auto_modules/switch.conf.xml修改连接信息如下：
放开pgql注释编辑连接信息，放开auto-create-schemas自动创建表空间，最后注释掉原来放开的core-db-name
Freeswitch各个模块的数据库是可以单独设置的，不同的模块接入时，会创建不同的表结构，涉及修改的文件内容如下：
- auto_modules/switch.conf.xml
- auto_modules/db.conf.xml
- sip_profiles/internal.xml
fifo.conf.xml
voicemail.conf.xml
external.xml
也可以统一放在vars.xml中设置。
六、卸载
在源码目录下执行：
make uninstall
七、问题附录
- （一）安装sofia-sip提示autoreconf：command not found
安装sofia-sip模块，如执行./bootstrap后提示autoreconf：command not found，如下：
根据提示需要安装libtool，执行安装：
yum -y install autoconf automake libtool
- （二）安装sofia-sip提示：openssl/ssl.sh 不存在
安装sofia-sip模块，如执行make后提示fatal error: openssl/ssl.h: No such file or directory #include <openssl/ssl.h>,如下：
根据提示需要安装openssl-devel，执行安装：
yum install openssl-devel
安装完成后需要对sofia-sip模块重新./configure。
- （三）安装spandsp提示Cannot build without libtiff
安装spandsp模块，如执行./configure后提示configure: error: "Cannot build without libtiff (does your system require a libtiff-devel package?)"，如下：
根据提示需要安装libtiff-devel，执行安装：
yum install libtiff-devel
- （四）安装spandsp提示Cannot build without libtiff
安装spandsp模块，如执行./configure后提示configure: error: "Cannot build without libtiff (does your system require a libjpeg-devel or libjpeg-turbo-devel package?)"，如下：
根据提示需要安装libjpeg-devel，执行安装：
yum install libjpeg-devel
- （五）安装freeswitch提示sqlite错误
安装freeswitch模块，如执行./configure后提示configure: error: Library requirements (sqlite3 >= 3.6.20) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them. ，如下：
根据提示需要安装sqlite-devel，执行安装：
yum install sqlite-devel
- （六）安装freeswitch提示libcurl错误
安装freeswitch模块，如执行./configure后提示configure: error: Library requirements (libcurl >= 7.19) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them.，如下：
根据提示需要安装curl-devel，执行安装：
yum install curl-devel
- （七）安装freeswitch提示libpcre错误
安装freeswitch模块，如执行./configure后提示configure: error: Library requirements (libpcre >= 7.8) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them.，如下：
根据提示需要安装pcre-devel，执行安装：
yum install pcre-devel
- （八）安装freeswitch提示speex、speexdsp错误
安装freeswitch模块，如执行./configure后提示configure: error: Library requirements (speex >= 1.2rc1 speexdsp >= 1.2rc1) not met; consider adjusting the PKG_CONFIG_PATH environment variable if your libraries are in a nonstandard prefix so pkg-config can find them.，如下：
根据提示需要安装speex-devel、speexdsp-devel，执行安装：
yum install speex-devel
yum install speexdsp-devel
安装过程中腾讯云的仓库找不到speex-devel、speexdsp-devel，丢了个阿里云的repo到/etc/yum.repo/下面启用后继续安装。
- （九）安装freeswitch提示libldns错误
安装freeswitch模块，如执行./configure后提示configure: error: You need to either install libldns-dev or disable mod_enum in modules.conf，如下：
根据提示可选择安装库文件或修改modules.conf禁用该功能，这里选择安装：
yum install ldns-devel
- （十）安装freeswitch提示libedit错误
安装freeswitch模块，如执行./configure后提示configure: error: You need to either install libedit-dev (>= 2.11) or configure with --disable-core-libedit-support，如下：
根据提示可以选择安装库文件或增加编译参数(--disable-core-libedit-support)，在此选择执行安装：
yum install libedit-devel
- （十一）安装freeswitch提示yasm错误
安装freeswitch模块，如执行make后提示Neither yasm nor nasm have been found. See the prerequisites section in the README for more info.，如下：
根据提示需要安装yasm或nasm，执行安装：
yum install yasm
- （十二）安装freeswitch提示libavformat-dev and libswscale-dev错误
安装freeswitch模块，如执行make后提示Makefile:1476: *** You must install libavformat-dev and libswscale-dev to build mod_av. Stop.，如下：
根据提示需要安装libavformat-dev和libswscale-dev用于编译mod_av模块，连续找了几个yum源都没找到（在此推荐：https://centos.pkgs.org/，提供各类依赖包检索和下载），最后直接从官方lib库（Index of /downloads/libs）下载编译所需文件：
- 安装libav需要libx264，先装libx264
wget -c http://files.freeswitch.org/downloads/libs/libx264.tar.bz2
tar -jxvf libx264.tar.bz2
./configure --enable-static --enable-shared --prefix=/usr
make
make install
cp /usr/lib/pkgconfig/x264.pc /usr/lib64/pkgconfig/
cp /usr/lib/libx264.so /usr/lib64/
cp /usr/lib/libx264.a /usr/lib64/
- 下载安装libav
下载：wget -c http://files.freeswitch.org/downloads/libs/libav-12.tar.bz2
解压：tar -jxvf libav-12.tar.bz2
编译：./configure --enable-pic --enable-shared --enable-libx264 --enable-gpl --extra-libs="-ldl" --extra-cflags=-I/usr/include --extra-ldflags=-L/usr/lib64
安装：make
make提示libav make: *** No rule to make target `util.asm', needed by `libavresample/x86/audio_convert.o'. Stop.可以删了解压目录重新解压安装。
安装：make install
cp /usr/local/lib/pkgconfig/libavcodec.pc /usr/local/lib/pkgconfig/libavdevice.pc /usr/local/lib/pkgconfig/libavfilter.pc /usr/local/lib/pkgconfig/libavformat.pc /usr/local/lib/pkgconfig/libavresample.pc /usr/local/lib/pkgconfig/libavutil.pc /usr/local/lib/pkgconfig/libswscale.pc /usr/lib64/pkgconfig/
ldconfig # 执行刷新，以让FreeSWITCH运行时可以找到库
###################################
# 如果编译完成 libav 以后，启动 mod_av 还是找不到库，可以用以下方式加载动态库路径
# LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
# export LD_LIBRARY_PATH
###################################
- （十三）安装freeswitch提示lua.h错误
安装freeswitch模块，如执行make后提示mod_lua.cpp:37:10: fatal error: lua.h: No such file or directory、[Makefile:1040: libluamod_la-mod_lua.lo] Error 1，如下：
根据提示需要安装lua-devel，执行安装：
yum install lua-devel
- （十四）安装freeswitch提示libopus-dev错误
安装freeswitch模块，如执行make后提示Makefile:967: *** You must install libopus-dev to build mod_opus. Stop.，如下：
根据提示需要安装opus-devel，执行安装：
yum install opus-devel
安装后需要重新configure
- （十五）安装freeswitch提示libpq-dev错误
安装freeswitch模块，如执行make后提示Makefile:965: *** You must install libpq-dev to build mod_pgsql. Stop.，如下：
根据提示如要编译使用mod_pgsql模块需要安装libpq-devel，选择执行安装：
yum install libpq-devel
安装后需要重新configure
- （十六）安装freeswitch提示libks错误
安装freeswitch模块，如执行make后提示Makefile:976: *** You must install libks to build mod_signalwire. Stop.，如下：
根据提示如要编译使用mod_signalwire模块需要安装libks，选择执行安装：
yum install libks
安装后需要重新configure
- （十七）安装freeswitch提示signalwire-client-c错误
安装freeswitch模块，如执行make后提示Makefile:971: *** You must install signalwire-client-c to build mod_signalwire. Stop.，如下：
根据提示如要编译使用mod_signalwire模块需要安装signalwire-client-c，选择执行安装：
yum install signalwire-client-c
安装后需要重新configure
- （十八）安装freeswitch提示libsndfile-dev错误
安装freeswitch模块，如执行make后提示Makefile:1451: *** You must install libsndfile-dev to build mod_sndfile. Stop.，如下：
根据提示如要编译使用mod_sndfile模块需要安装libsndfile-devel，选择执行安装：
yum install libsndfile-devel
安装后需要重新configure
八、添加FreeSwitch yum源
使用FreeSwitch提供的yum源，需要访问：Log into Your SignalWire Account | SignalWire
可以使用github账户登陆地址，登陆后访问该地址生成Token，如下所示：
回到服务器，使用刚刚在Signalwire网站生成的用户名和TOKEN替换下面命令中的“user”和“TOKEN”,执行如下命令：
echo "用户名" >/etc/yum/vars/signalwireusername
echo "TOKEN串" > /etc/yum/vars/signalwiretoken
yum install https://用户名:TOKEN串@freeswitch.Signalwire.com/repo/yum/centos-release/freeswitch-release-repo-0-1.noarch.rpm
执行后如下所示：
继续执行：yum install epel-release
然后刷缓存：yum makecache
执行成功之后，可以执行yum repolist看到freeswitch和epel源。
九、FreeSwitch常用命令
- 概述
通过执行freeswitch -help可以查看帮助信息，如下：
- 服务启停
前台启动：freeswitch -c
后台启动：freeswitch -nc
停止服务 ：freeswitch -stop
- 模块加载
进入fs_cli控制台：
- 加载模块：load 模块名
- 卸载模块：unload 模块名
- 重载模块：reload 模块名：
如重载话单配置：reload mod_cdr_csv
重载mrcp配置：reload mod_unimrcp
重载lua配置：reload mod_lua
- 配置重载
- 重载通用配置：reloadxml
- 重载acl配置：reloadacl
- 重载网关配置：reload sofia profile external rescan/restart
