安装 PortSIP PBX

Install the PortSIP PBX

最新 PortSIP PBX 免费版可以在 PortSIP 网站上下载。适用于 64 位 Windows 和 Linux,但不支持 32 位版本。

PortSIP PBX 免费版最多支持 3 个并发呼叫和 10 个分机注册。如果您需要更多的同时通话数/分机数,请联系 PortSIP 购买授权。

安装 PortSIP PBX 到 Linux 服务器

操作系统要求

PortSIP PBX 支持如下 Linux 版本 (64位)。

  • CentOS 7.9
  • Ubuntu 18.04, 20.04, 22.04, 24.04
  • Debian 10.x, 11.x, 12.x

最低硬件要求

PortSIP PBX 要求最低 2 核 CPU, 4G 内存,30GB 硬盘才能安装运行。

准备安装 Linux 服务器

在安装 PortSIP PBX 之前,请确保已经按照如下要求准备好服务器。

  • 确保服务器日期时间同步正确。
  • 如果安装 PBX 的 Linux 服务器位于局域网内,为 PBX 服务器分配一个静态私网 IP 地址;如果 PBX 位于公网上,则为其分配一个静态公网 IP 地址和静态私网 IP 地址。
  • 安装 PortSIP PBX 之前,请安装所有可用的更新和服务包。
  • 不要在 PortSIP PBX 服务器上安装 PostgreSQL。
  • 确保禁用系统和网络适配器的所有省电选项(将系统设置为高性能模式)。
  • 不要在主机上安装 TeamViewer、VPN 或其他类似软件。
  • PortSIP PBX 不得安装在作为 DNS 或 DHCP 服务器的服务器上。
  • 防火墙必须允许以下端口并确保它们未被其他应用程序使用。
  • UDP:5060、5066、25000-34999、45000-65000
  • TCP:5061、5063、5065、5067、8882、8883、8885、8887、8888、8889、10443。
  • 必须以根用户身份执行所有 Linux 命令,请先使用 su root。

注意,如果您将 PBX 安装在 AWS, 阿里云,微软云,华为云等公有云上,您还需要在云平台的防火墙上创建对应的网络规则来开放上述端口。

1. 下载安装脚本

后续所有命令都需要在 /opt/portsip 目录执行。

执行下列命令下载安装 PortSIP PBX 的脚本。

su -
mkdir -p /opt/portsip
cd /opt/portsip
curl https://www.portsip.cn/portsip-pbx-sh/v16.x/new/install_docker_cn.sh \
-o install_docker_cn.sh

curl https://www.portsip.cn/portsip-pbx-sh/v16.x/new/pbx_ctl.sh \
-o pbx_ctl.sh

2. 设置 Docker 环境

执行以下命令安装 Docker-Compose 环境。如果出现 likes*** cloud.cfg (Y/I/N/O/D/Z) [default=N] ? 的提示,请输入 Y,然后按 Enter 键。

/bin/sh install_docker_cn.sh

3. 创建 PortSIP PBX 容器实例

以下命令用于在公网 IP 地址为 66.175.221.120 的服务器上创建并运行 PortSIP PBX。如果在没有公网 IP 地址的局域网中运行 PBX,只需将 IP 66.175.221.120 替换为 PBX 服务器的局域网私网 IP 地址即可。

/bin/sh pbx_ctl.sh \
run -p /var/lib/portsip \
-a 66.175.221.120 \
-i registry.cn-hangzhou.aliyuncs.com/portsip/pbx:16 \
-d registry.cn-hangzhou.aliyuncs.com/portsip/postgresql:14.12

现在你可以使用 https://66.175.221.120:8887 访问 PortSIP PBX,默认的系统管理员名称和密码是 admin。登录后可以进行相关配置和管理。

成功创建 PBX docker 实例后,你可以使用下面的命令对其进行管理。

显示 PortSIP PBX 容器状态。

/bin/sh pbx_ctl.sh status

启动 PortSIP PBX 容器。

/bin/sh pbx_ctl.sh start

停止 PortSIP PBX 容器。

/bin/sh pbx_ctl.sh stop

重启 PortSIP PBX 容器。

/bin/sh pbx_ctl.sh restart

删除 PortSIP PBX 容器。

/bin/sh pbx_ctl.sh rm

安装 PortSIP PBX 到 Windows 服务器

操作系统

