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