MINISIPSERVER云

云 miniSIPServer 用户手册

1. 介绍

云 miniSIPServer 提供虚拟 SIP 服务器功能,大部分特性、配置与本地 miniSIPServer 服务器相同。本文档只提供云端服务器的基本配置说明,如果您希望了解如何通过云 miniSIPServer 建立一个 VoIP 网络系统,请首先参考 “循序渐进建立VoIP云通信系统” 文档。

2. 系统

本节的配置项会影响整个虚拟 SIP 服务器系统,您可以通过以下方式进行配置:

1、点击主界面工具条中的“系统配置”按钮;

2、点击菜单“数据 / 系统配置”。

2.1 SIP

系统配置中的 SIP 相关项

配置项 描述
SIP 服务器地址

虚拟 SIP 服务器的主地址。所有的 SIP 客户端(或者设备)都应当用这个地址接入(或者呼叫)虚拟 SIP 服务器。

这个地址由系统自动分配,并且不可以更改。

SIP 服务器端口 (UDP)

虚拟服务器打开的 UDP 端口,用于进行 SIP 消息通信。目前每个虚拟服务器都默认打开三个端口,我们可以选择其中一个端口作为 SIP 消息处理的主端口。

根据 SIP 标准的定义,默认端口是 5060 端口。

SIP 服务器端口 (TLS)

虚拟服务器打开的 TLS 端口,用于进行基于TLS传输的 SIP 消息通信。目前 TLS 传输固定采用 6060 端口,不可以更改。

2.2 基本呼叫

系统配置中的基础项

配置项 描述
外呼前缀

默认前缀是“9”。

本地分机用户呼叫外部用户,在被叫号码前默认要拨打前缀“9”。在 “循序渐进建立VoIP云通信系统”文档中演示了一个示范网络,其中的分机用户就需要在被叫号码前先加“9”才能呼叫外部用户。

我们可以配置为其他值, 也可以将其配置为空。

默认路由类型

miniSIPServer 通常根据“拨号计划”分析的结果来获取最终的呼叫路由信息,如果这个过程分析失败,则采用本项配置的默认路由类型继续呼叫。

默认路由有两种类型:

  • 分机 - 呼叫将被投递给一个本地的分机用户;
  • 外线 - 呼叫将被投递给一条外线,对外进行呼叫。
语音提示 用于指示 miniSIPServer 采用何种语言播放语音。目前仅支持中文普通话以及英语。
3. 分机

缺省情况下,miniSIPServer 预设了三个本地分机配置,它们分别是“100”、“101”以及“102”,对应的密码分别是“100”、“101”和“102”。当然,我们可以灵活地添加、修改以及删除本地分机配置,各项操作都非常简单。

请点击菜单“数据 / 分机”、或点击“分机”按钮显示本地分机信息窗体。

本地分机列表窗体

在这个窗体中,用不同的图标来区分分机的状态。

图标 状态
分机离线图标 分机还没有注册到 miniSIPServer 中。
分机在线图标 分机已经注册进系统, 并且目前处于空闲状态。
分机振铃图标 分机正在振铃。
分机通话态图标 分机正在通话。
3.1 基本配置

分机的基本配置

配置项 类型或值 描述
分机号码 字符串 本地分机名称。
分机密码 字符串 分机注册和呼叫时,采用该密码进行 SIP 鉴权。
3.2 基本呼叫

分机的基本呼叫配置

配置项 类型或值 描述
显示号码 字符串

给被叫方显示的号码。

例如,分机“100”配置显示号码为“Gilson”,则被叫看到的主叫号码是“Gilson”。如果将该项配置为空,则被叫方看到的号码是“100”。注意,被叫侧的 SIP 设备(话机等)也有可能忽略掉显示号码,强制显示真实的主叫号码。

