SRProxy 介绍
目前 WebRTC 协议跟 SIP 协议互通场景主要运用在企业呼叫中心、企业内部通信、电话会议（PSTN）、智能门禁等场景，要想让 WebRTC 与 SIP 互通，要解决两个层面的问题：信令层和媒体层。两个网络使用的信令机制不同，所以要进行信令的转换，才能完成媒体的协商，建立会话。媒体层要完成编码的转换，以及 rtp/srtp 转换等功能。anyRTC 开源 SRProxy 网关，解决了 WebRTC 与 SIP 的协议转换，配合 anyRTC 开源的 ARCall 音视频呼叫 demo,演示如何通过 App/Web 端呼叫落地，下文就如何使用部署 SRProxy 网关，以及如何跟 ARCall 互通进行展开，熟悉如何使用后，可集成 SDK 到自己的应用中，配合自身业务做对应的场景。
呼叫流程
一、ARCall 呼叫逻辑
二、SRProxy 转发逻辑
1、SRProxy 能做什么？
从上图简单概括一下：SRProxy 是实现 RTC 和 SIP 之间业务互通的桥梁，更是实现业务拓展的关键服务。
2、呼叫流程
1、状态流转图
呼叫邀请中，主叫可以通过 [LocalInvitation] 对象提供的 [getState] 方法查询当前呼叫邀请的有关状态；被叫可以通过 SDK 返回的 [RemoteInvitation]对象的 [getState]方法查询当前呼叫邀请的相关状态。
LocalInvitationState
下图描述了与主叫相关的呼叫邀请状态流转图：
RemoteInvitationState
下图描述了与被叫相关的呼叫邀请状态流转图：
2、API 时序图
取消已发送呼叫邀请
接受／拒绝呼叫邀请
注意事项及限制条件
主叫设置的呼叫邀请 content 的字符串长度：8 KB，格式为 UTF-8。
被叫设置的呼叫邀请响应 response 的字符串长度：8 KB，格式为 UTF-8。
呼叫邀请的 channel ID 仅用于与老信令互通时设置。设置的 channel ID 必须与老信令 SDK 设置相同才能实现互通。字符串长度：64 字节，格式为 UTF-8。
创建一个应用
一、注册账号
到anyRTC官网注册一个开发者账号，并创建一个应用
二、创建应用获取 AppId
部署 freeswitch
一、准备
一、系统
Centos 7.9 最好是纯净服务器 不然可能会存在依赖装不上或冲突情况
二、防火墙
参考 freeswitch 防火墙: https://freeswitch.org/confluence/display/FREESWITCH/Firewall
# 开放sip端口tcp协议[root@localhost ~]# firewall-cmd --permanent --add-port=5060/tcp# 开放sip端口udp协议[root@localhost ~]# firewall-cmd --permanent --add-port=5060/udp# 开放ws端口[root@localhost ~]# firewall-cmd --permanent --add-port=5066/tcp# 开放wss端口[root@localhost ~]# firewall-cmd --permanent --add-port=7443/tcp# 开放rtp端口（范围）[root@localhost ~]# firewall-cmd --permanent --add-port=16384-32768/udp# 让防火墙配置生效[root@localhost ~]# firewall-cmd --reload
# 也可以直接关闭防火墙[root@localhost ~]# systemctl stop firewalld[root@localhost ~]# systemctl disable firewalld
复制代码
二、编译环境和 FreeSwitch 依赖库
# 更新yum源[root@localhost ~]# yum update -y # 安装lib相关需求依赖[root@localhost ~]# yum install -y yum-utils git gcc gcc-c++ automake autoconf libtool libtiff-devel libjpeg-devel openssl-devel vim
# 添加环境变量[root@localhost ~]# vim /etc/profileexport PKG_CONFIG_PATH=/usr/local/lib/pkgconfig[root@localhost ~]# source /etc/profile # 单独下载spandsp源码[root@localhost ~]# cd /usr/local/src[root@localhost src]# git clone https://github.com/freeswitch/spandsp.git[root@localhost src]# cd spandsp[root@localhost spandsp]# ./bootstrap.sh[root@localhost spandsp]# ./configure[root@localhost spandsp]# make[root@localhost spandsp]# make install[root@localhost spandsp]# ldconfig # 单独下载sofia-sip（SIP协议栈）源码 尝试使用过码云上面的，但是freeswitch编译的时候一直报错需要sofia-sip[root@localhost ~]# cd /usr/local/src[root@localhost src]# git clone https://github.com/freeswitch/sofia-sip.git[root@localhost src]# cd sofia-sip[root@localhost sofia-sip]# ./bootstrap.sh -j[root@localhost sofia-sip]# ./configure[root@localhost sofia-sip]# make[root@localhost sofia-sip]# make install[root@localhost sofia-sip]# ldconfig
# 单独下载libuuid源码[root@localhost ~]# cd /usr/local/src[root@localhost src]# wget https://jaist.dl.sourceforge.net/project/libuuid/libuuid-1.0.3.tar.gz[root@localhost src]# tar -zxvf libuuid-1.0.3.tar.gz[root@localhost src]# cd libuuid-1.0.3[root@localhost libuuid-1.0.3]# ./configure[root@localhost libuuid-1.0.3]# make[root@localhost libuuid-1.0.3]# make install # 编译安装cmake 3.8.2[root@localhost ~]# cd /usr/local/src[root@localhost src]# wget https://cmake.org/files/v3.8/cmake-3.8.2.tar.gz[root@localhost src]# tar zxvf cmake-3.8.2.tar.gz[root@localhost cmake]# cd cmake-3.8.2[root@localhost cmake-3.8.2]# ./bootstrap[root@localhost cmake-3.8.2]# gmake[root@localhost cmake-3.8.2]# gmake install
# 安装libatomic[root@localhost ~]# yum install -y libatomic # 单独下载libks源码（需要cmake 3.7.2以上版本）[root@localhost ~]# cd /usr/local/src[root@localhost src]# git clone https://github.com/signalwire/libks.git[root@localhost libks]# cmake .## 如果出现uuid错误，就重新编译libuuid源码，还是uuid错误就退出终端重新进入在执行cmake .[root@localhost libks]# make[root@localhost libks]# make install # 安装fs依赖[root@localhost ~]# yum install -y http://files.freeswitch.org/freeswitch-release-1-6.noarch.rpm epel-release
# 安装ffmpeg需要[root@localhost ~]# rpm --import http://li.nux.ro/download/nux/RPM-GPG-KEY-nux.ro[root@localhost ~]# rpm -Uvh http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-1.el7.nux.noarch.rpm
# yum安装相关依赖[root@localhost ~]# yum install -y alsa-lib-devel bison broadvoice-devel bzip2 curl-devel libdb4-devel e2fsprogs-devel erlang flite-devel g722_1-devel gdbm-devel gnutls-devel ilbc2-devel ldns-devel libcodec2-devel libcurl-devel libedit-devel libidn-devel libmemcached-devel libogg-devel libsilk-devel libsndfile-devel libtheora-devel libuuid-devel libvorbis-devel libxml2-devel lua-devel lzo-devel ncurses-devel net-snmp-devel opus-devel pcre-devel perl perl-ExtUtils-Embed pkgconfig portaudio-devel postgresql-devel python-devel python-devel soundtouch-devel speex-devel sqlite-devel unbound-devel unixODBC-devel which yasm zlib-devel libshout-devel libmpg123-devel lame-devel rpm-build libX11-devel libyuv-devel swig wget ffmpeg ffmpeg-devel
# 安装python组件[root@localhost ~]# curl https://bootstrap.pypa.io/pip/2.7/get-pip.py --output get-pip-2.7.py[root@localhost ~]# python get-pip-2.7.py # 验证pip是否安装成功[root@localhost ~]# pip --version # pip安装python组件[root@localhost ~]# pip install pydub python-ESL pika dbutils
复制代码
三、安装 FreeSwitch
# git下载freeswitch[root@localhost ~]# git clone -b v1.10 https://github.com/signalwire/freeswitch.git freeswitch# 如果github连接不顺畅的话，可以试试码云镜像仓库（更新慢1天）[root@localhost ~]# git clone -b v1.10 https://gitee.com/mirrors/FreeSWITCH.git freeswitch
# 编译安装freeswitch前奏[root@localhost ~]# cd freeswitch[root@localhost freeswitch]# ./bootstrap.sh -j[root@localhost freeswitch]# vim modules.conf
复制代码
根据需要打开或关闭注释
formats/mod_shoutlanguages/mod_python#event_handlers/mod_cdr_pg_csvasr_tts/mod_unimrcpendpoints/mod_rtmp
复制代码
如果需要使用mod_xml_curl的话
给不需要的模块加上注释
#applications/mod_av#applications/mod_signalwire
复制代码
编译安装
[root@localhost freeswitch]# ./configure --with-python=/usr/bin/python2.7 --with-lua=/usr/bin/lua --enable-core-pgsql-support
# 如果在spandsp位置报错，可以尝试执行下面这句 在执行./configure[root@localhost freeswitch]# export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
# 编译freeswitch[root@localhost freeswitch]# make
# 编译安装 mod_cdr_pg_csv-install[root@localhost freeswitch]# make mod_unimrcp-install
# 如果需要空上模块的话[root@localhost freeswitch]# make mod_xml_curl-install
# 编译安装音频文件（英文）[root@localhost freeswitch]# make cd-sounds-install[root@localhost freeswitch]# make cd-moh-install
# 编译安装freeswitch[root@localhost freeswitch]# make install
复制代码
额外安装音频文件（英文）
[root@localhost freeswitch]# make uhd-sounds-install[root@localhost freeswitch]# make uhd-moh-install[root@localhost freeswitch]# make hd-sounds-install[root@localhost freeswitch]# make hd-moh-install[root@localhost freeswitch]# make sounds-install[root@localhost freeswitch]# make moh-install
复制代码
建立软连接
[root@localhost freeswitch]# sudo ln -sf /usr/local/freeswitch/bin/freeswitch /usr/local/bin/[root@localhost freeswitch]# sudo ln -sf /usr/local/freeswitch/bin/fs_cli /usr/local/bin/
复制代码
配置mod
[root@localhost ~]# vim /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml
复制代码
在前3行开启(位置可能不对,能找到)
<load module="mod_console"/> <load module="mod_logfile"/> <load module="mod_xml_curl"/>
复制代码
打开注释
<load module="mod_python"/> <load module="mod_shout"/>
复制代码
添加配置
<load module="mod_cdr_pg_csv"/> <load module="mod_unimrcp"/> <!--<load module="mod_vad"/>-->
复制代码
注释掉其他不需要的模块
<!-- <load module="mod_av"/> --> <!-- <load module="mod_signalwire"/> -->
复制代码
如果没有其它要求 部署freeswitch到这就可以结束了
配置acl白名单
[root@localhost ~]# vim /usr/local/freeswitch/conf/autoload_configs/acl.conf.xml
复制代码
<!-- 根据自己网络的实际情况进行配置（照抄大概率无效） --><list name="domains" default="deny"><!-- domain= is special it scans the domain from the directory to build t$ --> <node type="allow" domain="$${domain}"/><!-- ==================这里添加 本机ip 127.0.0.1 ======================== --><!-- ==================这里添加 本机内网ip ======================== --><!-- ==================这里添加 本机外网ip ======================== --><!-- ==================这里添加 web内网ip 192.168.1.221======================== --><!-- ==================这里添加 web外网ip 公网IP======================== --><!-- ==================这里添加 runcall 内外网Ip======================== --> <node type="allow" cidr="192.168.1.0/24"/> <node type="allow" cidr="公网IP/32"/></list>
复制代码
# 保存后，在freeswitch客户端，输入reloadacl reloadxml进行重新加载acl文件[root@localhost ~]# fs_clifreeswitch@localhost>reloadacl reloadxml
复制代码
配置ESL
[root@localhost ~]# vim /usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml
复制代码
<configuration name="event_socket.conf" description="Socket Client"> <settings> <param name="nat-map" value="false"/> <!--ip 统一为0.0.0.0--> <param name="listen-ip" value="0.0.0.0"/> <!-- 端口号 默认8021 --> <param name="listen-port" value="8021"/> <!-- 密码统一Aicyber --> <param name="password" value="Aicyber"/> <!-- 允许acl白名单内的IP 访问 --> <param name="apply-inbound-acl" value="domains"/> <!--<param name="apply-inbound-acl" value="loopback.auto"/>--> <!--<param name="stop-on-bind-error" value="true"/>--> </settings></configuration>
复制代码
适配WebRTC（JSSIP/SIPJS）
[root@localhost ~]# vim /usr/local/freeswitch/conf/sip_profiles/internal.xml
复制代码
<param name="apply-candidate-acl" value="rfc1918.auto"/> <param name="apply-candidate-acl" value="localnet.auto"/> <param name="apply-candidate-acl" value="candidate"/> <!-- 取消注释这一行（让前端可以得到早期媒体） --> <param name="enable-100rel" value="true"/>
复制代码
适配特定终端（以云翌通安卓SDK为例）
[root@localhost ~]# vim /usr/local/freeswitch/conf/sip_profiles/internal.xml
复制代码
<param name="user-agent-string" value="YunEasy"/>
复制代码
拨号计划
[root@localhost ~]# vim /usr/local/freeswitch/conf/sip_profiles/internal.xml
复制代码
<!-- 默认是public --> <param name="context" value="default"/>
复制代码
关闭ipv6
[root@localhost ~]# cd /usr/local/freeswitch/conf/sip_profiles[root@localhost sip_profiles]# mv internal-ipv6.xml internal-ipv6.xml.removed[root@localhost sip_profiles]# mv external-ipv6.xml external-ipv6.xml.removed
复制代码
四：配置 Sip 的 Proxy 转发规则
[root@localhost ~]# vim /usr/local/freeswitch/conf/dialplan/default.xml ##配置文件中加入以下配置，多个 SRProxy 就配置多个号码
<extension name="group_dial_sip_proxy"> <condition field="destination_number" expression="^0(.*)$"> <action application="set"><![CDATA[sip_h_X-Number=<sip:$1@${domain_name}>]]></action> <action application="bridge" data="user/1000@192.168.x.xx"/> </condition></extension>
复制代码
意思是：如果呼叫的 SIP 号码前面加 0，则自动路由到 1000 号码上；这个 1000 号码是 SRProxy 中配置的 Proxy 账号，这样 SRProxy 就可以收到 Sip 外呼的请求，从发对 RTC 发起呼叫。
注：配置中 192.168.x.xx 是你机器的真实 IP，有公网 EIP 填公网 EIP 地址，局域网则填局域网 IP 地址。
五、FreeSwitch 呼叫时间修改
安装完 freeswitch 发现进行 sip 呼叫的时候出现差不多延时 10 秒左右才能接收呼叫 主要原因是 freeswitch 中默认配置了延时时间 只需要注释掉就能解决这个问题
[root@localhost freeswitch]# vim /usr/local/freeswitch/conf/dialplan/default.xml
<condition field="${default_password}" expression="^1234$" break="never"> <action application="log" data="CRIT WARNING WARNING WARNING WARNING WARNING WARNING WARNI NG WARNING WARNING "/> <action application="log" data="CRIT Open $${conf_dir}/vars.xml and change the default_pas sword."/> <action application="log" data="CRIT Once changed type 'reloadxml' at the console."/> <action application="log" data="CRIT WARNING WARNING WARNING WARNING WARNING WARNING WARNI NG WARNING WARNING "/> <!--<action application="sleep" data="10000"/>--> #注释这一行即可 </condition>
复制代码
启动生效
六、FreeSwitch 显示主叫号码
[root@localhost freeswitch]# cd /usr/local/freeswitch/conf/directory/default[root@localhost default]# vim 1000.xml
<include> <user id="1000"> <params> <param name="password" value="$${default_password}"/> <param name="vm-password" value="1000"/> </params> <variables> <variable name="toll_allow" value="domestic,international,local"/> <variable name="accountcode" value="1000"/> <variable name="user_context" value="default"/> <!--<variable name="effective_caller_id_name" value="Extension 1000"/>--> # 注释 <!--<variable name="effective_caller_id_number" value="1000"/>--> # 注释这两行 <variable name="outbound_caller_id_name" value="$${outbound_caller_name}"/> <variable name="outbound_caller_id_number" value="$${outbound_caller_id}"/> <variable name="callgroup" value="techsupport"/> </variables> </user></include>
复制代码
启动生效
## 后台快速启动[root@localhost ~]# freeswitch -nc -nonat
## 控制台启动（退出即关闭服务）[root@localhost ~]# freeswitch
复制代码
七、FreeSwitch 自动增加号码
freeswitch 是一个开源的呼叫中心服务，默认号码是 1000-1019 只有 20 个号码时,无法满足时,需要增加号码使用
[root@localhost ~]# vim /usr/local/freeswitch/conf/dialplan/default.xml
<extension name="Local_Extension"> <!--<condition field="destination_number" expression="^(10[01][0-9])$">--> # 注释这一行 或者修改这一行 <condition field="destination_number" expression="^(1[0-9][0-9][0-9]|20[0-9][0-9])$"> # 重新定义号码段 段为1000~2099 <action application="export" data="dialed_extension=$1"/> <!-- bind_meta_app can have these args <key> [a|b|ab] [a|b|o|s] <app> --> <action application="bind_meta_app" data="1 b s execute_extension::dx XML features"/>
复制代码
[root@localhost ~]# freeswitch.sh
#!/bin/bash# Author: lzy# data： 2021-11-16
# 设置变量# freeswitch存放号码目录TARGET_FREESWITCH_PREFIX=/usr/local/freeswitch/conf/directory/default/# 因为默认已经有1000-1019 所以设置从1020开始,可以随时改i=1020
# 设置循环,-le 小于等于2099结束while [ $i -le 2599 ]do # i=$i+1 $i=1020 逐步往上+1 let i=$i+1 # cp 复制1000.xml 重命名$i 逐步+1 cp $TARGET_FREESWITCH_PREFIX/1000.xml $TARGET_FREESWITCH_PREFIX/$i.xml # sed将1000.xml文件里面的1000 改为文件本身的数值 sed -i "s/1000/$i/" $TARGET_FREESWITCH_PREFIX/$i.xmldone
复制代码
## 脚本授权 执行脚本[root@localhost ~]# chmod +x freeswitch.sh[root@localhost ~]# ./freeswitch.sh
## 保存后，在freeswitch客户端，输入reloadxml进行重新加载.xml文件[root@localhost ~]# fs_clifreeswitch@localhost>reloadxml
复制代码
部署 SRProxy
源码地址：https://github.com/anyRTC-UseCase/SipRtcProxy
一、Windows 7 +
双击：SipRtcProxy.sln ，直接运行
项目是 VS2017 创建，VS2015，VS2019 可自行验证。
二、Linux - Centos7.0 +
下载代码到本地
[root@localhost ~]# git clone https://github.com/anyRTC-UseCase/SipRtcProxy.git
[root@localhost ~]# cd SipRtcProxy.git
环境变量
[root@localhost SipRtcProxy]# vim /etc/profileexport LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/root/SipRtcProxy/so/[root@localhost SipRtcProxy]# source /etc/profile
复制代码
执行
[root@localhost SipRtcProxy]# make
配置文件
[root@localhost SipRtcProxy]# vim rtx.conf
[global]appid=XXXXX ## 创建应用时注册的Appid sip_svr=IP:5060 ## freeswitch_IP地址和端口，目前仅支持freeswitch默认端口
## 配置私有云RTC环境 注释默认连接公网环境#[rtc]#ip=RTC_IP#port=6080
## 配置私有云RTM环境 注释默认连接公网环境#[rtm]#ip=RTM_IP#port=7080
[rtm2sip]on=1 ## 是否开启RTM2SIP;0:不开启 1:开启acc_rule=1005;10[06-19] ## 号码范围根据freeswitch进行调整;号码情况:1005，1006-1019 共15个号码,同Appid下多个SRProxy 号码不能冲突
[proxy]on=1 ## 是否开启SIP代理;0:不开启 1:开启sip_account=1000 ## freeswitch代理账号:1000,客户端不可与此号码冲突；且一个SRProxy只能用一个号码,换个环境需换个号码,如:1001sip_pwd=1234 ## freeswitch密码rtm_account=1086 ## 登入RTM账号,客户端不可与此号码冲突,且一个appid只能用一个号码,换个环境需换个号码,如:1087
[log]#* 0:SENSITIVE 1:VERBOSE 2:INFO 3:WARNING 4:ERROR 5:NONElevel=2file=rtc_sip.logmax_file_size=100
复制代码
前台启动
[root@localhost SipRtcProxy]# ./SRProxy rtx.conf
三、Linux - Centos7.0 + 已编译
下载地址: https://arcll.demo.agrtc.cn/arcall_md/SRProxy.tar.gz
创建目录
[root@localhost ~]# mkdir /usr/local/ar4/
[root@localhost ~]# tar zxvf SRProxy.tar.gz
将srproxy.tar.gz放到/usr/local/ar4/解压
[root@localhost ~]# cd /usr/local/ar4/
[root@localhost ar4]# tar zxvf srproxy.tar.gz
将rtx.sh脚本放入/usr/bin下面并赋予权限
[root@localhost ~]# chmod +x /usr/bin/rtx.sh
进入目录
[root@localhost ~]# cd /usr/local/ar4/srproxy/[root@localhost srproxy]# vim conf/rtx.conf
[global]appid=XXXXX ## 创建应用时注册的Appid sip_svr=IP:5060 ## freeswitch_IP地址和端口，目前仅支持freeswitch默认端口
## 配置私有云RTC环境 注释默认连接公网环境#[rtc]#ip=RTC_IP#port=6080
## 配置私有云RTM环境 注释默认连接公网环境#[rtm]#ip=RTM_IP#port=7080
[rtm2sip]on=1 ## 是否开启RTM2SIP;0:不开启 1:开启acc_rule=1005;10[06-19] ## 号码范围根据freeswitch进行调整;号码情况:1005，1006-1019 共15个号码,同Appid下多个SRProxy 号码不能冲突
[proxy]on=1 ## 是否开启SIP代理;0:不开启 1:开启sip_account=1000 ## freeswitch代理账号:1000,客户端不可与此号码冲突；且一个SRProxy只能用一个号码,换个环境需换个号码,如:1001sip_pwd=1234 ## freeswitch密码rtm_account=1086 ## 登入RTM账号,客户端不可与此号码冲突,且一个appid只能用一个号码,换个环境需换个号码,如:1087
[log]#* 0:SENSITIVE 1:VERBOSE 2:INFO 3:WARNING 4:ERROR 5:NONElevel=2file=rtc_sip.logmax_file_size=100
复制代码
配置没有问题后启动SRProxy
进入目录：
[root@localhost ~]# cd /usr/local/ar4/srproxy/
[root@localhost srproxy]# rtx.sh start SRProxy ## 启动
[root@localhost srproxy]# rtx.sh restart SRProxy ## 重启
[root@localhost srproxy]# rtx.sh stop SRProxy ## 停止
添加任务计划 实现自启动
[root@localhost ~]# crontab -e
*/1 * * * * sh /usr/local/ar4/srproxy/moni_srp.sh >/dev/null 2>&1
Demo 演示
一、登入 ARCall （连接公网 RTC、RTM）
ARCall 源码下载地址： https://github.com/anyRTC-UseCase/ARCall
配置 AppId 一定要和 SRProxy 配置文件一致
二、登入 sip（模拟电话 连接 FreeSwitch）
下载地址：https://arcll.demo.agrtc.cn/arcall_md/MicroSIP-3.8.1.exe
连接的 freeswitch 一定要和 SRProxy 配置的一致
添加账户 点击 Menu--->Add account
三、ARCall 拨打 sip
ARCall 拨打 sip 使用正常流程即可，号码多少就拨打多少
注意： 拨打设备 一定要有麦克风才可拨通
呼叫成功
四、sip 拨打 ARCall
sip 打 ARCall 需要前面加个 0 ，根据配置 Sip 转发规则而定
注意： 拨打设备 一定要有麦克风才可拨通
呼叫成功
评论