インストールガイド

サーバーに MaxiPBX をインストールする

PBX のドメイン名の設定から、インターフェースへの初回ログインまでの 10 ステップです。まず FQDN とファイアウォールを準備し、次に Control Plane が生成する専用スクリプトを SSH で実行します。最後に Web ウィザードが設定を引き継ぎます。

始める前に

  • 新規にインストールされた Debian 13 サーバー(他のサービスやアプリケーションが稼働していないこと)。
  • root アカウントでの SSH アクセス(または root に切り替え可能なアカウント)。
  • PBX の FQDN(例:pbx.yourdomain.com)を作成するため、DNS ゾーンを管理できるドメイン名。
  • my.maxipbx.com の MaxiPBX Control Plane のアカウント。
  • 必要なポートを開放するため、サーバーの前段にあるファイアウォールまたはルーターへのアクセス。
インストール前

ネットワークの準備

  1. ステップ 1 : サーバーの FQDN を作成する

    まず、PBX に完全修飾ドメイン名(FQDN)を割り当ててください(例:pbx.yourdomain.com)。ドメインの DNS ゾーンで、この名前をサーバーの IP アドレスに向けます。

    注意インストールを開始する時点(ステップ 8)で、FQDN がすでにサーバーを指している必要があります。最初に作成してください。

    名前タイプ値
    pbx.yourdomain.com A サーバーの IPv4 アドレス必須
    pbx.yourdomain.com AAAA サーバーの IPv6 アドレスサーバーに IPv6 アドレスがある場合

    ヒントDNS の変更が反映されるまで数分かかる場合があります。名前がサーバーの IP に解決されることを確認するには、お使いのコンピューターから「ping pbx.yourdomain.com」を実行してください。

  2. ステップ 2 : ファイアウォールのポートを開放する

    PBX には独自のファイアウォールが搭載されており、必要なポートのみを開放します。前段にファイアウォールやルーター(ホスティング事業者のファイアウォール、社内ルーター、インターネットルーター)がある場合は、その機器で以下のすべてのポートを、外部から PBX 向けに開放してください。

    注意ポート 8443 TCP はインストール時のみ必要です。インストールウィザード(ステップ 10)で使用されます。インストール開始前に開放し、PBX のアクティベーション後は不要になるため閉じてください。

    ポートプロトコルサービス用途
    8443 インストール時のみ TCP ウィザード インストールウィザード(ステップ 10)。PBX のアクティベーション後は閉じてください
    80 TCP Nginx HTTP による電話機のプロビジョニング、Let's Encrypt 証明書の更新
    443 TCP Nginx Web インターフェース、API、モバイル/デスクトップアプリ、Web フォン(WebRTC)、HTTPS プロビジョニング
    5060 UDP + TCP Kamailio SIP:電話機、ソフトフォン、通信事業者トランク
    5061 TCP Kamailio 暗号化 SIP(TLS)、ECDSA 証明書
    5062 TCP Kamailio 暗号化 SIP(TLS)、ECDSA 非対応の電話機向け RSA 証明書
    30000-40000 UDP rtpengine すべての通話の音声(RTP):これらのポートがないと音声が流れません
    3478-3479 UDP + TCP coturn STUN/TURN:NAT 配下のアプリおよび Web フォンの音声
    5349-5350 UDP + TCP coturn 暗号化 TURN(TLS)、制限の厳しいネットワークで同じ役割を担います
    389 TCP MaxiPBX API 電話機向け LDAP ディレクトリ
    10389 TCP MaxiPBX API 代替ポートでの LDAP ディレクトリ(一部の機種向け)
    22 TCP SSH MaxiPBX によるリモート管理・保守。当社の IP アドレスのみに制限できます

    ヒントPBX が NAT 配下(プライベート IP アドレス)にある場合は、このリストのすべてのポートを内部 IP にポートフォワーディングしてください。RTP の範囲も同じく 30000-40000 UDP です。

Control Plane で

インストールキーの生成

  1. ステップ 3 : Control Plane にログインする

    ブラウザで my.maxipbx.com を開き、お客様のアカウントでログインします。Control Plane では、PBX フリート全体を管理できます。

    Control Plane を開く
  2. ステップ 4 : PBX の一覧を開く

    メニューで「PBX フリート」に移動し、「PBX」をクリックします。お客様のアカウントにすでに紐付けられているすべての PBX が表示されます。

  3. ステップ 5 : インストールキーを生成する

    「インストールキーを生成」をクリックします。このキーにより、新しいサーバーがお客様のアカウントに紐付けられます。インストール後、サーバーはフリートに直接表示されます。

  4. ステップ 6 : インストールスクリプトを表示してコピーする

    インストールスクリプトを表示し、全体をコピーします。スクリプトにはすでにキーが含まれているため、変更は一切不要です。

    注意このスクリプトには、お客様のアカウント固有のキーが含まれています。共有したり、公開したりしないでください。

サーバー上で

インストールの実行

  1. ステップ 7 : root アカウントで SSH 接続する

    ターミナル(または Windows の PuTTY などのクライアント)から、新しい Debian 13 サーバーに root アカウントで接続します。YOUR_IP をサーバーの IP アドレスに置き換えてください。

    ssh root@YOUR_IP

    ヒント別のアカウントでログインしている場合は、続行する前に「su -」または「sudo -i」コマンドで root に切り替えてください。

  2. ステップ 8 : スクリプトを貼り付けて Enter キーを押す

    ステップ 6 でコピーしたインストールスクリプトをターミナルに貼り付け、Enter キーを押します。

  3. ステップ 9 : インストールの完了を待つ

    インストールの進行状況が画面に順次表示されます。何も操作せず、最後まで実行させてください。

    注意インストール中にターミナルを閉じたり、SSH 接続を切断したりしないでください。

ブラウザで

設定の完了

  1. ステップ 10 : インストールウィザードを開く

    インストールが完了すると、ターミナルに以下の形式で PBX のアドレスが表示されます。ブラウザでこのアドレスを開き、インストールウィザードに従ってください。初期設定を順を追って案内します。

    https://YOUR_IP:8443

    ヒント初回アクセス時にブラウザが証明書に関するセキュリティ警告を表示した場合は、サイトへ進んでウィザードを起動してください。

    サポートが必要ですか?ウィザードの操作中にご不明な点がございましたら、お気軽に MaxiPBX 販売パートナーにお問い合わせください。サポートいたします。

PBX のインストールが完了しました

ウィザードが完了すると、PBX は使用可能な状態となり、Control Plane のフリートに紐付けられます。ユーザー、電話機、回線を作成できるようになります。

お困りですか?

当社チームがインストールをサポートすることも、代わりにインストールを行うことも可能です。