FreeSwitch连接语音网关配置及使用场景

FreeSwitch连接语音网关配置及使用场景

简介

在学习的过程中需要使用FS和语音网关连接，通过SIP接入运营商呼到手机或者固话。在FreeSWITCH中使用SIP和运营商对接达到落地的效果。

对接方式

简单介绍一下，FreeSWITCH里Gateway（网关）的概念。网关又成协议转换器，通常都是进行协议转换。这里说的网关指的是语音网关，如常用的SIP网关，负责SIP协议和七号信令或ISDN PRI（模拟信号）之间的转换。FreeSWITCH中的网关可以理解成一个SIP代理。通过SIP代理连接语音网关设备或系统，将SIP转换成模拟信号。简化一下过程， FreeSWITCH完成号码的落地工作

其简化后的过程大致如下：

OPenSIPS —-> FreeSWICTCH —-> 语音网关 —-> 运营商 —-> 手机或固话

对接的最终目的都是为了将通话转到网关上，熟悉SIP协议的都知道，其实就是发INVITE消息。按照对接方式，分成认证和非认证。非认证又称IP对接，或者SIP中继对接。简单理解认证方式就是，FreeSWITCH无法随意的将呼叫送到网关上，需要经过网关的认证。非认证方式，只要知道网关地址，大家都可以发起INVITE。这里可能涉及到安全问题，后面将详细讨论

注册的SIP服务器
通常sip终端都需要注册到某台SIP服务器上（就像手机要连接到基站），以实现呼出和呼入的功能