无应答时长 (秒) 整数 被叫无应答定时器时长。超时后释放呼叫,或者触发无应答业务,例如无应当前转等。
外呼时指定外线 字符串 如果配置该项,分机呼叫外部用户时将使用指定的外线。如果没有配置该项,分机呼叫外部用户时将由系统轮选一个可用的外线。
主叫最大通话时长 (秒) 整数 作为主叫发出呼叫时,限制最大允许通话时长,超时后 miniSIPServer 将释放呼叫。默认不配置该项,则 miniSIPServer 不会限制通话时长。
最大同时呼叫数 整数

限制该分机同一时间最大并发呼叫数。

如果设置为0,则该用户既不能发起呼叫,也不能接收任何呼叫。

最大同时呼出呼叫数 整数

限制该分机同一时间最多能发起的呼叫数。

如果设置为0,则该用户不能发起任何呼叫,只能接收呼叫。

呼叫权限 整数

不同呼叫的呼叫权限设置。

在“拨号规则 / 分析被叫号码”表中,号码分析结果可以要求不同的呼叫权限,用户只有具有相应权限才能拨打该的呼叫。

3.3 前转业务

分机的前转呼叫配置

配置项 类型或值 描述
呼叫无条件转到号码 是/否

设置各类“前转业务”权限。

如果选择了这些项,说明该分机具有相应的前转业务权限,同时也要求配置相应的前转号码。

请参考“呼叫前转业务文档”了解更多细节。

被叫不可达,呼叫转到号码 是/否
被叫忙,呼叫转到号码 是/否
被叫无应答,呼叫转到号码 是/否
被叫不可达或者无应答时,呼叫转语音邮箱 是/否 如果用户缺席或者没有应答呼叫,miniSIPServer 将提示主叫用户留言并将语音留言发送给用户的email邮箱。
电邮地址 电子邮件地址

分机电子邮箱地址。在语音邮箱业务中,miniSIPServer 将把该分机的语音留言发送到该邮箱中。

请参考“语音邮件”业务文档了解进一步的细节。

3.4 Follow me (呼叫跟随)

请参考“呼叫跟随业务文档”了解业务相关的细节。

分机的呼叫跟随业务配置项

配置项 类型或值 描述
策略 0, 1, 2
  • 0 (默认值) - 同时呼叫所有目的号码;

  • 1 - 当前被叫无应答时,呼叫下一个目的号码;

  • 2 - 间隔一段时间后呼叫下一个目的号码。

间隔时间 (秒) 整数 如果“策略”配置为2,则必须同时配置间隔时间。
目的号码 A 字符串 目的号码 A。
目的号码 B 字符串 目的号码 B。
目的号码 C 字符串 目的号码 C。
3.5 补充业务

分机的补充业务配置项

配置项 类型或值 描述
自动话务员 是/否

当前分机是否是话务员。

请参考 “自动话务员文档” 。

如果直接呼该分机,则抑制同时振铃业务 是/否 如果配置了该项,主叫直接呼叫该分机时,该分机振铃,但是同组的其他分机不会同时振铃。
同时振铃组编号 整数 (>=0) 如果设置为0,则该用户没有同时振铃特性;如果设置为其他值,则配置相同值的用户都属于同一个同时振铃组。请参考 “振铃组” 业务文档。
呼叫代答组编号 整数 (>=0) 如果设置为0,则该用户没有呼叫代答特性;如果设置为其他值,则配置相同值的用户都属于同一个代答组,组内的用户都可以代答其他用户的呼叫。请参考 “指定代答与组内代答” 业务文档。
Call park 是/否 “Call park” 业务权限指示位。请参考 “Call park与call retrieve” 业务文档。
Call retrieve 是/否 “Call retrieve” 业务权限指示位。请参考 “Call park与call retrieve” 业务文档。
呼叫等待 是/否 “呼叫等待” 业务权限指示位。请参考 “呼叫等待” 业务文档。
一号多机 是/否 “一号多机” 业务权限指示位。请参考 “一号多机” 业务文档。
话务员强插 是/否 “话务员强插” 业务权限指示位。请参考 “话务员强插与话务员逾越” 业务文档。
话务员逾越 是/否 “话务员逾越” 业务权限指示位。请参考 “话务员强插与话务员逾越” 业务文档。
3.6 高级业务