PortSIP PBX 支持如下 Windows 版本 (64位)。

  • Windows 10, 11
  • Windows Server 16, 19, 22

最低硬件要求

PortSIP PBX 要求最低 2 核 CPU, 4G 内存,30GB 硬盘才能安装运行。

准备安装 Windows 服务器

在安装 PortSIP PBX 之前,请确保已经按照如下要求准备好服务器。

  • 确保服务器日期时间同步正确。
  • 如果安装 PBX 的 Windows 服务器位于局域网内,为 PBX 服务器分配一个静态私网 IP 地址;如果 PBX 位于公网上,则为其分配一个静态公网 IP 地址和静态私网 IP 地址。
  • 安装 PortSIP PBX 之前,请安装所有可用的更新和服务包。
  • 不要在 PortSIP PBX 服务器上安装 PostgreSQL。
  • 确保禁用系统和网络适配器的所有省电选项(将系统设置为高性能模式)。
  • 不要在主机上安装 TeamViewer、VPN 或其他类似软件。
  • PortSIP PBX 不得安装在作为 DNS 或 DHCP 服务器的服务器上。
  • 防火墙必须允许以下端口并确保它们未被其他应用程序使用。
  • UDP:5060、5066、25000-34999、45000-65000
  • TCP:5061、5063、5065、5067、8882、8883、8885、8887、8888、8889、10443。
  • 必须以系统管理员权限进行安装。

注意,如果您将 PBX 安装在 AWS, 阿里云,微软云,华为云等公有云上,您还需要在云平台的防火墙上创建对应的网络规则来开放上述端口。

1. 下载安装包并安装

PorttSIP PBX 安装包可从 PortSIP 网站下载。安装 PortSIP PBX 时,只需双击安装程序,它将引导您完成安装过程。

安装成功后,PortSIP PBX 服务将自动启动(此后每次启动服务器时都会自动启动)。

在安装过程中,下图所示两个目录路径默认无需修改,如果您需要将 PortSIP PBX 安装在不同于默认的目录的地方,则必须确保这两个目录路径不相同,否则会安装失败。

安装成功完成后,你可以使用 https://66.175.221.120:8887 (将 IP 地址替换为你的 PortSIP PBX 实际 IP 地址) 访问 PortSIP PBX,默认的系统管理员名称和密码是 admin。登录后可以进行相关配置和管理。

配置防火墙规则

成功安装 PortSIP PBX 后,PortSIP PBX 所需的 Windows/Linux 端口已自动打开, 无需再做处理。

为了使 PortSIP PBX 正常工作,防火墙必须允许以下端口,请确保上述端口未被其他应用程序使用。

  • UDP:5060、5066、25000-35000、45000-65000
  • TCP:5061、5063、5065、5067、8882、8883、8885、8887、8888、8889、10443。

如果你创建了新的 PortSIP transport,则需要打开用于对应的端口:

  • 如果在端口 5070 上添加了 TLS transport,则必须在防火墙中打开 TCP 端口 5070。
  • 如果在端口 5071 上添加了 TCP transport,则必须在防火墙中打开 TCP 端口 5071。
  • 如果在端口 5078 上添加了 UDP transport,则必须在防火墙中打开 UDP 端口 5078。

以下示例用于创建允许 TCP 5070 端口的防火墙规则。

sudo firewall-cmd --permanent --service=portsip-pbx \
--add-port=5070/tcp \
--set-description="PortSIP PBX"
sudo firewall-cmd --permanent --add-service=portsip-pbx
sudo firewall-cmd --reload

下面的示例用于创建允许 UDP 端口 5078 的防火墙规则。

sudo firewall-cmd --permanent --service=portsip-pbx \
--add-port=5078/udp \
--set-description="PortSIP PBX"
sudo firewall-cmd --permanent --add-service=portsip-pbx
sudo firewall-cmd --reload

卸载 PortSIP PBX

请使用以下步骤卸载 PortSIP PBX for Linux。

停止并删除 PortSIP PBX 容器实例

cd /opt/portsip
/bin/sh pbx_ctl.sh stop
/bin/sh pbx_ctl.sh rm

删除 PortSIP PBX 配置和数据(执行之前请确认)

cd /var/lib/portsip
rm -rf pbx 
rm -rf postgresql

如果需要在 Windows 上卸载 PortSIP PBX, 直接从 Windows 控制面板中卸载即可。