注册在OpenSIPS上的SIP终端发起的呼叫请求将发送到OpenSIPS，OpenSIPS根据路由脚本配置使用load_balancer（负载均衡）模块或dispatcher(调度模块）将呼叫请求转发到其他sip服务器或网关上。反之当sip服务器或网关呼叫注册在OpenSIPS上的终端时，会呼入到OpenSIPS（只有OpenSIPS有被叫SIP终端的AOR信息），然后opensips再呼叫SIP终端。这是就是一个典型的注册服务器。

配置信息

中继配置
conf\sip_profiles\external

FreeSWITCH需要建立一个网关并注册到网关设备上。见下面配置：

简单的介绍一些这几个参数：

realm：域名
username：认证的用户名
password：认证的密码
from-user：指定在SIP消息中的源用户信息，没有配置则默认和username相同
from-domain：是指定域，它们会影响SIP中的“From”头域。
regitster-proxy：表示注册的地址
outbound-proxy：表示呼出时指向的地址，这里其实和注册地址是一致的
register：是否注册
expire-seconds：注册的间隔时间

这样表示FreeSWITCH作为一个分机注册到网关172.29.1.8上。

拨号规则

在freeswitch中比较重要的一个部分就是diaplan了，diaplan拨号计划简单的来说就是一种号码规则，他可以根据自己定义的规则，设置对应did（目标号码）或者设置匹配的规则，每一步如何实现，都在这里设置实现的，dialplan有多种方式实现，这里我们主要使用默认xml dialplan方式。
xml dialplan拨号计划由多个context组成，每个context中有多个extension。所以context就是多个extension的逻辑集合，它相当于一个分组。一个context的extension和其他context中的extension在逻辑上是隔离的

拨号规则:出局目录

\conf\dialplan\default\

拨号规则:入局目录

\conf\dialplan\public\

#dialplan的完整结构

<?xml version="1.0" encoding="utf-8"?>
<document type="freeswitch/xml">
  <section name="dialplan" description="Regex/XML Dialplan">
    <context name="default">
      <extension name="Test Extension" continue="true">
      </extension>
    </context>
  </section>
</document>
 
extension
#extension相当于路由表的表项，其中每一个extension都有一个name属性，name可以是任意合法的字符串，本身对呼叫流程
#没有任何影响，但给它取一个好听的名字有助于你在查看log时发现它

continue="true"
#continue默认值是false，在false情况下condition匹配规则找到对应的extension，就执行对应的action，而不会再继续
#再查找其他的extension了；若continue="true"则所有满足condition规则的action都能得到执行

condition
#在extension中可以对一些condition（测试条件）进行判断，如果满足测试条件所指定的表达式，则执行对应的action（动作）
#一般来说测试条件不可以嵌套，但可以叠加（叠加是逻辑与的关系），但FreeSWITCH于2012年底加入了嵌套dialplan的支持
<condition field="network_addr" expression="^192\.168\.1\.251$" break="on-true"></condition>
condition的break参数，为了方便讨论我们假设有两个条件A和B
break="on-false" #第一个次匹配失败时停止（但继续处理其他的extension），这是默认配置，结果相当于A and B
break="on-true" #在第一次匹配成功时停止（但会完成对应的Action，然后继续处理其他extension）
#不成功则继续，所以结果相当于（（not A）and B）
break="always" #不管是否匹配都停止
break="never" #不管是否匹配，都继续

action
#执行具体的APP或者API动作，一个action通常有两个属性，一个是application代表要执行的APP、另一个是data就是
#APP的参数，当APP没有参数时，data也可以省略
anti-action
#执行反动作，如下代码所示，符合条件就执行action的动作，不符合就执行anti-action动作

<extension name="anction and anti-action">
  <condition field="destination_number" expression="^1234$">
    <action application="playback" data="good-morning.wav"/>
    <anti-action application="playback" data="good-morning.wav"/>
    <action inline="true" application="playback" data="good-morning.wav"/>
  </condition>
</extension>
 
inline="true"
#正常情况下在hunting阶段是只解析dialplan，不执行action，如果加上inline="true"这一属性，则在hunting阶段就会
#直接执行，而不用等到execut阶段，当然并不是所有的的APP都能用inline执行，适合执行的APP必须能很快的执行，一般只是
#存取某个变量，并且不能改变当前Channel的状态，当然inline也不是解决所有问题的万能钥匙，由于它会打乱执行顺序
#所以使用不当也可能会产生非预期的效果

在FreeSWITCH中配置如下路由，当外呼时就可以将呼叫送至网关上了。然后由网关出局

<extension name="callout">
  <condition field="destination_number" expression="^10086$">
<action application="bridge" data="sofia/gateway/test/10086"/>
  </condition>
</extension

其它情况

有时候会有这样的场景，用户会要求送指定的号码，首先要向运营商申请外呼的号码，freeswitch上实现外呼呼叫的方式为配置一个网关，指定运营商的接入号和密码，有呼叫这个号码时，运营商会接收freeswitch送过来的号码并指定给被呼叫方

从这里我们可以知道网关对应的外网地址和端口，那只要把呼叫信息发到语音网关即可。执行freeswitch的dialplan出局路由，其中将<action application=“set” data=“gateway=” + dstNum + “”/>"; 把dstNum替换成送出的中继号码。那么需要配置路由如下：

<document type="freeswitch/xml">
<section name="dialplan">
<context name="default">
<extension name="Gateway_Extension">
<condition field="destination_number" expression="^(10086)$"><action application="set" data="callee=$1"/>
<action application="export" data="callee=$1"/>
<action application="export" data="sip_h_caller=9*********"/>
<action application="export" data="sip_h_callee=$1"/>
<action application="export" data="sip_h_ocallId=${uuid}"/>
<action application="export" data="da=true"/>
<action application="set" data="effective_caller_id_number=9**********"/>
<action application="set" data="callerDomain=freeswitch.com"/>
<action application="export" data="callerDomain=freeswitch.com"/>
<action application="set" data="call_timeout=60"/>
<action application="set" data="gateway=" + **dstNum** + "\"/>";
<action application="set" data="record_rate=8000"/>
<action application="set" data="record_sample_rate=8000"/>
<action application="set" data="recording_follow_transfer=true"/>
<action application="set" data="record_append=true"/>
<action application="set" data="answered_time="""/>
<action application="bridge" data="${regex(${sofia_contact(internal/[email protected]${domain_name})}|^(.+)sip:(.+)@(.+)|%1sip:[email protected]%3)}"/>
</condition></extension></context></section>
</document>

总结

FreeSWITCH和网关如果在同一网段或者网关在FreeSWITCH的外网的话（实际上就是说FreeSWITCH可以直接访问到网关），就采用FreeSWITCH注册到网关或者指向网关的方式，这也是常用的方式。 如果网关在内网，而FreeSWITCH在外网的话，就只能采用内网网关注册到FreeSWITCH的方式。