分机的高级业务配置

配置项 类型或值 描述
订阅所有用户的状态呈现或者对话信息 是/否

订阅状态呈现信息。

如果配置了该业务权限, miniSIPServer 将上报所有分机的状态给当前用户。

请注意:普通用户请不要选择该权限位,否则会有大量的状态报告消息,可能会影响您的 VoIP 网络质量。

状态呈现分组 整数 (>=0) 如果配置了该参数,分机只能收到同组内其他分机的状态呈现消息。
3.7 媒体

分机的媒体相关配置

配置项 类型或值 描述
呼叫保持时播放音乐 是/否 当SIP终端/电话发送 “保持(HOLD)” 消息给 miniSIPServer 时,miniSIPServer 应当 ”保持“ 当前对话并给对端播放音乐。
转发媒体流 是/否

指示 miniSIPServer 为 SIP 终端/电话转发媒体流。

如果SIP终端部署在私网内并且不具备STUN能力,这就需要 miniSIPServer 帮助转发媒体以避免出现语音单通等故障。

如果SIP终端部署在公网,或者本身具备STUN等私网穿越能力,就没有必要配置 miniSIPServer 转发媒体流。

4. 外线

“外线”用于连接外部的 VoIP 运营商或者 VoIP 网关。本地分机可以通过外线呼叫外部用户,或者接收外部用户的呼叫。

请点击按钮 “外线” 或者点击菜单 “数据 / 外线” 显示外线主窗体并进行各项配置操作

外线主窗体

在这个窗体中,不同的图标代表外线不同的状态:

图标 状态
外线离线状态图标 外线还没有注册到运营商网络 (或FXO网关还没有注册到 miniSIPServer)。
外线在线状态图标 外线已注册到运营商网络 (或FXO网关已注册到 miniSIPServer)。
4.1 基本配置

外线的基础配置项

配置项 类型或值 描述
外线类型 0, 1
  • 0 (默认值)- 注册到 SIP/VoIP 服务器。与 VoIP 运营商对接时,由运营商提供账号信息, miniSIPServer 外线采用这些信息向运营商注册。

  • 1 - 接受 FXO 网关注册。与网关对接时,通常由 miniSIPServer 分配账号信息给网关,网关以此向 miniSIPServer 注册。

外线号码 / 帐号 字符串

如果外线类型是0, miniSIPServer 将使用该项作为用户名,向 VoIP 运营商注册。

如果外线类型是1, VoIP 网关需要使用该项作为用户名,向 miniSIPServer 注册。

密码 字符串 注册鉴权时的用户密码。该项可以为空,这代表无需鉴权。
服务器地址 / 域 字符串

对端 SIP 服务器地址,可以是 IP 地址,也可以是域名地址。

如果外线类型是1,此项不可用。 miniSIPServer 将根据 VoIP 网关注册时的消息获取其真实地址。

服务器端口 整数 (>0)

对端 SIP 服务器的端口。

如果外线类型是1,此项不可用。 miniSIPServer 将根据 VoIP 网关注册时的消息获取其真实端口。

鉴权ID 字符串

鉴权时的用户名或者用户ID。

默认不配置,那么 miniSIPServer 将使用“外线号码”项进行鉴权。

部分 VoIP 运营商提供的账号和鉴权号码是不同的号码,此时需要配置该项进行 SIP 鉴权。

4.2 入呼

外线的入呼叫配置项

配置项 类型或值 描述
将呼叫转接至
  • 自动话务员
  • 目的号码

如果将入呼叫转接至自动话务员, 将触发自动话务员业务。

如果将入呼叫转接目的号码, miniSIPServer 将重新分析新的目的号码(或者呼叫中原有的被叫号码)并得到最终路由信息。

目的号码 字符串 如果入呼叫转接至“目的号码”,则(1)可以在本项中配置新的目的号码,miniSIPServer 重新分析新的目的号码并得到新的路由信息。(2)也可以不设置目的号码,此时意味着 miniSIPServer 继续分析呼叫原有的被叫号码并得到呼叫路由信息。
4.3 外呼

