freeswitch 笔记

Dialplan 是freeswitch 对一个呼入电话的路由查询。通过 show dialplan 命令可以查看到当前freeswitch可以支持的哪些 dialplan.

使用用SIP的终端设备称为SIP用户代理(user agent，UA) 。

Sofia 支持多个 profile，而一个 profile相当于一个 SIP UA，在启动后它会监听一个 “IP地址:端口”对。读到这里细心的读者或许会发现我们前面的一个错误。我们在讲 B2BUA的概念时，实际上只用到了一个 profile，也就是一个 UA，但我们还是说 FreeSWITCH启动了两个 UA（一对背靠背的 UA）来为 alice和 bob 服务。是的，从物理上来讲，它确实只是一个 UA，但由于它同时支持多个 Session，在逻辑上就是相当于两个 UA，为了不使用读者太纠结于这种概念问题中，我在前面没有太多的分析。但到了本章，你应该非常清楚 UA的含义了。

FreeSWITCH 默认的配置带了三个 profile（也就是三个 UA），在这里，我们不讨论 IPv6，因此只剩下 internal和external 两个。 internal 和 external 的区别就是一个运行在 5060 端口上，另一个是在 5080 端口上。当然，还有其它区别，我们慢慢讲。

conf/sip_profile/xxx.xml文件

<param name="context" value="public"/>

context 是 dialplan中的环境。在此指定来话要落到 dialplan的哪个 context环境中。需要指出，如果用户注册到该profile上（或是经过认证的用户，即本地用户），则用户目录（directory）中设置的 contex优先级要比这里高

sip_profile相关资料
sip_profile1

启动：freeswitch
启动并后台运行：freeswitch -nc
进入客户端：fs_cli -H 127.0.0.1 -P 8021 -p password
退出客户端：/exit， /bye, /quit Ctrl+D
停止：freeswitch -stop
查询网关状态: sofia status profile local
重启网关: sofia profile local restart
查看freeswitch的端口情况：netstat -anp|grep freeswitch
使用fs_cli进行呼叫：originate user/1003 &echo 其中&echo会把听到的声音返回给发出者
音频编码部分设备不支持可以使用这个bgapi originate {absolute_codec_string=PCMU}user/1009 018162330576 xml default
reloadxml 重新加载xml文件
查看当前注册的用户数量：sofia status profile internal
查找文件夹：find / -name external -type d
复制文件到多个文件夹：echo a b c | xargs -n 1 cp -v ./gwl.xml
重新注册网关：sofia profile external register gw
ps -ef | grep freeswitch netstat -apn | grep 8021
开启sip消息显示 sofia global siptrace on
关闭sip消息显示 sofia global siptrace off

FreeSwitch Hangup-Cause电话挂断原因速查

显示注册用户 ： show registrations
vars.xml | 一些经常使用变量
dialplan/default.xml | 缺省的拨号计划
directory/default/*.xml | SIP用户，每用户一个文件
sip_profiles/internal.xml | 一个SIP profile，或称做一个SIP-UA，监听在本地IP及端口5060，通常供内网用户使用
sip_profiles/externa.xml | 另外一个SIP-UA，用做外部链接，端口5080
autoload_configs/modules.conf.xml | 配置当FreeSWITCH启动时自动装载哪些模块

FS> sofia status profile internal (显示多少用户已注册）
FS> originate sofia/profile/internal/1000 &echo (拨打1000并执行echo程序）
FS> originate user/1000 &echo (同上）
FS> originate sofia/profile/internal/1000 9999 (至关于在软电话1000上拨打9999)
FS> originate sofia/profile/internal/1000 9999 XML default (同上)

fs_cli命令链接

fs较完整资料 originate部分
https://www.cnblogs.com/panghuhu/p/15731174.html

完全fs阅读

fs_path字段是一个SIP URI (Uniform Resource Identifier，统一资源标识符)，它是绕过NAT联系话机的实际地址。这个URL是经过编码的，因此URI中的特殊字符不会与实际联系地址冲突。

FreeSwitch LUA API — Sessions(lua脚本用法)

originate {originate_timeout=25,origination_caller_id_number=8006@aab.wss.com,origination_caller_id_name=8006@aab.wss.com}sofia/gateway/csbc2/8029@aab.wss.com;fs_path=sip:10.9.103.163:16500 &park &playback(/usr/local/freeswitch/sounds/pressure_test.wav)

之前的错误是此处留出空格，应该严格防范这种错误

注意： conf\autoload_configs\switch.conf.xml文件中控制着所有的日志输出级别