在您的伺服器上安裝 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 中的設備群。現在您可以建立使用者、話機與線路。
需要協助嗎?
我們的團隊可在安裝過程中為您提供支援,或為您代為完成安裝。

