FreeSWITCH 学习笔记（一）

最新推荐文章于 2024-09-13 11:40:29 发布

weixin_30525825

最新推荐文章于 2024-09-13 11:40:29 发布

阅读量2k

点赞数

文章标签：网络数据库 c/c++

原文链接：http://www.cnblogs.com/Braveliu/p/10943511.html

版权

本文档详细记录了FreeSWITCH的安装、配置和使用过程，包括Windows安装、源码下载、后台启动、密码修改、客户端使用、端口管理、错误排查、CLI命令及模块配置等方面，还涵盖了FreeSWITCH的日志、SIP协议、Dialplan、模块加载、用户注册、端口占用、防火墙设置、呼叫管理、音视频处理等多个关键知识点，是FreeSWITCH初学者的全面学习笔记。

摘要由CSDN通过智能技术生成

【1】FreeSWITCH学习笔记

1、Windows安装包下载地址：

http://files.freeswitch.org/windows/installer/

2、源码下载地址：

http://files.freeswitch.org/freeswitch-1.2.10.tar.gz

3、FreeSWITCH后台模式启动

命令：freeswitch -nc（即No Console）

后台模式没有控制台

4、windows平台默认密码已修改为：liu1234

5、windows平台客户端分别为：X-Lite 和 EyeBeam

6、freeswitch默认使用UDP的5060端口。如果先启动客户端，会占用这个端口，所以，建议先启动freeswitch，再启动客户端。

7、如果运行freeswitch出现以下错误，是因为端口被占用了。

Cannot lock pid file /usr/local/freeswitch/run/freeswitch.pid.

8、如果输入fs_cli，提示如下类似错误：

[ERROR] fs_cli.c:1610 main() Error Connecting [Socket Connection Error]

说明FreeSWITCH没有启动或 mod_event_socket没有正确加载，请检查TCP的8021端口是否处于监听状态或被其他进程占用。

9、freeswitch -nonat

freeSWITCH启动时默认会启用uPnP(或NAT_PMP)协议试图查找你的路由器是否支持并在你的路由器上“打洞”，如果你的路由器不支持该协议，这一步可能耗时比较长，因而影响启动速度。

所以，如果你只是在内网测试并且一天启动很多次的话，建议关掉这个选项。

组合参数（后台模式启动），启动命令：freeswitch -nc -nonat

10、修改配置XML文件后，必须先使用命令使之生效：reloadxml

11、客户端注册错误：

（1）提示408：Request Timeout

一般都是由于防火墙引起的。关闭防火墙（本地CentOS系统）：

临时关闭：service iptables stop

永久关闭：chkconfig iptables off

（2）提示408：forbidden

一般都是由于账号密码配置错误，鉴权没有通过而被禁止注册。

12、可以在freeswitch中使用originate命令发起一次呼叫。假设1000已经注册，那么命令：

originate user/1000 &echo

originate是freeswitch内部的一个命令，它用于控制freeswitch发起一个呼叫。

13、打印变量值。命令global_getvar 与 eval

global_getvar sound_prefix

eval ${sound_prefix}

global_getvar local_ip_v4

eval ${local_ip_v4}

14、自动加载模块的配置文件位置：

/usr/local/freeswitch/conf/autoload_configs/modules.conf.xml文件

15、用户目录默认配置文件在conf/directory/下，系统自带的配置文件为default.xml.

dial-string 一个至关重要的参数。

16、CentOS 系统让所有用户显示行号

输入命令：vim /etc/vimrc

在vimrc文件的最后添加：set nu

保存：wq

手动加载配置：source /etc/bashrc

这样不管是哪个用户在vim下都显示行号

17、FreeSWITCH启动后，在执行命令reloadxml时，错误提示：

+OK [[error near line 6290]: unexpected closing tag </condition>]

表示最近编辑过的xml文件格式有问题，标签形式不完整缺个“/”

18、reloadxml命令可以直接用快捷键F6执行。

console loglevel 7命令可以直接用快捷键F8执行

19、FreeSWITCH命令：查询已注册用户

sofia status profile internal (REGISTRATIONS值：显示多少用户已注册）

具体谁是否注册？可以使用如下命令：

sofia status profile internal reg XXXX

20、默认快捷键集
<cli-keybindings>
    <key name="1" value="help"/>
    <key name="2" value="status"/>
    <key name="3" value="show channels"/>
    <key name="4" value="show calls"/>
    <key name="5" value="sofia status"/>
    <key name="6" value="reloadxml"/>
    <key name="7" value="console loglevel 0"/>
    <key name="8" value="console loglevel 7"/>
    <key name="9" value="sofia status profile internal"/>
    <key name="10" value="sofia profile internal siptrace on"/>
    <key name="11" value="sofia profile internal siptrace off"/>
    <key name="12" value="version"/>
</cli-keybindings>

21、dialplan中的测试条件可以迭加，但是不可以嵌套。

eg: 如下无效条件

22、xml dialplan支持非常丰富的功能。

但在测试或编写程序时，经常用到一些临时的或很简单的dialplan，如果每次都需要修改xml，不仅麻烦，而且执行效率低。

所以，一种短小、轻便的dialplan便因此而生了。

23、App的参数中可能会有逗号，因而会与默认的App间的逗号分隔符相冲突，以下的m语法形式将默认的逗号改为^分隔。

originate user/1000 ‘m:^playback/tmp/beep.wav^bridge:{ignore_early_media=true,originate_caller_id_number=1000}user/1001’inline

24、FreeSWITCH命令：show dialplan 命令？？？？？系统默认支持的Dialplan

25、一般来说，运营商都把应答时间作为计费的开始时间。

26、bridge操作是阻塞的，它会一直等到b-leg释放后才继续往下走。

27、常用的Dialplan App: play_and_get_digits与read类似，但它比read更高级。

28、在Dialplan中使用API命令。