Ubuntu20.04 下编译和运行 FreeSWITCH的问题汇总
1. Ubuntu20.04 下编译和运行 FreeSWITCH的问题汇总
- Ubuntu20.04.2 LTS (Linux 5.4.0-152-generic x86_64 GNU/Linux)
- FreeSWITCH-1.10.9-release
根据配置和编译过程中的错误提示，基本上就是一些依赖库的缺失问题，根据提示给出的依赖库及其版本要求，只要能在apt源中有可用的直接安装，不然就下载对应的库手动编译安装。
由于笔者的机器系统环境之前可能已经存在一些开发库，下文中列出的问题可能未涵盖其他可能的情况，具体情况需要对照各类日志排查解决。
1.2.1. 可以直接通过apt源安装的依赖库
apt install libpq-dev libspeex-dev libspeexdsp-dev libldns-dev libedit-dev libavformat-dev libswscale-dev liblua5.2-dev libopus-dev libsndfile-dev libpng-dev1.2.2. 其他需要手动下载源码编译和安装的库
在源码根目录中执行
./bootstrap.sh因此系统中需要安装有 autotool 工具链。
生成configure文件后执行
./configure这一步可能会出现以下问题：
1.3.1. 缺少 PostgreSQL 库
apt install libpq-dev1.3.2. 缺少 spandsp 库
因为 freeswitch 版本比较新，需要的 spandsp 库版本是3，在 apt 源中的库版本是2，不满足要求，需要手动下载 spandsp源码编译（可能需要依赖库 libtiff-dev，可以在apt源中直接安装）并安装。
切换到git提交：e59ca8f (HEAD) Fix crash when FCD frame has bad length but CRC is OK.
依次执行以下命令
git checkout e59ca8f
./bootstrap.sh
./configure
make && make install1.3.3. 缺少 sofia-sip-ua 库
因为 freeswitch 要求的这个依赖库的版本需要在1.13.12及以上版本，apt源中版本为1.12.11，无法满足要求，因此也需要手动下载sofia-sip源码包编译并安装。
创建对应版本的新分支，并编译安装。
git checkout -b 1.13.12 v1.13.12
./bootstrap.sh
./configure
make && make install1.3.4. 缺少 speex、speexdsp 库
apt install libspeex-dev libspeexdsp-dev1.3.5. 缺少 ldns 库
apt install libldns-dev1.3.6. 缺少 libks 库
下载并安装 libks-dev，版本在1.8.2及以上即可。
必须要在源码根目录下cmake，不能创建临时文件夹编译，否则安装时会报错！
git checkout -b 1.8.2 v.1.8.2
cmake -DCMAKE_BUILD_TYPE=Release .
make && make install1.3.7. Signalwire 模块缺失
freeswitch中的这个模块是用于和Signalwire云服务通信相关的，我用不到，所以直接在freeswitch源码根目录下的 modules.conf 中禁用该模块即可。
同时，在后续运行freeswitch时也要在 conf/autoload_configs/modules.conf.xml中注释掉 <load module="mod_signalwire"/>
1.3.8. 缺少 libedit 库
apt install libedit-dev在上一步配置通过后，编译时仍然会遇到一些依赖错误，因此这一步可以在编译前都解决掉，再从配置步骤开始编译和安装。
1.4.1. mod_av 编译报错
缺少依赖库 avformat和swscale，这两个库属于ffmpeg组件。可以直接在apt源中获取安装。
apt install libavformat-dev libswscale-dev1.4.2. lua.h 头文件查找失败
因为我系统中安装的是lua5.3，但是freeswitch-1.10.9中会查找lua5.0、lua5.1、lua5.2，而lua5.3即使安装也无法识别，正好apt源中也有lua5.2的版本可以安装。
apt install liblua5.2-dev1.4.3. 缺少 opus 库
apt install libopus-dev1.4.4. 缺少 sndfile 库
apt install libsndfile-dev上一步编译成功后，会出现安装提示：
+---------- FreeSWITCH Build Complete ----------+
+ FreeSWITCH has been successfully built. +
+ Install by running: +
+ +
+ make install +
+ +
+ While you're waiting, register for ClueCon! +
+ https://www.cluecon.com +
+ +
+-----------------------------------------------+按照提示安装完成后，会出现安装声音文件的提示：
+---------- FreeSWITCH install Complete ----------+
+ FreeSWITCH has been successfully installed. +
+ +
+ Install sounds: +
+ (uhd-sounds includes hd-sounds, sounds) +
+ (hd-sounds includes sounds) +
+ ------------------------------------ +
+ make cd-sounds-install +
+ make cd-moh-install +
+ +
+ make uhd-sounds-install +
+ make uhd-moh-install +
+ +
+ make hd-sounds-install +
+ make hd-moh-install +
+ +
+ make sounds-install +
+ make moh-install +
+ +
+ Install non english sounds: +
+ replace XX with language +
+ (ru : Russian) +
+ (fr : French) +
+ ------------------------------------ +
+ make cd-sounds-XX-install +
+ make uhd-sounds-XX-install +
+ make hd-sounds-XX-install +
+ make sounds-XX-install +
...直接安装最高质量的声音文件，这会同时安装其他质量的声音文件，这个过程会从freeswitch官方网站上下载声音文件并解压到安装目录的sound子目录下。
make cd-sounds-install1.6.1. 配置修改
index b5a58d1..d77f585 100644
--- a/conf/autoload_configs/modules.conf.xml
+++ b/conf/autoload_configs/modules.conf.xml
@@ -50,7 +50,7 @@
<load module="mod_verto"/>
<!-- Applications -->
- <load module="mod_signalwire"/>
+ <!-- <load module="mod_signalwire"/> -->
<load module="mod_commands"/>
<load module="mod_conference"/>
<!-- <load module="mod_curl"/> -->
diff --git a/conf/sip_profiles/internal.xml b/conf/sip_profiles/internal.xml
index eb07779..aa8f768 100644
--- a/conf/sip_profiles/internal.xml
+++ b/conf/sip_profiles/internal.xml
@@ -135,6 +135,11 @@
<!--<param name="dtmf-type" value="info"/>-->
+ <!--没有这些设置jssip呼叫时freeswitch会响应488-->
+ <param name="apply-candidate-acl" value="rfc1918.auto"/>
+ <param name="apply-candidate-acl" value="localnet.auto"/>
+ <!-- <param name="apply-candidate-acl" value="wan_v4.auto"/> -->
+
<!-- 'true' means every time 'first-only' means on the first register -->
<!--<param name="send-message-query-on-register" value="true"/>-->
@@ -293,8 +298,9 @@
auto - Use guessed ip.
auto-nat - Use ip learned from NAT-PMP or UPNP
-->
- <param name="ext-rtp-ip" value="$${external_rtp_ip}"/>
- <param name="ext-sip-ip" value="$${external_sip_ip}"/>
+ <!-- 解决呼叫后30s左右就自动挂断的问题 -->
+ <!-- <param name="ext-rtp-ip" value="$${external_rtp_ip}"/> -->
+ <!-- <param name="ext-sip-ip" value="$${external_sip_ip}"/> -->
<!-- rtp inactivity timeout -->
<param name="rtp-timeout-sec" value="300"/>
diff --git a/conf/vars.xml b/conf/vars.xml
index 8948d17..be9ab07 100644
--- a/conf/vars.xml
+++ b/conf/vars.xml
@@ -12,7 +12,7 @@
WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-->
- <X-PRE-PROCESS cmd="set" data="default_password=1234"/>
+ <X-PRE-PROCESS cmd="set" data="default_password=123456"/>
<!-- Did you change it yet? -->
<!--
The following variables are set dynamically - calculated if possible by freeswitch - and默认密码若不修改，呼叫时可能有10s左右的延时，若想沿用默认密码，可以修改以下地方去掉呼叫时的延时
index c3edafc..e36dda7 100644
--- a/conf/dialplan/default.xml
+++ b/conf/dialplan/default.xml
@@ -132,7 +132,7 @@
<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"/>
+ <!-- <action application="sleep" data="10000"/> -->
</condition>
<!--
This is an example of how to auto detect if telephone-event is missing and activate inband detection因为是在内网下部署的，不需要用到nat。
freeswitch -nonat -nc1.6.2. 运行时的报错
笔者在呼叫时，虽然可以成功，但是一直有一个报错
[ERR] switch_core_video.c:3099 This function is not available, libpng not installed后来重新安装了 libpng-dev，然后重新配置编译安装后解决
1.6.3. tryit-jssip 与 freeswitch 对接呼叫遇到的问题
tryit-jssip使用websocket方式与freeswitch交互，所以需要使用ws或者wss，参考freeswitch的
conf/sip_profile/internal.xml中开通的ws和wss的端口设置。在上述freeswitch修改的配置中有针对jssip的修改，否则呼叫时会收到488，在freeswitch日志中可以看到如下信息：
no suitable candidates found，按照上述修改之后可解决。tryit-jssip默认的会话刷新时间是90s，若直接呼叫freeswitch的话，会收到422，提示最小刷新时间是120s，所以需要修改下tryit-jssip源码，将会话刷新时间调整为120s及以上或者干脆禁用Session Timers。
具体修改可参考：fs-tryit-jssip
关于 tryit-jssip 的使用参考：tryit-jssip 本地部署
1.6.4. 宝利通呼叫一段时间后被挂断并且无法再次被呼叫
RealPresenceDesktop 3.5.1 UDP下会出现此问题，换成TCP即可。
FreeSWITCH: FreeSWITCH-Explained
手机扫一扫
移动阅读更方便
你可能感兴趣的文章