XSwitch用户手册

SIP设置

SIP是XSwitch支持的主要协议,有很多配置参数,这些配置参数通常比较复杂,建议只有高级用户使用。

系统支持多个SIP Profile,每个Profile相当于一个SIP UA,通过配置不同参数可以配置一个UA行为。多个SIP Profile监听不同的IP地址和端口。XSwitch默认的配置带有两个Profile:default以及public,前者通常用于内部,需要用户注册的端口,后者通常与外部系统对接,如运营商和网关等。

一个SIP Profile中有可以关联多个网关。网关主要用于描述远端的SIP服务器,使XSwitch可以与其他服务器通信。

SIP Profile

XSwitch支持多个SIP Profile,一个SIP Profile相当于一个SIP服务器,会监听一个“IP:端口”,并支持UDP和TCP协议。SIP Profile中也可以选择开启Websocket(WS和WSS)支持,并分别占用一个端口,如果开启TLS支持,也需要一个独立的端口。

系统默认配置了两个Profile,defaultpublic。一般来说,内部注册用户注册到default Profile上,而外部中继对接可以使用public Profile,前者对所有的注册和呼入都进行SIP Challenge验证鉴权,后者对呼入的通话不鉴权,因而,从public Profile呼入的电话要注意限制呼叫权限。

一般来说,网关会关联到pulic Profile上。网关是向外注册的,这主要是为了当对方的SIP服务器反向回呼时,可以顺利进入系统,而无须鉴权。

一般来说,系统会在初始化安装时配置好,用户无须自己改动里面的参数。如果需要调整,涉及到安全问题,请参阅相关的安全指南或咨询XSwitch技术支持工程师。

添加新的Profile

点击【新建】,输入Profile名称,填写相关描述,选择模板,点击【保存】即可。

Profile功能控制

点击【启用】,当变为“是”时,则启用该Profile,系统启动时,该Profile自动开启。

“状态/控制”栏中,点击【停止】则关闭此时正使用的Profile,同理,点击【重启】,则重新启动该Profile。当改动某些参数后,点击【重新扫描】,自动更新状态(适用于大多数参数改动情况)。

如下图所示:

SIP profile\label{fig:profile}

SIP profile开启的详细信息\label{fig:profile_information}

同理,再次点击【启用】,当变为“否”时,意味,下次使用时关闭该Profile。

点击SIP Profile的名称,进入详情页,可根据需求添加模块参数,同理,如果启用某个参数,点击【启用】变为“是”后,点击页面【 重新扫描】,使之生效。

特别注意:如果某个参数已启用,且有值,当停止此参数效果时,点击【启动】变为“否”后,需要重启该Profile才可生效。

实现多用户注册

XSwitch可实现多个终端同时注册,当有电话打入时,所有注册终端可实现同时响铃,方便用户使用任意终端均可及时通话。

可以在SIP Profile中开启multiple-registrations以开启该功能。

普通SIP话机

查找SIP界面中sip-porttls-sip-port,查看或设置如下:

端口7060(TCP/UDP) 7161(TLS)

sipjs客户端

通过SIP.js实现的一种视频通话客户端,适用于支持WebRTC的浏览器进行视频通话。SIP.js是基于JavaScript编写的功能齐全的SIP堆栈。借助SIP.js利用WebRTC的功能实现语音通话和视频通话。

查找SIP界面中ws-binding的值,在界面输入wss://demo.xswitch.cn:7443,账号,密码等。端口查询如下:

默认端口:

  • 5066(WS)
  • 7443 (WSS)

Verto

如果使用了Nginx,那么端口就对应nginx中的配置即可。如果没有配置Nginx,那么查看Verto下的端口配置。如下例子仅供参考。

  • 内网:80(WS/HTTP)443(WSS/HTTPS)
  • 外网:9080 (WS/HTTP) 4443(WSS/HTTPS)

WS/WSS url示例:

ws://192.168.3.170/ws
wss://192.168.3.170/ws

ws://freeswitch.xyt.com:9080/ws
wss://freeswitch.xyt.com:4443/ws
高级