在您的服务器上安装 MaxiPBX
共十个步骤,从设置 PBX 域名到首次登录界面。您需要先准备 FQDN 和防火墙,然后由 Control Plane 生成一个专属脚本供您通过 SSH 运行,最后由 Web 向导接手完成配置。
开始之前
- 一台全新安装的 Debian 13 服务器,且未运行任何其他服务或应用程序。
- 使用 root 账户的 SSH 访问权限(或可切换为 root 的账户)。
- 一个您可管理其 DNS 区域的域名,用于创建 PBX 的 FQDN(例如 pbx.yourdomain.com)。
- MaxiPBX Control Plane 账户,网址为 my.maxipbx.com。
- 可访问服务器前端的防火墙或路由器,以便开放所需端口。
准备网络
-
步骤 1 : 创建服务器的 FQDN
首先,请为您的 PBX 设置一个完全限定域名(FQDN),例如 pbx.yourdomain.com。在您域名的 DNS 区域中,将该名称指向服务器的 IP 地址:
注意在您开始安装(第 8 步)时,FQDN 必须已指向您的服务器。请务必先创建它。
名称 类型 值 pbx.yourdomain.comA 服务器的 IPv4 地址必需 pbx.yourdomain.comAAAA 服务器的 IPv6 地址如果您的服务器有 IPv6 地址 提示DNS 更改可能需要几分钟才能生效。如需确认该名称已解析到服务器的 IP,请在您的计算机上运行「ping pbx.yourdomain.com」。
-
步骤 2 : 开放防火墙端口
PBX 自带防火墙,仅开放其所需的端口。如果其前方还有防火墙或路由器(托管服务商防火墙、企业路由器、宽带路由器),请在该设备上开放以下所有端口,允许从外部访问 PBX。
注意8443 TCP 端口仅在安装期间需要:它供安装向导使用(第 10 步)。请在开始安装前开放该端口,并在 PBX 激活后重新关闭:届时已不再需要。
端口 协议 服务 用途 8443仅在安装期间TCP 向导 安装向导(第 10 步)。PBX 激活后请重新关闭 80TCP Nginx 通过 HTTP 进行话机自动配置,Let's Encrypt 证书续期 443TCP Nginx Web 界面、API、移动及桌面应用、网页电话(WebRTC)、HTTPS 自动配置 5060UDP + TCP Kamailio SIP:话机、软电话、运营商中继 5061TCP Kamailio 加密 SIP(TLS),ECDSA 证书 5062TCP Kamailio 加密 SIP(TLS),RSA 证书,适用于不支持 ECDSA 的话机 30000-40000UDP rtpengine 所有通话的语音(RTP):未开放这些端口将没有声音 3478-3479UDP + TCP coturn STUN/TURN:NAT 环境下应用和网页电话的音频 5349-5350UDP + TCP coturn 加密 TURN(TLS),在受限网络中起相同作用 389TCP MaxiPBX API 供话机使用的 LDAP 目录 10389TCP MaxiPBX API 备用端口上的 LDAP 目录,适用于部分型号 22TCP SSH MaxiPBX 远程管理与维护。可仅限我们的 IP 地址访问 提示如果 PBX 位于 NAT 之后(私有 IP 地址),请将上述所有端口转发至其内部 IP,RTP 范围同样为 30000-40000 UDP。
生成安装密钥
-
步骤 3 : 登录 Control Plane
在浏览器中打开 my.maxipbx.com,并使用您的账户登录。Control Plane 是您管理整个 PBX 设备群的平台。
打开 Control Plane -
步骤 4 : 打开 PBX 列表
在菜单中进入「PBX 设备群」,然后点击「PBX」。您将在此看到已关联到您账户的所有 PBX。
-
步骤 5 : 生成安装密钥
点击「生成安装密钥」。该密钥会将未来的服务器关联到您的账户:安装完成后,它将直接出现在您的设备群中。
-
步骤 6 : 显示并复制安装脚本
显示安装脚本并完整复制。脚本中已包含您的密钥:无需做任何修改。
注意该脚本包含您账户专属的密钥。请勿分享或在任何地方公开。
运行安装
-
步骤 7 : 使用 root 账户通过 SSH 连接
在终端(或 Windows 上的 PuTTY 等客户端)中,使用 root 账户连接到您全新的 Debian 13 服务器。请将 YOUR_IP 替换为服务器的 IP 地址。
ssh root@YOUR_IP提示如果您使用其他账户登录,请先通过「su -」或「sudo -i」命令切换到 root,然后再继续。
-
步骤 8 : 粘贴脚本并按 Enter 键
将第 6 步中复制的安装脚本粘贴到终端中,然后按 Enter 键。
-
步骤 9 : 等待安装完成
安装进度将实时显示在屏幕上。请让其运行至结束,期间请勿进行任何操作。
注意安装过程中请勿关闭终端或中断 SSH 连接。
完成配置
-
步骤 10 : 打开安装向导
安装结束时,终端会显示您 PBX 的地址,格式如下所示。请在浏览器中打开该地址,然后按照安装向导操作:它将引导您完成初始配置。
https://YOUR_IP:8443提示如果首次访问时浏览器显示有关证书的安全警告,您可以继续访问该网站以启动向导。
需要帮助?使用向导时如有任何疑问,欢迎联系您的 MaxiPBX 经销合作伙伴:他们将为您提供支持。
您的 PBX 已安装完成
完成向导后,您的 PBX 即可投入使用,并已关联到 Control Plane 中的设备群。现在您可以创建用户、话机和线路。
需要帮助?
我们的团队可在安装过程中为您提供支持,或为您代为完成安装。

