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,default
和public
。一般来说,内部注册用户注册到default
Profile上,而外部中继对接可以使用public
Profile,前者对所有的注册和呼入都进行SIP Challenge验证鉴权,后者对呼入的通话不鉴权,因而,从public
Profile呼入的电话要注意限制呼叫权限。
一般来说,网关会关联到pulic
Profile上。网关是向外注册的,这主要是为了当对方的SIP服务器反向回呼时,可以顺利进入系统,而无须鉴权。
一般来说,系统会在初始化安装时配置好,用户无须自己改动里面的参数。如果需要调整,涉及到安全问题,请参阅相关的安全指南或咨询XSwitch技术支持工程师。
添加新的Profile
点击【新建】,输入Profile名称,填写相关描述,选择模板,点击【保存】即可。
Profile功能控制
点击【启用】,当变为“是”时,则启用该Profile,系统启动时,该Profile自动开启。
“状态/控制”栏中,点击【停止】则关闭此时正使用的Profile,同理,点击【重启】,则重新启动该Profile。当改动某些参数后,点击【重新扫描】,自动更新状态(适用于大多数参数改动情况)。
如下图所示:
同理,再次点击【启用】,当变为“否”时,意味,下次使用时关闭该Profile。
点击SIP Profile的名称,进入详情页,可根据需求添加模块参数,同理,如果启用某个参数,点击【启用】变为“是”后,点击页面【 重新扫描】,使之生效。
特别注意:如果某个参数已启用,且有值,当停止此参数效果时,点击【启动】变为“否”后,需要重启该Profile才可生效。
实现多用户注册
XSwitch可实现多个终端同时注册,当有电话打入时,所有注册终端可实现同时响铃,方便用户使用任意终端均可及时通话。
可以在SIP Profile中开启multiple-registrations
以开启该功能。
普通SIP话机
查找SIP界面中sip-port
或tls-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