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
高级