admin管理员组文章数量:1530842
2023年12月29日发(作者：)
用户手册
V 9.4.6 LTS | 2018年9月18日 | 2998-1202-008
PortSIP® PBX用户手册
1
商标信息
PortSIP® 以及与PortSIP产品相关的名称和标记均为博瞻信息技术有限公司的商标及/或服务标记，是该公司在中国，美国及其他国家或地区的注册及/或普通法商标。其他所有商标均为其各自所有者的资产。未经博瞻信息明确书面许可，不得将此文件的任何部分以任何方式进行复制或转载。
专利信息
随附产品受中国、美国和其它国家/地区的一项或多项专利或博瞻信息技术有限公司正在申请的专利所保护。
免责声明
由于某些国家或地区、州或省不允许对暗示担保有排除或限制，或不允许对提供给消费者的特定产品可能导致的任何意外的、连带性的损失有限制，或不允许对人身伤害的责任有限制，因此上述有关限制或责任排除的规定可能不适用于您。
当不允许将暗示担保整体排除时，它们将仅限于适用书面担保的期限。该担保赋予您可能随当地法律而异的特定法律权利。
© 2018 博瞻信息技术有限公司。保留所有权利。
博瞻信息
湖南长沙市岳麓区文轩路麓谷企业广场C2-903
未经博瞻信息技术有限责任公司的明确书面许可，不得出于任何目的、以任何形式或任何方式（无论是电子方式还是机械方式）对本手册内容的任何部分进行复制或传播。依据法律，复制包括将内容翻译为其他语言或格式。
就缔约方之间而言，博瞻信息技术有限责任公司保留对其产品所含软件全部所有权的权益和所有权。该软件受中国版权法、美国版权法和国际条约规定的保护。因此，您必须像对待其他任何具有版权的资料（如书籍或录音）一样对待该软件。
我们致力确保本手册上的信息准确。博瞻信息对印刷错误或笔误概不负责。本文档中的信息可予以更改，恕不另行通知。
2
目录
PortSIP® PBX用户手册 ............................................................................................... 1
商标信息 ................................................................................................................................................ 2
专利信息 ................................................................................................................................................ 2
免责声明 ................................................................................................................................................ 2
目录 .............................................................................................................................. 3
1.
1.1
1.2
1.3
1.4
开始使用 PortSIP PBX ................................................................................. 6
什么是 PortSIP PBX？ ........................................................................................................... 6
准备工作 ................................................................................................................................. 6
PortSIP PBX 的软硬件要求 ................................................................................................... 7
获取帮助和技术支持 ............................................................................................................... 9
2.
2.1
2.2
2.3
2.4
安装 PortSIP PBX ...................................................................................... 10
下载 PortSIP PBX ................................................................................................................ 10
在 Linux 上安装 PortSIP PBX ............................................................................................. 10
在 Windows 系统安装 PortSIP PBX ................................................................................... 14
规避 HTTPS 证书安全警告信息 ........................................................................................... 16
3.
3.1
3.2
配置部署 PortSIP PBX ............................................................................... 17
PortSIP PBX 的架构 ............................................................................................................ 17
PortSIP PBX 的部署模式 ..................................................................................................... 20
4.
4.1
4.2
4.3
4.4
4.5
4.6
配置管理PortSIP PBX ............................................................................... 28
服务状态 ............................................................................................................................... 28
话机配置 ............................................................................................................................... 29
话机管理 ............................................................................................................................... 33
分机用户管理 ........................................................................................................................ 35
分机组 ................................................................................................................................... 38
SIP 域名和传输协议管理 ...................................................................................................... 39
3
4.7
4.8
4.9
4.10
4.11
4.12
4.13
配置 VoIP 运营商以及 SIP 中继 ........................................................................................... 43
配置接入规则和外拨规则 ...................................................................................................... 45
配置振铃组/传呼组/对讲组 .................................................................................................... 48
配置虚拟接待/自动总机 ........................................................................................................ 50
配置呼叫队列 ........................................................................................................................ 55
配置会议 ............................................................................................................................... 57
管理会议 ............................................................................................................................... 58
5.
5.1
5.2
5.3
5.4
设置管理租户 .............................................................................................. 60
创建租户 ............................................................................................................................... 60
停用租户 ............................................................................................................................... 60
删除租户 ............................................................................................................................... 61
管理租户 ............................................................................................................................... 61
6.
7.
8.
9.
9.1
9.2
通话录音 ..................................................................................................... 62
WebRTC .................................................................................................... 63
当前通话 ..................................................................................................... 65
通话详情及通话记录报告 ............................................................................ 66
查看通话记录 ........................................................................................................................ 66
生成通话记录报告 ................................................................................................................. 66
10.
10.1
10.2
10.3
计费 ............................................................................................................ 69
新增费率 ............................................................................................................................... 69
编辑/删除费率 ....................................................................................................................... 69
导入/导出费率 ....................................................................................................................... 69
11.
11.1
11.2
11.3
11.4
11.5
11.6
11.7
设置 ............................................................................................................ 70
常规 ...................................................................................................................................... 70
高级选项 ............................................................................................................................... 72
配置移动推送信息 ................................................................................................................. 73
管理媒体服务器 .................................................................................................................... 75
配置语音邮箱 ........................................................................................................................ 76
管理会议服务器 .................................................................................................................... 77
备份和还原 ........................................................................................................................... 78
4
11.8
安全 ...................................................................................................................................... 79
12.
12.1
12.2
12.3
黑名单和代码 .............................................................................................. 82
代码和 E164 ......................................................................................................................... 82
号码黑名单 ........................................................................................................................... 82
IP 黑名单 .............................................................................................................................. 82
13.
13.1
13.2
13.3
13.4
13.5
13.6
13.7
个人资料 ..................................................................................................... 85
常规 ...................................................................................................................................... 85
工作时间 ............................................................................................................................... 85
存储限额 ............................................................................................................................... 86
邮件服务器 ........................................................................................................................... 86
Music on Hold ..................................................................................................................... 87
事件 URL .............................................................................................................................. 87
SMS ...................................................................................................................................... 91
14.
14.1
14.2
14.3
14.4
部署实例 ..................................................................................................... 95
将 PortSIP PBX 部署在局域网 ............................................................................................. 95
在局域网里部署大容量并发的 PortSIP PBX ........................................................................ 95
在局域网里部署支持超过 1 万并发通话的PortSIP PBX ...................................................... 96
在阿里云上部署 PortSIP PBX .............................................................................................. 98
激活 PortSIP PBX 授权许可 .................................................................................... 105
5
1. 开始使用 PortSIP PBX
本用户手册将指引你将 PortSIP PBX 部署在 Windows 或 Linux 操作系统环境里，并展示了几个典型的部署方式以适用于不同的应用场景。
1.1 什么是 PortSIP PBX？
PortSIP PBX（也叫 PortPBX）是一个纯软件统一通信系统，支持 Windows 和 Linux 平台。可以与其他基于 SIP 标准实现的 IP 电话、软件电话、SIP中继以及语音网关等一起组网工作，以比传统硬件PBX更低廉的价格和更便捷的管理提供完整的通信解决方案。
PortSIP PBX 不仅仅拥有和传统硬件 PBX 一样的功能，还包括更多新增功能，比如对移动和WebRTC的支持。PortSIP PBX统一通信系统不像传统的 PBX 系统一样需要单独的电话线路，而是直接使用 Internet 或者局域网网络，所有的呼叫都以IP数据包的形式在 IP 网络上传输。同时，把 PortSIP PBX 和 VoIP 服务器运营商或者 SIP 中继链接在一起，就可以方便地与 PSTN 网络电话，手机进行通话。也可以使用 VoIP 服务器运营商而不需要通过网关。PortSIP PBX具有良好的兼容性，能够和绝大多数厂商的 SIP 标准产品一起工作。
1.2 准备工作
Linux 安装先决条件
将 PortSIP PBX部署在 Linux 的系统环境里，除了需要对 SIP 标准、音视频通话以及 IM 消息有初步的了解之外，还需要熟悉以下相关内容：
主流 Linux 版本
Redhat RHEL（64 位）、CentOS 7 或更高版本（64 位）、Debian 9 或更高版本（64
位）、Ubuntu 14.04 或更高版本（64 位）；
IPtables 和 Firewalld
本手册假定 Linux
操作系统已经安装并正常运行，PortSIP PBX
管理员拥有 Linux root
权限。
6
Windows 安装先决条件
将 PortSIP PBX部署在 Windows 的系统环境里，除了需要对 SIP 标准、音视频通话以及 IM 消息有初步的了解之外，还需要熟悉以下相关内容：
Windows 桌面或者服务器操作系统：
Windows 7、Windows 8、Windows 10、Windows Server 2008 R2 + SP1、2012 R2、2016 R2
IPv4/IPv6
Windows 系统防火墙
本手册假定Windows操作系统已经安装并正常运行，PortSIP PBX
管理员拥有 Windows
系统管理员权限。
1.3 PortSIP PBX 的软硬件要求
PortSIP PBX支持如下操作系统
Linux 服务器：
CentOS 7 或更高版本（64 位）；gcc/g++ 6.4 或更高版本
Ubuntu 16.04.4或更高版本（64 位）；gcc/g++ 6.4 或更高版本
Debian 9.0或更高版本（64 位）；gcc/g++ 6.4 或更高版本
Windows 桌面系统
Windows 7、8、10，64 位
Windows Server：
Windows Server 2008 R2 + SP1、2012 R2、2016 R2，64 位
重要提示：系统必须已升级到最新版本并安装了所有补丁。
PortSIP PBX 支持如下虚拟平台
为了帮助用户节约成本开支以及提高系统的性能，构造高可用通信系统，PortSIP PBX 支持虚拟化技术，已经在如下虚拟以及云平台上进行过严格测试：
● VMware ESX 5.X 及以上版本
7
●
Linux HyperV
● Microsoft HyperV 2008 R2 及以上版本
● Amazon AWS
● UCloud
● 阿里云
● Linode
● Digital Ocean
●Godaddy VPS 和 云
● 腾讯云
PortSIP PBX 的性能取决于如下几个关键因素：
● PBX 系统需要支持多少路并发通话
● PBX 系统需要支持多少用户同时在线
● 是否对通话进行录音
● 仅对音频录音还是对音视频均录音
● PBX 系统需要支持多少人同时进行语音和视频会议
● PBX 需要支持多少 IVR（Virtual Receptionist）
● PBX 系统需要支持多少呼叫队列（Call Queue）
● PBX 系统需要支持多少振铃组（Ring Group）
基于以上几个关键的需求， PortSIP PBX 可以在从 Intel i3 CPU 到 Inter Xeon 多CPU的各种PC机以及服务器上顺畅运行。
其他要求
● 最新版本的 Firefox、Google Chrome 或者 IE 浏览器
● 微软 .NET Framework version 4.5或者更高版本
● 了解 Linux 和 Linux 网络管理
● 熟悉 Windows 和 Windows 网络系统管理
● 与 通过端口 6881 的稳定网络连接
8
● 与 和 通过端口 3478 的稳定网络连接
● 与 通过端口 3478 的稳定网络连接
域名 (FQDN) 支持
PortSIP PBX 可以在没有域名的机器上运行，但是我们推荐使用域名。使用域名有如下好处：
● 可以更方便地访问 PortSIP PBX 的管理控制台
● 如果安装 PBX 的机器更换了 IP 地址，使用域名可以让你更方便地管理 IP 电话机和客户端
● 访问管理控制台的时候，可以更方便地启用 HTTPS
你所使用的域名（FQDN）必须能在局域网里正确地解析到安装了 PortSIP PBX 的机器；如果
PortSIP PBX 安装在 Internet 上，那么域名必须能正确解析到安装 PBX 的机器的公网地址。
1.4 获取帮助和技术支持
如果您在安装使用中有任何问题，可随时联系博瞻信息技术支持团队，或者访问我们的知识库获取解决方案。
9
2. 安装 PortSIP PBX
本章提供的内容将指导你如何将 PortSIP PBX 安装到 Windows 和 Linux。
本章包含以下内容：
2.1 下载 PortSIP PBX
你可以在博瞻信息的网站上免费下载最新版本的 PortSIP PBX。PortSIP PBX 分为 Windows 版本和 Linux 版本，只支持 64 位系统。
免费版的 PortSIP PBX 最大支持 3 路并发通话，无用户（分机）数量限制。如果您需要更多的并发通话数量支持，请参阅授权许可章节。
下载完成后，您即可获得安装包。
2.2 在 Linux 上安装 PortSIP PBX
2.2.1 准备 Linux 主机
在安装 PortSIP PBX 之前，必须准备好一台安装了 Linux 操作系统的电脑/服务器，并进行如下操作：
1. 如果你要安装PBX的 Linux 电脑/服务器位于局域网里，必须分配一个静态的局域网 IP 地址；如果位于公网，必须得有一个公网静态IP。
2. 在安装 PortSIP PBX 之前安装所有可用的系统更新和补丁包。
3. 不要在这台电脑上安装 VPN 软件。
4. 确认已经禁用了系统和网络适配器的省电选项（将系统设置为高性能模式）。
5. 不要在主机上安装 TeamViewer VPN 软件。
6. 安装 PortSIP PBX 的主机必须不是 DNS 或 DHCP 服务器。
7. 在防火墙打开如下端口：
UDP: 33000 – 65000、5078
TCP: 8800 – 8900、10080、10043
TCP：6459、5078、5079
8. 确保如下端口没有被其他程序占用
10
UDP: 33000 – 65000、5078
TCP: 8800 – 8900、10080、10043
TCP：6459、5078、5079
2.2.2 在 Linux 上安装 PortSIP PBX
升级安装
如果您已经安装了PortSIP PBX 9.4.2或者更高的版本，那么您只需用如下命令即可直接升级：
1. CentOS 和 RHEL
sudo rpm -Uvh portsip_pbx_
重要提示：在 CentOS/RHEL上，如果您从 9.4.2/9.4.3/9.4.5 升级到 9.4.6，那么需要在升级完之后，再执行如下命令：
sudo systemctl enable e
2. Ubuntu 和 Debian
sudo dpkg -I
portsip_pbx_
安装程序将自动将您当前的版本升级到最新版。
从 PortSIP 9.4.0 升级
PortSIP PBX 9.4.0 的产品名为“portpbx”。从 9.4.2 开始，PortSIP PBX Linux 已重命名为“portsip-pbx”。因此，如果您已经安装了 9.4.0 并且希望升级到更新版本，请按照以下步骤：
1. 卸载 9.4.0
a. CentOS/Redhat：sudo rpm -e portpbx
b. Debian/Ubuntu：sudo dpkg -P portpbx
2. 卸载完成后，手动删除以下文件夹：
sudo rm -r /var/lib/portpbx
sudo rm -r /opt/portsip/pbx
接下来您可按照以下描述的安装步骤安装更新版本。
11
全新安装
要在 Linux 上全新安装 PortSIP PBX，您仅需要执行以下命令，即可完成安装。
1. CentOS 和 RHEL
首先确认您的Linux已经安装了uuid, 如果还没有安装，请执行如下命令：
sudo yum install uuid
sudo rpm -ivh portsip_pbx_
2. Ubuntu 和 Debian
首先确认您的Linux已经安装了uuid, 如果还没有安装，请执行如下命令：
sudo apt-get install uuid
sudo dpkg -i portsip_pbx_
安装程序将检测 PortSIP PBX 的依赖关系，您需要根据提示信息安装全部所需的依赖关系。
成功安装后，PortSIP PBX 服务将自动启动，并将在每次启动服务器后自动运行。
如果需要卸载 PortSIP PBX，请执行如下命令：
CentOS 和 RHEL: sudo rpm -e portsip-pbx
Ubuntu 和 Debian: sudo dpkg -P portsip-pbx
要完整删除所有文件夹和文件，请在卸载后执行以下命令：
sudo rm -r /var/lib/portpbx
sudo rm -r /opt/portsip/pbx
注意：
1. 如果您收到类似“/usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.21' not found”的错误，即表示 gcc/g++ 版本过旧，您需要更新到最新的 gcc/g++。
2. 如果您收到以下错误：
.6 is needed by .x86_64
12
.6(GLIBC_2.0) is needed by .x86_64
.6(GLIBC_2.1) is needed by .x86_64
.6 is needed by .x86_64
.0 is needed by .x86_64
请执行如下命令：
1.
sudo yum list "compat-libstdc*"
2. 将输出以下内容：
Available Packages
compat-libstdc++-33.i686
compat-libstdc++-33.x86_64
3. 现在执行以下命令：
sudo yum install compat-libstdc++-33.i686
sudo yum install compat-libstdc++-33.x86_64
如果您收到以下错误：
.2 is needed by .x86_64
.1 is needed by .x86_64
请执行以下命令：
sudo yum install libxml2
sudo yum install libxml2-devel
sudo yum install zlib
sudo yum install zlib-devel
2.2.3 配置 Linux 防火墙规则
在成功安装了 PortSIP PBX 之后，必须对 Linux 防火墙进行设置，否则 PBX 将无法正常运行。
如果防火墙拦截了相关端口，必须打开如下端口以使得 PortSIP PBX 正常运行。
UDP 端口：33000-65000。这些端口用于RTP 传输媒体数据。
TCP 端口：6459、5078、5079、8800 – 8900、10080、10443。这些端口主要用于服务器控制和
WebRTC Gateway 传输。
UDP 端口：5060、5078。这是默认的 UDP 端口，用于传输 SIP 消息，发送和接收 SIP 信令。
如果以后在 PBX 里面增加了新的SIP传输协议，同时还需要在防火墙里面打开相对应的端口：
13
假如在 5063 端口上增加了 TLS 传输协议，必须在防火墙上打开 TCP 协议的 5063 端口。
假如在 5061 端口上增加了 TCP 传输协议，必须在防火墙上打开 TCP 协议的 5061 端口。
假如在 5065 端口上增加了 WS 传输协议，必须在防火墙上打开 TCP 协议的 5065 端口。
假如在 5067 端口上增加了 WSS 传输协议，必须在防火墙上打开 TCP 协议的 5067 端口。
假如在 5068 端口上增加了 UDP 传输协议，必须在防火墙上打开 UDP 协议的 5068 端口。
2.3 在 Windows 系统安装 PortSIP PBX
2.3.1 准备 Windows 主机
在安装 PortSIP PBX 之前，必须准备好一台安装了 Windows 的电脑/服务器，并进行如下操作：
1. 如果你要安装PBX的 Windows 电脑/服务器位于局域网里，必须分配一个静态的局域网 IP
地址；如果位于公网，必须得有一个公网静态IP。
2. 安装所有的 Windows 系统更新和补丁包，在安装更新和服务包的过程中您的电脑可能会重启多次，每次重启后可能要求安装更多的更新。安装期间，需要尤其注意安装所有有关
Microsoft .Net 的更新。完成后即可运行 PortSIP 的安装。
3. 避免让杀毒软件扫描 C:Program FilesPortSIP 目录，以免导致安装 PortSIP PBX 的过程过长以及写入访问延迟。
4. 不要在这台电脑上安装 VPN 软件。
5. 确认已经成功启动了Windows 防火墙服务。
6. 确认已经禁用了系统和网络适配器的省电选项（将系统设置为高性能模式）。
7. 不要安装 TeamViewer 之类的软件。
8. 如果您使用的是一台 Windows 桌面系统，请禁用蓝牙设备。
9. PortSIP PBX 不能和如下软件安装在同一台电脑上：DNS 或者DHCP 服务器、MS
SharePoint 或 Exchange 服务器。
10. 在你的防火墙里打开如下端口：
UDP: 33000 – 65000、5078
TCP: 8800 – 8900、10080、10043
TCP：6459、5078、5079
11. 需要确保如下端口没有被其他程序占用
UDP: 33000 – 65000、5078
TCP: 8800 – 8900、10080、10043
TCP：6459、5078、5079
12. 请确认Windows防火墙已经启用
14
2.3.2 在 Windows 上安装 PortSIP PBX
要安装 PortSIP PBX，您只需要双击安装程序文件，然后根据安装程序的提示进行安装。
PortSIP PBX 的系统服务将在安装成功完成后自动运行，以及在以后每次 Windows 启动后都将自动运行。
2.3.3 配置 Windows 防火墙规则
在成功安装了 PortSIP PBX 之后，必须对 Linux 防火墙进行设置，否则 PBX 将无法正常运行。
在 Windows 控制面板里打开 Windows 防火墙，点击“允许程序或者功能通过Windows防火墙”>“浏览”。
然后选择允许如下程序通过防火墙：
C:Program
C:Program
C:Program
C:Program
C:Program
C:Program
C:Program FilesPortSIPPBXbin
C:Program
C:Program
C:Program
如果防火墙拦截了相关端口，必须打开如下端口以使得 PortSIP PBX 正常运行。
UDP 端口：33000-65000。这些端口用于RTP 传输媒体数据，包括音视频包。
TCP 端口：6459、5078、5079、8800 – 8900、10080、10443。这些端口主要用于服务器控制和
WebRTC Gateway 传输。
UDP 端口：5060、5078。这是默认的 UDP 端口，用于传输 SIP 消息，发送和接收 SIP 信令。
如果以后在 PBX 里面增加了新的SIP传输协议，同时还需要在防火墙里面打开相对应的端口：
假如在 5063 端口上增加了 TLS 传输协议，必须在防火墙上打开 TCP 协议的 5063 端口。
15
假如在 5061 端口上增加了 TCP 传输协议，必须在防火墙上打开 TCP 协议的 5061 端口。
假如在 5065 端口上增加了 WS 传输协议，必须在防火墙上打开 TCP 协议的 5065 端口。
假如在 5067 端口上增加了 WSS 传输协议，必须在防火墙上打开 TCP 协议的 5067 端口。
假如在 5068 端口上增加了 UDP 传输协议，必须在防火墙上打开 UDP 协议的 5068 端口。
重要提示：如果您是在 AWS 等云平台上运行 PBX，并且云平台具有自己的防火墙，您还必须在云平台防火墙上打开这些端口。
2.4 规避 HTTPS 证书安全警告信息
PortSIP PBX 在 8888 端口监听并提供 HTTP 服务。
假定将PortSIP PBX安装在 IP 地址为 172.217.14.16 的服务器上，那么您可以使用
172.217.14.16:8888 来访问 PortSIP PBX的WEB 管理界面。注意：推荐使用 Chrome 和
Firefox 浏览器，请勿使用 IE 浏览器。
PortSIP PBX 在 8887 端口监听并提供 HTTPS 服务。假定将PortSIP PBX安装在 IP 地址为
172.217.14.16 的服务器上，那么您可以使用 172.217.14.16:8887 来访问 PortSIP PBX的WEB 管理界面。
注意： 推荐使用Chrome 或者 Firefox 浏览器访问管理界面，不能使用IE浏览器。
默认情况下，HTTPS 使用自签名的 SSL 证书，将导致浏览器弹出 SSL 证书安全警告信息。
要避免 SSL 证书警告信息，您需要购买签名的证书（由可信任的证书机构发放的授权证书），替换自签名证书。要执行该操作，请遵循以下步骤：
1. 联系 Thawte 或者 Versign 或其他证书提供商，购买 SSL 证书。将私有密钥保存为
。
2. 在获取到 SSL 证书后，将其重命名为 。
3. 在 Linux 上，将 和 复制到 PortSIP PBX 安装路径
(/opt/portsip/pbx/bin) 以替换现有 和 。
4. 在 Windows 上，将 和 复制到PortSIP PBX 安装路径 (C:/Program
Files/PortSIP/PBX/bin)，替换现有 和 。
5. 登录到 :8887，访问 PBX 管理控制台。
注意：您还可以从 Let’s Encrypt 免费获取 SSL 证书。
16
3. 配置部署 PortSIP PBX
3.1 PortSIP PBX 的架构
图1：PortSIP PBX 在局域网里的典型架构
如图 1 所示，PBX 运行在局域网时，分机用户从局域网注册到 PBX，然后分机用户之间可以互相进行呼叫。同时，分机用户通过 PBX 所配置的 VoIP 运营商或者 SIP 中继，可以与传统的
PSTN 网络的固定电话以及手机（中国移动、电信、联通）进行通话。
17
图2： PortSIP PBX 在 Internet 上的典型架构
如图 2 所示，PortSIP PBX 部署在 Internet 上面，拥有一个公网 IP 或者域名。分机用户可以从公网或者局域网注册到 PBX，并与其他的分机用户之间进行音视频通话。同时，分机用户通过
PBX 所配置的 VoIP 运营商或者 SIP 中继，可以与传统的 PSTN 网络的固定电话以及手机（中国移动、电信、联通）进行通话。
18
图3：PortSIP PBX 在互联网上的大规模高扩展部署
如图3所示，PortSIP PBX 的 Call Manager 服务器部署在单独的服务器上，媒体服务器、会议服务器、WebRTC网关、语音邮件服务器、虚拟接待服务器、呼叫队列服务器以及 Music On
Hold 服务器分别部署在多台单独的服务器上，这些服务器之间组成一个集群。
SIP 客户端注册到 PortSIP PBX 的 Call Manager 服务器并进行呼叫，呼叫建立后，所有媒体流的 RTP 包以及音频视频会议、语音邮件等处理都将分别由不同的服务器进行处理，
采用集群方式部署的 PortSIP PBX 系统，可以轻松地支撑 10,000 路以上的并发呼叫通话，并且可以随着服务器数量地增加支持更多。
19
3.2 PortSIP PBX 的部署模式
PortSIP PBX 支持多种方式部署以适应不同的应用场景。支持在局域网或者 Internet 上的部署，支持各种虚拟化平台，支持多种主流云平台比如 AZURE、AWS、阿里云、UCloud、Linode，
Digital Ocean、腾讯云等。
PortSIP PBX 成功安装后，只需要简单地点击几下鼠标就能够完成必要的设置，让 PortSIP PBX
正常运行。
运行 PortSIP PBX 配置向导
PortSIP PBX 提供的设置向导将指引你完成几项必须的设置，让系统运行起来。
PortSIP PBX 侦听 8888 端口并提供 HTTP 服务，并侦听 8887 端口以提供 HTTPS 服务。更多信息请参阅 2.4 节。
1. 在浏览器中打开 pbxserverip:8888，访问 PBX 管理控制台。
2. 输入管理员用户名和密码（默认为 admin/admin），然后点击“登录”按钮。注意：用户名和密码均区分大小写，请注意核对。输入正确的用户名和密码并成功登录之后，系统将会自动弹出配置向导，您只需要根据向导的指引逐步完成配置。
如果要修改 admin 的默认密码，请在登录管理控制台之后，点击左侧菜单“用户资料”>“常规”进行修改。
模式 1: 在局域网里部署 PortSIP PBX
假定我们需要将 PortSIP PBX 部署在一个局域网里，整个局域网通过路由器和 Internet 连接，安装 PortSIP PBX 的服务器 IP 地址是 192.168.0.28。同时在 PBX 里配置了 VoIP 运营商或者 SIP
中继，使得局域网里注册到 PBX 系统上的的分机用户不仅可以互相呼叫，还能通过配置好的
VoIP 运营商或者 SIP 中继与传统 PSTN 网络里的固定电话和手机进行呼叫通话。
20
第一步：登录 PortSIP PBX 的管理控制台，在弹出的配置向导的第一步，选择PBX运行在局域网，并在下面的输入框输入 PBX 的所在的服务器的局域网 IP地址：192.168.0.28。PBX 支持 IPv4 或 IPv6 地址，在此示例中，我们使用 IPv4 地址。
注意：在这里，不能输入回路接口 IP 127.0.0.1，必须输入 PBX 所在服务器的正确局域网静态IP（不能使 DHCP 动态 IP）。必须确保你的 IP 电话机或者其他的 SIP 客户端与 PBX 服务器之间的网络通畅。
此处输入的 IP 地址就是 PBX 的 SIP 服务器地址，在 SIP 客户端或者 SIP IP 电话注册到 PortSIP
PBX 的时候，需要输入该地址。
21
第二步：现在需要输入要使用的 SIP 域名，通常是完全限定域名（FQDN）。如果没有 FQDN，也可以仅使用 PBX 服务器的 IP 地址（在本例中为 192.168.0.28）来做为 SIP 域名。SIP 域名仅用作 SIP 消息认证，不要求必须能解析。
设置 SIP 域名之后，所有的分机用户的 SIP 账号地址都是如下形式：
sip:xxx@domain
假如我们设置的 SIP 域名是 并创建了一个分机用户 101，那么 101 的 SIP 地址就是sip:***************如果您不希望使用域名，请输入安装了 PortSIP PBX 的计算机/服务器的私有 IP（例如
192.168.0.28），用于替代域名 (FQDN)。在此情况下分机 101 的 SIP 地址就是
sip:***********.0.28。
22
第三步：设置SIP消息的传输协议。系统默认设置 SIP 传输协议是 UDP 协议，绑定监听在
5060 端口。
注意：如果想要设置更多的SIP传输协议，可以在向导完成进入管理控制台后进行。
23
第四步：设置邮箱服务器。用户可以在该步骤设置电子邮件服务器，用于接收系统通知、语音信息、会议邀请及下载的文件等。PortSIP PBX 支持用户 SMTP 服务器或 Gmail SMTP 服务器。
注意：该步不是必填项，您可以根据需要进行设置。
点击“保存”按钮，就完成了 PortSIP PBX 的基本设置。然后，系统会自动跳转到管理控制台界面。
24
模式2: 在亚马逊的云平台AWS 上部署 PortSIP PBX
亚马逊的云服务 AWS 是时下比较流行的云平台。我们可以简单地把 PortSIP PBX 部署在 AWS
上。
将 PortSIP PBX 部署在 AWS 上，分机用户可以通过 internet 上的 PortSIP PBX 进行呼叫通信，并通过配置的 VoIP 运营商或者和 SIP 中继与传统 PSTN 网络上的固定电话、手机进行呼叫通话。
如果你还没有亚马逊的 AWS 账号，请阅读 Creating an AWS account 并创建一个 AWS 账号。
第一步：在 AWS 的 EC2 管理界面左边的菜单里，选择“弹性 IP 地址”（Elastic IP），然后就可以看到“弹性 IP”(Elastic IP)并将它记录下来供后面使用。
如果没有看到弹性 IP，请点击左边的菜单列表里的“分配新地址”（Allocate New Address）来给你的 EC2 实例分配一个弹性 IP。
25
第二步：登录 PortSIP PBX 的管理控制台，在弹出的配置向导的第一步，选择在公网上运行
PBX，然后输入记录下来的 AWS 的弹性 IP 地址。
在这里输入的 IP 地址，就是 PBX 的 SIP 服务器的地址，在将 SIP 客户端或者 SIP IP 电话注册到 PortSIP PBX 的时候，需要输入该地址。
剩下的步骤，和模式一里面一样。
模式三: 在阿里云上部署 PortSIP PBX
阿里云是目前国内比较流行的云平台，PortSIP PBX 支持在阿里云上部署。
第一步：登录到阿里云的管理控制台，打开云服务器 ECS 实例，记录下云服务器的公网 IP，比如 120.25.246.106.
26
第二步：登录 PortSIP PBX 的管理控制台，在弹出的配置向导的第一步，选择在公网上运行
PBX，然后输入记录下来的阿里云服务器 ECS 的公网 IP。
在这里输入的 IP 地址，就是 PBX 的 SIP 服务器的地址，在 SIP 客户端或者 SIP IP 电话注册到
PortSIP PBX的时候，需要输入该地址。
剩下的步骤，和模式一里面一样。
在其他应用场景安装部署 PortSIP PBX
如果要在上述没有提及的场景部署 PortSIP PBX，只需要将 PBX 安装在公网上还是局域网，并记住公网 IP 或者局域网 IP 地址，然后在配置向导的第一步选择正确的网络环境并输入相应的
IP 地址。
27
4. 配置管理PortSIP PBX
跟随配置向导的指引完成初始配置之后，接下来就可以在管理控制台里面对PortSIP PBX 进行配置管理。
4.1 服务状态
服务状态
可以在“概要”> “服务状态” 里面可以查看各项服务是否正常启动。 用户可以选中一项已停止/启动的服务，单击“启动”/“停止”按钮将其启动/停止。
在停止某项服务后，还可以单击“启动”按钮来启动该服务。也可以用“重新启动”按钮来对某项正在运行的服务进行重启。
如果同时存在多项服务处于运行状态，用户可以单击“全部重启”按钮将所有服务全部重新启动。
此外，服务状态的显示可能存在延迟，用户可以单击“刷新”按钮查看最新服务状态。
28
系统分机
PortSIP PBX 将PBX所使用的虚拟接待、会议、传真、呼叫队列、Music On Hold等服务用到的分机号码识别成为系统分机，这些系统分机号码只能被PBX本身所使用。你可以在“通话管理”>“系统分机状态”里面查看各项系统服务是否正常注册到了 PBX。
4.2 话机配置
话机自动配置介绍
PortSIP PBX 系统安装完成后，您可以配置您的 IP 话机，为每台话机分配一个分机号。您可以选择通过话机网络页面手动逐个配置，该方法花费时间较多，且容易出错；此外您还可以使用
PortSIP PBX 提供的话机配置功能，集中远程管理话机，无须逐个登录话机的网络页面。使用话机配置功能，您可以允许话机从 PortSIP PBX 检索配置。
29
话机配置可从 PortSIP PBX 管理控制台集中执行更改分机密码、BLF等操作，并将更改推送到所有话机，极大地简化了 IP 话机的日常管理。支持以下配置方法：
⚫ 即插即用 – 支持的 IP 话机可使用即插即用功能，自动配置（适用于本地局域网的话机）
⚫ 通过手动配置 URL – 可将配置 URL 输入至话机的 web 页面，以此配置支持的 IP 话机（适用于本地、远程和 SBC 分机）
⚫ 通过 DHCP 选项 66 – 旧有话机（从先前 PBX 安装版本配置，例如 Polycom、Cisco 或
Aastra）可通过 DHCP 配置，仅限在本地局域网使用。存在部分限制。
您可在此处查看支持的话机列表。只需多花半个小时配置话机，为未来节省无数精力！
使用即插即用功能配置话机（本地局域网）
注意：即插即用配置要求 PortSIP PBX 在默认 SIP 端口 5060 上运行，并且 IP 话机位于 PortSIP
所在的同一本地局域网子网。
要使用即插即用功能自动配置话机：
1. 将话机插入至网络。
2. 话机将在局域网络发送一条多点传播信息。该信息将由 PortSIP PBX 捡起。
30
3. 话机作为新话机显示在 PortSIP PBX 管理控制台的“话机”页签。
4. 将话机指定给现有分机，或为其新建分机。
5. 转至分机的“话机配置”标签页，为话机指定其他配置设置。
6. 为话机选择“话机显示语言”和“时区”。
7. 单击“确定”。
8. 系统将向话机发送一条配置文件的链接，其中包含您指定的设置，可使用该配置文件自行配置话机。
9. 话机将应用这些设置，然后连接至 PortSIP PBX。现在您可以从 PortSIP PBX 管理控制台管理 IP 话机。
10.
直接使用话机配置链接配置话机
未与 PortSIP PBX 位于同一局域网的远程话机必须通过话机配置链接进行配置。要配置远程话机：
1. 在 PortSIP PBX 管理控制台的“话机”页签选择“添加话机”。
2. 选择话机所要使用的分机。
3. 输入话机的 Mac 地址，可在话机底部找到。
4. 从下拉菜单选择对应的话机型号。
5. 为话机选择“话机显示语言”和“时区”。
6. 复制配置链接。
7. 将配置链接手动插入话机，链接可在分机配置的“话机配置”页签找到。
31
配置旧话机：Cisco、Polycom 和 Aastra
Cisco、Polycom 和 Aastra 话机使用 Let’s encrypt Root CA 证书或自签名证书，不支持即插即用或安全 HTTPS 配置。他们仅可在本地局域网上使用，必须按以下方式进行配置：
1. 下载已经博瞻信息使用旧有话机测试过的固件。
2. 将话机恢复出厂设置，确保没有可能与新配置冲突的旧设置。请参考话机的用户手册了解更多信息。在此查看如何为 Aastra、Cisco、Cisco SPA 和 Polycom SoundPoint / SoundStation
恢复出厂设置。
3. 现在将话机添加到分机。您可以从管理控制台的话机界面执行该操作，或直接转至分机的话机配置页签，点击“添加话机”。
4. 选择话机型号。
5. 输入话机 Mac 地址，您将转至话机配置页面。
6. 为话机选择“话机显示语言”和“时区”。
7. 将“话机网页密码”字段保留为默认值。
8. 单击“确定”以将话机添加到分机。
9. 注意：请记录下“自动话机配置”页签的配置链接。
32
现在配置话机，以从 PortSIP 配置文件夹检索配置。使用 DHCP 选项 66 或通过话机的网页界面使用 PortSIP 配置链接手动配置话机。Cisco 7940/7960 必须使用 TETP 和 DHCP 选项 66 进行配置。
旧版话机逐步设置指南：
•
•
•
•
配置 Polycom IP 话机
配置Cisco 7940/ 7941/ 7960 /7961 话机
配置 Cisco SPA 302, 303,501G, 502G, 504G, 508G, 509G, 525G/G2
配置 Aastra 6730i, 6731i, 6739i, 6751i, 6753i, 6755i, 6757i
其他参考
正在使用远程话机？请阅读配置远程话机指南。
使用通过 DHCP 66 配置 IP 话机，为旧版话机配置话机配置 URL。
查看 PortSIP PBX 支持的 IP 话机列表。
设置 TFTP 服务器以进行固件升级。
为 Aastra、Cisco、Cisco SPA、Gigaset、Panasonic、Polycom SoundPoint、Polycom
Soundstation、Yealink 恢复出厂设置
4.3 话机管理
PortSIP PBX 可让您通过网络轻松监测和管理话机和软电话。通过 PortSIP PBX 管理控制台的“话机”页签，您可以执行以下操作：
⚫ 查看网络中的所有话机，包括 IP 和 MAC 网络。
⚫ 查看连接的所有处于软电话模式的 PortSIP 客户端。
⚫ 检查话机运行的固件版本。
⚫ 远程重启一台或多台话机。
⚫ 重新配置话机
⚫ 启动话机管理界面
⚫ 监测分机密码和 PIN 码。分机密码和 PIN 码太弱可能导致大部分安全漏洞。
33
添加话机
您可以通过以下方式向 PortSIP PBX 添加话机：
⚫ 即插即用 – 插入本地局域网的话机
⚫ 通过 MAC 添加 – 用于旧话机
即插即用（局域网和 SBC）
如果连接的话机和 PortSIP PBX 位于同一局域网内，您将看到该话机出现在话机页面上，且其名称显示为粗体。这表示 PortSIP PBX 在网络上检测到了新的话机，您需要进行处理。
选择话机，并决定如下操作：
1. 将话机指定给现有分机。单击“指定分机”。系统将提示您分机号码。
2. 为话机创建现有分机。单击“添加分机”按钮。您将被指向创建分机页面，系统将提示您填写分机名和号码。单击“确定”创建分机。
3. 拒绝话机。如果话机看起来比较陌生，或其尚未授权供 PortSIP PBX 使用，您可以“拒绝”以删除话机配置请求。
配置远程分机
如果您需要添加远程安装的话机，也即位于远程网络的话机，您必须执行以下操作：
1. 在“话机”页签单击“添加话机”按钮。
2. 选择要应用此话机的分机。
3. 选择话机型号。
4. 输入设备 MAC 地址，然后单击“确定”。
5. 您还可以选择为话机配置其他设置。
6. 完成后，单击“保存”以将话机添加至分机。
7. 复制配置链接，将其手动插入至您的 IP 话机。
通过 MAC 添加 – 用于旧话机
您可以通过以下方式，添加不支持即插即用的老旧话机：
1. 在“话机”页签单击“添加话机”按钮。
2. 选择要应用此话机的分机。
34
3. 选择话机型号。
4. 输入设备 MAC 地址，然后单击“确定”。
5. 您将跳转到分机的话机配置页面
6. 您还可以选择为话机配置其他设置。
7. 完成后，单击“保存”以将话机添加至分机。
8. 配置 DHCP 服务器以供配置 URL 使用，或从话机 Web 界面配置 URL。
访问话机 UI
PortSIP PBX 让您能够轻松访问已配置话机的使用密码保护的 Web 界面。PortSIP PBX 会为其配置用户名和独特密码，并管理您的凭证。要访问话机 UI，请执行以下操作：
1. 选择话机，然后单击“话机 UI”。
⚫ 对于大部分话机，您将自定跳转至话机 UI 页面。
⚫ 对于部分老旧话机，您可能需要输入话机的密码。在此情况下，单击“密码”按钮以显示密码，并复制密码为该话机配置的密码，将其粘贴到话机认证页面。
更改话机设置
通过“话机”部分“通用”页签或“设置”部分的“话机自动配置”页签对某话机的话机配置进行的更改将于 24 小时内生性。您可以重新配置话机以使其马上应用新的配置。如果您需要重新配置话机，例如在您进行配置更改后，请执行如下操作：
1. 选择要重新配置的话机。
2. 单击“重新配置”。
3. 如果需要重启话机，将会自动执行。此后无需再次重启话机。
4.4 分机用户管理
本节指导您如何在 PortSIP PBX 的管理控制台里创建以及管理分机用户。PortSIP PBX 支持以多种方式创建分机用户：
● 当提供一个新的 IP 电话的时候，可以选择创建一个新的分机用户
● 在“通话管理”>“分机用户”菜单里点击“新建分机用户”手动创建一个分机用户
● 可以从 CSV 文件批量导入分机用户，其中包含 DID 等参数信息
35
● 通过调用 REST API 创建分机
在 PBX 管理控制台里，点击左边的“通话管理”>“分机用户”，然后点击“新建分机用户”就可以创建新的分机，或者选中已有的分机用户，单击右边的“编辑”图标可以对已经存在的分机用户进行配置管理。其中“Web访问密码”在分机用户登录WEB管理控制台的时候使用。
常规
在“常规”选项卡，可以输入要创建的分机号码、密码、用户名、性别以及电子邮箱地址。其中分机号码和密码是必填项，可以是纯数字也可以是英文字符。成功创建分机用户后，PBX 系统将会自动发送一封欢迎邮件到分机用户的邮箱。
字段“Web 访问密码”用于供分机用户登录到管理控制台。
语音邮件
在“语音信箱”选项卡里，可以设置分机用户的语音邮件选项，包括收听语音邮件时候的密码，启用或者禁用语音邮件，启用或者禁用收到语音邮件时候的认证，以及是否让PortSIP PBX系统在你收听语音邮件的时候播放呼叫者的ID、分机号码以及时间和日期。
在分机用户创建成功之后，可以在“语音信箱”选项卡的“语音信箱问候语”部分对语音信箱的问候语音文件进行管理。
点击“浏览”按钮以上传新的 wav 格式的问候语文件。上传成功后，点击锁定图表来将文件指定为语音信箱的问候语。
36
呼叫转发规则
每一个分机用户都可以设置一系列的来电转发规则让 PortSIP PBX 在分机用户无法接听的时候，按照设置的规则来转发呼叫。这些转移规则基于如下几个因素：
● 分机用户当前的状态，比如在线或者离线、忙碌或离开。
● 当前的时间
对于分机用户的每一个状态都可以设置一个来电转移规则。例如，如果分机当前状态是在线，但是忙碌，那么可以将这个呼叫转发给语音邮箱。同时，也可以设置当前时间如果是非工作时间，将呼叫转移到手机等外部号码 (external number)。注意，将呼叫转移到手机等外部号码需要配置相应的 VoIP运营商/SIP 中继，并设置相应的外拨规则。
选项
在“选项”选项卡里，可以设置或者限制分机用户的一些功能。
● 通话录音 – 如果选中了该选项，这个分机用户的所有通话都将被录制为 .wav 文件。
● 视频录制 – 如果选中了该选项，该分机用户的所有视频通话都将录制为 AVI 文件。
● 外呼方主叫方 ID – 可以在这里设置分机用户的外呼主叫 ID，这样在该分级用户通过某个运营商/SIP中继进行外呼通话后，可以指定用外呼主 ID 来替代某个指定的 SIP 字段，详情请查阅 4.7节。
● 已启用– 如果未选中该选项，分机用户将被禁用。
● 允许使用传呼/对讲功能 – 如果选中了该选项，分机用户可以发起传呼/对讲。
● 允许呼叫外部号码 – 如果选中了该选项，分机用户可以通过已经配置的 VoIP 运营商/SIP 中继呼叫外部号码（包括手机和固定电话）。
● 允许登录管理控制台 – 如果选中了该选项，分机用户可以登录到 PBX 的管理控制台。
工作时间
工作时间功能允许指定分机用户的上班时间，分机用户可以根据工作时间来设置相应的来电转移规则以将来电转移给不同的号码。
可以选择让分机用户使用 PBX 的全局上班时间设置，也可以选择让分机用使用自己定义的上班时间。点击选择使用指定的上班时间后，在下面的输入框里选好时间并点击向左或向右按钮来设置。设置完成后，点击“确定”按钮以使设置生效。
37
话机配置
您可以通过话机配置页签为此分机添加话机或编辑其话机设置。可在“话机配置”查看如何管理
IP 话机设置。
BLF
您可在此页签为 IP 话机配置 BLF 灯。将分机与 BLF 按钮匹配，以使该按钮显示分机状态。各话机的可用 BLF 按钮数可能不同。
BLF 提供以下可用选项：
•
•
•
•
BLF – 显示其他分机用户的在线状态。
快速拨号 – 链接到一个电话号码，让您轻松快捷发起呼叫。
自定义快速拨号。
更改状态。
计费
管理员/租户可以为分机用户设置余额。在启用计费的情况下，余额不足会导致通话失败（请参阅 13.1 节）。
个人资料
在用户资料的选项卡里，可以设置分机用户的个人资料。其中公司名和公司网址是不能修改的，所有由 admin 用户创建的分机用户的公司名和公司网址都沿用 admin 的公司名和公司网址。
4.5 分机组
在通话管理下的“分机组”菜单里，可以对分机用户进行分组管理，通过分机组区分用户和管理员，并确定要对各分机显示何种信息。PortSIP PBX 系统有一个默认组，通常命名为 Default，默认组不能被删除和修改。 每一个分机用户至少属于一个组。当一个分机用户被创建之后，自动归属于系统默认组。
分机用户可以在加入某个分机组之后被赋予各种权限，PortSIP PBX对分机用户的权限管理是基于分机组来进行的。当某个分机组被赋予某项权限之后，这个分机组的所有组员自动拥有该项权限。分机用户加入某个分机组后，可以查看组内其他成员的信息，分机组管理员的权限高于组内38
其他分机用户的权限。系统会根据组成员关系分配权限，群管理员可以查看其组内任何成员的呼叫详细信息，包括接入及外拨呼叫。
创建分机组
在管理控制台左边的菜单，选择 通话管理 > 分机组 菜单，然后点击“新增”，在组信息选项卡输入组名以及描述信息，并选择需要设置的组权限。
点击组成员选项卡，你可以将已存在的分机用户添加进分机组，然后点击确定按钮，分机组将被创建。
当一个分机组被授予“允许访问管理控制台”权限后，所有的属于这个分机组的分机用户都可以登录 PortSIP PBX 管理控制台。假如 101 分机用户密码是 101，admin 在 PBX 系统设置的SIP
域名是 ，101 分机用户属于系统默认组，该组被赋予了系统管理控制台的登录权限，那么 101 分机用户可以以如下方式登录：
用户名：***************
密码：101分机用户的 Web 登录密码
分机用户可以同时属于不同的用户组，并拥有这些分机组权限的合集。
4.6 SIP 域名和传输协议管理
SIP 域名管理
在 PBX 里设置 SIP 域名之后，SIP 客户端注册到 PBX时所使用的 SIP 地址里的域名必须和
PBX 里设置的 SIP 域名相同。同时，当其他分机用户呼叫你的时候，也必须使用 SIP 域名做为你的 SIP 地址的一部分，否则你将无法收到呼叫。SIP 域名可以是一个 FQDN，也可以是一个 IP 地址。比如 或者 192.168.0.28。
39
SIP 域名是在你第一次登录管理控制台时显示的 PBX 配置向导第二步设置的。如果你要修改
SIP 域名，请点击管理控制台左侧的菜单“通话管理”>“域名和传输协议”。然后点击“编辑”按钮输入新的 SIP 域名并保存。
SIP 传输协议管理
PortSIP PBX 支持所有的主流传输协议来收发 SIP 消息，包括UDP、TCP、TLS、WS
(WebSocket) 和 WSS (WebSocket Security)，你必须设置至少一个传输协议以便 PBX 正常接收和发送来自客户端的 SIP 消息。
默认的传输协议是在你第一次登录管理控制台时显示的 PBX 配置向导的第三步设置的。如果你要修改传输协议，请点击管理控制台左侧的菜单“通话管理 ”>“域名和传输协议”。然后在“传输协议”部分点击“新增”按钮。在增加新的传输协议之前，你必须先成功设置 SIP 域名。
注意：SIP传输协议只有admin用户才有权创建和删除，并且需要保留至少一个传输协议。
40
增加 UDP/TCP/WS 传输协议
增加 UDP/TCP/WS 传输协议的步骤如下：
1. 点击“新增”按钮，然后在增加传输协议的窗口里，在协议的下拉框里选择 UDP、TCP
或者 WS，UDP/TCP/WS 传输协议的默认端口分别为 5060/5063/5062，你也可以使用其他的端口。你需要确保你所使用的端口没有被其他程序所占用。
2. 点击确定按钮即可成功增加新的传输协议。
增加TLS/WSS 传输协议
增加自签名证书的 TLS/WSS 传输协议之前，具体步骤如下：
在增加 TLS/WSS 传输协议的时候，必须提供相关的 SSL 证书。
1 如果没有从第三方证书机构购买证书，那么你需要生成自签名证书。请从博瞻信息的网站下载证书生成工具并运行（或者运行 PBX 安装目录下的 ），输入你的公司名称（英文或者拼音），以及给PBX设置的 SIP 域名，然后点击“生成”按钮，证书工具将生成自签名证书。
2 生成的证书包括如下三个文件（假设你的 SIP 域名是 ）：
domain_key_
domain_cert_
root_cert_
如果你从第三方证书证书提供商（比如Thawte、versign）处购买了证书，那么请按照如下步骤（假设为 购买证书）：
a) 根据证书提供商的指示生成 CSR 文件和私有证书文件并保存。如果你在生成私有证书的时候设置了密码，请记录下来。
b) 将私有证书文件重命名为 domain_key_。
c) 将 CSR 提交给证书提供商，在你的证书申请被通过之后，请从证书提供商处下载你的证书文件，证书文件通常有两个：Intermediate CA 证书 和 SSL 证书.
d) 用一个纯文本编辑器（不能用WORD）分别打开 Intermediate CA 证书 和 SSL 证书，然后将 Intermediate CA 证书的全部内容复制后粘贴在 SSL 证书内容的后面，将合并后的 SSL 证书文件另存为 domain_cert_。
e) 从你的证书提供商处下载根证书文件并保存为 root_cert_。
41
3 点击“新增”按钮，然后在增加传输协议的窗口里，在协议下拉框里选择 TLS 或者 WSS，TLS/WSS 传输协议的默认端口分别为 5063/5065。您也可以使用其他的端口，需要确保你所使用的端口没有被其他程序所占用。
4 点击证书文件后面的“上传”按钮选择域名证书文件，即以 domain_cert_ 开头的 pem 文件：为“证书文件”选择“domain_cert_”，为“私钥文件”选择“domain_key_”，为“根证书文件”选择“root_cert_”。
5 输入私钥文件密码，用博瞻信息公司证书工具生成的证书没有密码，这里不需要输入，保持为空；如果你是从第三方证书提供商那里购买的证书并且在生成私有证书的时候设置了密码，请在这里输入你设置给私有证书的密码，如果没有设置就保持为空。
6 点击“确定”按钮，完成设置。
为新添加的传输协议设置防火墙
在成功添加新的传输协议之后，必须更改防火墙规则来允许新增的传输协议进行网络通信。假设在 PortSIP PBX 里面增加了如下的传输协议：
UDP: 5060
TCP: 5061
TLS: 5063
WS: 5064
WSS: 5065
那么必须在防火墙规则里允许如下协议和端口：
UDP: 5060 from IP: 0.0.0.0(anywhere)
42
TCP: 5061 from IP: 0.0.0.0(anywhere)
TLS: 5063 from IP: 0.0.0.0(anywhere)
TCP: 5064 from IP: 0.0.0.0(anywhere)
TCP: 5065 from IP: 0.0.0.0(anywhere)
4.7 配置 VoIP 运营商以及 SIP 中继
VoIP 运营商通过 IP 传送语音，取代了传统电话网。VoIP运营商可以在一个或多个城市分配本地号码，并将其传送至电话系统，并且大多支持号码转携。
VoIP运营商或者 SIP 中继运营商采用互联网来传送语音和视频数据。因此，可以以更优惠的费率提供和传统的PSTN电信运营商一样的电话服务，特别是在国际长途通话中，费率远远低于传统的电话服务。因此，使用VoIP运营商或者SIP中继可以大幅度降低企业的通信成本。
博瞻信息推荐使用PortSIP PBX支持的 VoIP运营商/SIP 中继，所有支持的运营商和 SIP 中继都经过了严格测试，可以和 PortSIP PBX 很好地工作在一起。PortSIP PBX 提供的设置向导可以让你简单快速地配置你的 VoIP运营商和 SIP 中继。
PortSIP PBX 支持如下两种 VoIP运营商：
● 基于注册认证 – 此类服务运营商要求 PortSIP PBX 使用认证 ID 和密码注册到运营商的服务器，其中大部分已在 PortSIP 预定义。
● 基于IP 认证 – 基于IP认证的VoIP运营商/SIP中继不要求PBX注册到运营商的服务器，而是根据PBX的IP地址来进行认证以设置拨出通话时的接通目标。
配置 VoIP运营商/SIP 中继
第一步：需要在VoIP运营商处注册申请一个账号。PortSIP PBX 支持市场上绝大多数主流的VoIP运营商/ SIP 中继。我们推荐使用经过我们兼容性测试的服务运营商，在 PortSIP PBX 的
VoIP运营商配置向导里已经预置了这些服务运营商的配置参数。
43
在 VoIP运营商处申请账号之后，需要在 PortSIP PBX 里配置账号：
1 登录到 PortSIP PBX 的 管理控制台，在左侧菜单依次选择“通话管理”>“ VoIP运营商/SIP中继”>“新增”。
2 为这个服务运营商输入一个便于记忆辨认的名字。
3 选择服务运营商所在国家，或者选择“Generic”以输入没有列出的运营商。
4 在运营商的下拉列表选择运营商。如果你的服务运营商不在列表里，请在上面的国家下拉列表里选择“Generic”。
5 选择一个运营商后，该运营商的服务器IP地址和端口以及其他的一些参数会被自动填写。请将这些信息和参数与你从 VoIP运营商处收到的参数进行核对。基于你选择的运营商，有些参数输入框已经被禁用，意味着你不需要填写这些参数。点击“下一步”继续。
注：对于选择的Generic VoIP运营商，你需要自己填写服务器等参数，详情请询问你的运营商。
6 如果你的运营商不需要注册，是基于IP地址认证，请不要勾选“该VoIP运营商要求注册”。
7 如果运营商是你自己配置的运行于和PBX同一个局域网的E1网关或者其他的PBX/SIP服务器，请勾选“运营商位于PBX所在的局域网”。
8 如果您希望允许所有租户使用此提供商/中继，请选中“对所有租户可用”。
44
9 输入你在 VoIP运营商处申请的账号和密码，指定运营商允许的最大并发呼叫数据，仔细核对，然后点“确定“按钮完成配置。
在左侧菜单依次点击“通话管理”>“VoIP 运营商/SIP 中继”，你可以看到所有已经配置的VoIP运营商。
完成对运营商的设置后，用户还可以点击“通话管理”>“VoIP 运营商/SIP 中继”>“编辑”按钮，编辑运营商的外呼/接入参数。
●
在“外呼参数”页签，用户可以设置一些规则对发往VoIP运营商/SIP中继的INVITE消息的各个头域的值进行修改。比如将“to”头域的“user”的值设置为发起该呼叫的分机用户的“外呼主叫方ID”。
●
在“呼入参数”页签，用户可以设置规则对呼入的SIP消息各个头域的字段值进行修改。
注意：外呼/呼入参数属于高级选项，推荐使用系统默认值。配置该信息需要了解 SIP 知识，配置出错可能导致 PBX 运行异常。
4.8 配置接入规则和外拨规则
接入和外拨规则决定 PortSIP PBX 如何根据一些特定的规则来转发路由呼叫。比如，你可以配置一些规则用来控制哪些呼叫需要通过哪个 VoIP运营商/SIP 中继来进行以实现最低的费用。
你也可以基于 DID 号码来创建接入规则以让外部的呼叫直接转发给分机用户，而不用通过 IVR
或者虚拟接待来转接。
创建接入规则
很多公司都给用户或者部门提供直拨号码 (DID) 以便于可以直接呼叫到用户而不用通过转接。在英国 DID 又称为 DDI，在德国则称为 MSN 号码。虽然你在公司可以使用虚拟接待来自动应答呼叫，但是使用 DID 直拨号码是更常见的选择，因为他更简单便捷。
用户可以很容易地在“通话管理”>“接入规则”这里配置 DID 直拨号码。DID 号码是 VoIP 运营商/SIP 中继或者电话公司提供分配给你的电话线路的虚拟号码，通常是分配一定范围内的一系列号码。具体详情请咨询你的电话公司或者 VoIP 运营商。
在创建接入规则之前，您至少应该配置一个 VoIP 运营商或者 SIP 中继。创建接入规则的步骤如下：
1. 在 PortSIP PBX 的管理控制台里，选择“通话管理”>“接入规则”>“新建“。
45
2. 在“接入规则”的界面，输入一个容易理解记忆的接入规则名称，然后在类型的下拉列表里，选择 DID 或者 CID。
3. 在 DID/DDI 号码/掩码的输入框，输入应用于本条接入规则的 DID 号码，该号码将用作主要或首要 DID 号码。当收到外部呼叫的时候，PortSIP PBX 会将该 DID 号码/掩码和 SIP 消息里的”to”字段进行匹配，并以此来决定如何转发该呼叫。
你可以指定精确匹配某个号码，或者使用通配符来进行粗略匹配。例如，如果你的 DID 号码是 2345，那么如下掩码将会被匹配到到你的接入规则。
2345
*
*345 or *45 or *5
2* or 23* or 234*
*2* or *23* or *234*
1-2346
（因为2345在 1 – 2346范围内）
4. 如果你在类型下拉列表里选择的是“CID”，PortSIP PBX 系统将会根据收到的呼叫消息的”from”字段进行匹配。比如，当你选择接入规则类型是 CID，并指定掩码是 2345，那么来自 2345 号码的呼叫将会被匹配上该接入规则，和 DID 类型一样，CID 的规则也支持通配符。
5. 选择要与此 DID 关联的提供商/SIP 中继。一个 DID 号码可与多个提供商关联。
6. 指定如何路由转发呼往这条接入规则的呼叫：
挂断通话
连接到分机
连接到振铃组
连接到虚拟接待
连接分机的语音信箱
转接到外部号码
7. 你还可以根据收到的呼叫是否在工作时间内而设置不同的转发路由。
导出以及导入接入规则
如果需要将已经创建的接入规则导出到 CSV 文件里，请按照如下步骤进行：
46
1. 登录到 PortSIP PBX 的管理控制台。
2. 点击左侧菜单”通话管理”>“接入规则”。
3. 点击“导出”按钮，开始导出接入规则
4. 选择存放导出的 CSV 文件的位置以及文件名，然后点击“确定”按钮。所有的接入规则将保存在指定的 CSV 文件里。
要创建多条导入规则，请通过使用正确格式在 CSV 文件内插入必要字段值，然后使用导入功能将其导入至 PortSIP PBX。
要使用 CSV 文件将接入规则导入至 PortSIP PBX，请按照如下步骤：
1. 登录到 PortSIP PBX的管理控制台。
2. 点击左侧菜单“通话管理”->“接入规则”，点击“导入”按钮。
3. 选择存放导出的CSV文件的位置以及文件名并点击“确定”按钮，CSV 文件里的所有接入规则都将导入至 PortSIP PBX。
创建外拨规则
在创建外拨规则之前，你至少应该配置一个 VoIP运营商/ SIP 中继。
一条外拨规则用来指示PortSIP PBX收到一个外拨呼叫的时候，这个呼叫应该通过哪一个
VoIP 运营商/SIP中继进行。外拨规则一般是基于发起外拨呼叫的分机用户号码（或者号码范围段）、发起呼叫的分机用户组、被呼叫号码的前缀、被呼叫号码的长度等因素来确定的。
请按照如下步骤创建外拨规则：
1 登录到 PortSIP PBX 的管理控制台，选择“通话管理”>“外拨规则”菜单，点击“新建”按钮，然后输入一个简单易记的规则名。
2 指定触发外拨规则的匹配条件，在“将本规则应用于如下呼叫”部分，可以指定如下选项：
被呼叫号码以指定前缀开始的呼叫：所有以指定的前缀开头的被叫号码。例如，输入“00”，那么所有以 00 开头的被叫号码都将匹配上本规则，包括 0012345，0002345 等等。您可以指定多个前缀，以“;”分隔。例如，“00;123;88”将指定前缀 00、123 和 88，如果被叫号码匹配其中一个前缀，则会触发该规则。
来自指定分机用户的呼叫：可以指定从某个分机用户或者某个分机用户号码段发起的呼叫。可以指定单个或多个分机用户。指定多个分机用户时，需要使用分号隔开；如果要指定分机用户号码段，需要用“-”符号，例如 100-120 表示从100-200这个范围内的分机用户发起的呼叫都将被匹配到该外拨规则。
47
被呼叫号码长度：根据被呼叫号码的数字长度来匹配。比如指定为 8，那么所有长度为8位的被呼叫号码都将匹配到本规则。可以在不指定被呼叫号码前缀的情况下用来路由本地呼叫和国际长途呼叫。
来自指定分机组的呼叫：根据发起呼叫的分机属于哪些分机组来决定是否触发本规则。
3 接下来设置满足该外拨规则条件的呼叫的路由。在“通过如下路由发起外拨呼叫”部分，可以为外拨呼叫选择最多三个路由。所有被成功添加的 VoIP运营商/SIP 中继都被列在三个下拉列表里。当第一个路由不可用或者正忙（达到了最大通话数）的时候，PortSIP PBX 将自动尝试第二个和第三个路由。如果三个路由都不可用或者正忙，呼叫失败。
4 在分机用户发起的呼叫触发某条外拨规则之后以及被 PBX 转发到被选中的 VoIP 运营商/SIP
中继网关之前，可以在“截除号码位数”和“号码前缀”两处分别对被呼叫号码进行修改,从头部开始截除部分号码或者在头部增加一些号码数字：
截除号码位数 使用该选项可以从被叫号码移除一个或多个数字，在转发到网关或服务运营商之前移除不需要的前缀数字。比如某个分机用户发起一个呼叫到号码 002345，你可以指定截除号码数为 2 以将前面的2位号码 00 移除，这样最终 PBX 发往 VoIP运营商/SIP
中继的被叫号码就是 2345。
号码前缀 指定需要添加到被呼叫号码前缀的号码。例如某个分机用户发起一个呼叫到
002345，在“截除号码位数”处指定位数为 2，然后在前置号码这里指定“0086”，这样 PBX 最终发往 VoIP运营商/SIP 中继的被叫号码就是 00862345。
4.9 配置振铃组/传呼组/对讲组
振铃组（Ring Group）是 PortSIP PBX 的重要功能，可以让你不会漏接任何一个客户的电话。而传呼/对讲功能能够像公共广播系统一样，对组成员发送通知。
创建一个振铃组之后，客户可以直接呼叫这个振铃组的号码，振铃租的所有分机成员都将同时或者依次收到这个呼叫，直到其中一个成员接听。比如你可以给销售部创建一个号码为 1000
的振铃组，将 3 个销售人员使用的分机号码 101、102、103 添加到这个组。当客户呼叫销售部的号码 1000 的时候，3 个销售人员的分机会同时或者依次响起直到某个销售人员接听了电话。
请按如下步骤创建振铃组：
1 在 PBX 管理控制台，点击“通话管理”>“振铃组”>“新建”。
2 设置振铃组的参数选项：
组号码：用来标识振铃组的号码，你可以随便指定一个号码，但是不能和已经存在的分机号码相同。注意：这个号码是虚拟分机号码，由 PBX 使用，不能用做普通的分机用户。
48
组名：为组指定一个容易记忆辨认的名字，比如销售部或者技术支持部。
振铃时长：指定群分机成员收到呼叫后振铃的时长。
振铃方式 – 给组选择一个适合的响铃方式:
同时振铃: 组所有的的分机成员将同时振铃
组次序振铃：按照成员添加到组里的顺序依次振铃
上次来电后接听次序振铃：按照成员添加到组里的顺序依次振铃，在之前呼叫中没有被
振铃过的成员优先振铃。
最短通话时长次序振铃：按照成员添加到组里的顺序依次振铃，在之前呼叫中还没有接听过呼叫的成员优先振铃。
传呼/对讲：这是一个传呼/对讲组，详情请看下一节内容。
3 在“组成员”部分你可以设置组的成员，仅需选中你要添加的分机用户就可以把成员添加进组，或者点击组中的成员将其从组中删除。
4 在“如果无人接听”部分，设置来电如果在振铃时长内没有被任何一个成员接听则 PBX 该如何处理来电。可以选择将来电直接结束，或者转移给其他的分机用户/振铃组/虚拟接待，或者某个分机用户的语音信箱。
传呼
创建振铃组的时候，如果将响铃方式设置为传呼/对讲，那么某个分机用户可以呼叫到这个群组，给所有属于组的分机用户成员发送通知。收到呼叫的组成员不需要手动接听，IP 话机或者客户端会自动应答，然后播放通知。在传呼/对讲中，呼叫方不会听到接听方的声音。
对讲
创建振铃组的时候，如果将响铃方式设置为传呼/对讲，那么某个分机用户可以呼叫这个组给，所有属于组的分机用户成员发送通知。收到呼叫的组成员不需要手动去接听，IP 话机或者客户端会自动应答，然后播放声音，在应答后的通话过程中中，呼叫方不会听到接听方的声音。
如果组的某个用户分机想和呼叫方对话，那么接听方的分机用户需要按 * 键开始和呼叫方对讲，呼叫方可以听到接听方的声音；接听方分机用户可以随时按下 # 键来结束对讲，恢复为只能接听方用户分机听到呼叫方声音的单向通话。
49
版权声明：本文标题：博瞻PortSIP 内容由热心网友自发贡献，该文观点仅代表作者本人， 转载请联系作者并注明出处：https://m.elefans.com/dianzi/1703830433a73831.html， 本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。
发表评论