外线的外呼相关配置

配置项 类型或值 描述
通过外部代理发送呼叫 是/否 部分大型 VoIP 运营商会在整个网络的边缘设置代理服务器,要求所有接入设备的 SIP 消息都需先经过代理服务器进行分发,此时, 我们就需要配置这些信息,以确保正确地将消息发给合适的代理服务器。
外部代理地址 字符串 代理服务器地址,可以是 IP 地址,也可以是域名地址。
外部代理端口 整数 (>0) 代理服务器端口。
Request-URI 附加参数 字符串 如果设置了附加参数, miniSIPServer 在向对方服务器(或者网关)发送消息时,将在 RequestURI 后添加该附加参数。中文界面时该项的默认值是“user=phone”,其他语种的界面中该项默认为空。是否配置该项,需要依据对接的 VoIP 运营商的要求。
所有分机都可以使用本外线外呼 是/否

如果配置该项, 则其他分机也可以使用该外线进行外呼。

如果不配置该项, 则只有与该外线绑定的分机可以使用它进行外呼。在“入呼”的配置中,目的号码设置为分机号码,即为绑定分机。

采用原主叫号码作显示号码 是/否 外呼时, 通常向被叫显示该外线的号码。 配置该项后,miniSIPServer 将向被叫显示原主叫用户的号码。
出呼叫群编号 整数 (>=0) 为当前外线定义出呼叫的群编号。若干外线或者SIP中继可以设置相同的出呼叫群编号。在“拨号规则”处理过程中,将使用该编号对呼叫进行号码变换。
无应答时长 (秒) 整数 (>=0) 外呼经过该外线时,该值用于限制呼叫的无应答时长。如果超时,则呼叫会被释放,将尝试下一条外线。默认值是0,即采用系统默认的无应答时长。
最大同时外呼数 整数 (>=0) 限制最大同时呼出呼叫数。如果设置为0,则该外线不允许任何外呼呼叫。
限制最大通话时长 (秒) 整数 (>=0) 如果限制了最大通话时长, 超时则 miniSIPServer 将自动释放呼叫。
当前外呼失败时,采用下一条外线试呼 字符串 如果指定了另一条外线,则当前外线外呼失败时,系统将使用该外线重新尝试外呼。
4.4 其他

外线的其他配置项

配置项 类型或值 描述
鉴权用户名应携带地址信息 是/否 通常鉴权用户名不包含地址信息,但部分 VoIP 运营商要求鉴权用户名必须采用完整格式(即“用户名@域名”格式,例如“2001@1.1.1.1”),则应当勾选本项,miniSIPServer 将采用完整的用户URL进行鉴权。 请注意, 如果“鉴权ID”项配置了完整的 URL 信息,则无需配置本项。
不支持临时响应的可靠性 (sip:100rel) 是/否 这是个非常特殊的配置项。 某些运营商不具备“100rel”能力,同时也无法正确处理呼叫消息中的“100rel”参数,配置这项将迫使 miniSIPServer 在呼叫消息中删除“100rel”参数。
不需要注册 是/否 某些 SIP 中继运营商不要求 SIP 注册消息,仅仅会对每个呼叫单独鉴权,这种情况下我们可以配置这项。
转发媒体流 是/否 如果配置这项, miniSIPServer 将不得不转发媒体流。
最大同时呼叫数 整数 (>0) 外线能处理的同时呼叫数,包含呼入呼叫数和呼出呼叫数。
5. SIP 中继

请参考 “SIP 中继” 文档。

6. 路由群

请参考 “路由群” 文档。

7. 拨号规则(拨号计划)

“拨号规则(拨号计划)”是 miniSIPServer 的核心功能, 我们采用单独一篇文档详细介绍了拨号规则的过程和配置。请参考 “拨号规则” 文档。

8. 业务

miniSIPServer 目前支持大量的业务,每个业务都有对应的业务文档。请访问 “特性列表” 页面获取各业务的文档。

9. 话单(呼叫记录)

请参考 “呼叫记录 (CDR)” 文档。