技術情報

MonoPbx の構成要素、動作環境、インストール方法をまとめています。意思決定者向けの要点と、管理者向けの詳細です。

概要

アーキテクチャ
Rust で書かれた SIP バックツーバックユーザーエージェント、メディア処理の rtpengine、Web コンソールと REST API、設定用の PostgreSQL、キャッシュとイベント用の Valkey、通話履歴と分析用の ClickHouse。
シグナリング
UDP、TCP、TLS 上の SIP。ブラウザーフォンには WebSocket 上の SIP を使用します。
メディア
rtpengine 経由の RTP と SRTP、ブラウザー向けの WebRTC、NAT 配下の電話機向けの STUN と TURN。
コーデック
Opus、G.722、G.711、G.729。IMS 端末向けの AMR と AMR-WB(トランスコード付き)。
複数の会社
1 つのインストールで多数の会社をホストできます。各社のデータは、PostgreSQL の行単位で分離されます。
API
OpenAPI ドキュメントを備えた REST、署名付き Webhook、イベント WebSocket、MCP サーバー。
言語
コンソールとアプリは 9 言語に対応: 英語、スペイン語(メキシコ)、ポルトガル語(ブラジル)、フランス語、ドイツ語、イタリア語、ロシア語、中国語、日本語。

規模

当社の検証環境では、小さな 1 ノードがメディアを伴う 600 件の同時通話を処理しました。失敗した通話はなく、通話の確立は 95 パーセンタイルで 150 ms 未満でした。これは共有の開発マシン 1 台で測定した結果のため、おおよその目安としてご覧ください。ご自身の環境については、サイジング計算ツールをお使いください。 サイジング計算ツール →

動作要件と対応システム

Linux パッケージと VM インストーラー
Ubuntu 24.04 LTS、amd64 または arm64。
Docker Compose
Docker 24 以降と Compose 2.24 以降を備えた 64 ビット Linux ホスト。
Kubernetes
バージョン 1.30 以降。Kustomize によるプレーンなマニフェスト。
開始時のマシン
CPU 2 コア、メモリ 4 GB、/var/lib に 20 GiB の空き容量。
ネットワーク
パブリック IP アドレス。DNS 名は任意です。
IMS モード
オプション。P-CSCF と ePDG は Linux 上で動作し、CAP_NET_ADMIN が必要です。後述の IMS のセクションをご覧ください。

自社のサーバーまたはクラウド VM にインストール

どのクラウドでも自社のハードウェアでも、Ubuntu 24.04 の仮想マシンを作成し、下記のポートを開けて 1 行のインストーラーを実行します。どの方法でも同じ MonoPbx が動きます。

Linux パッケージ: 手順の詳細

パブリック IP を持つ新しい Ubuntu 24.04 サーバーで、次のコマンドを実行します。

curl -fsSL https://ilinaya.github.io/monopbx-apt/install.sh | sudo bash

セットアップでは、Let’s Encrypt 証明書用のメールアドレスを入力します。ご自身のドメインも指定してください。--domain を指定しない場合、サーバー名は <ip>.sslip.io になります:

curl -fsSL https://ilinaya.github.io/monopbx-apt/install.sh | sudo bash -s -- --domain pbx.example.com --email you@example.com

次の手順

  1. コンソールを開く. インストーラーは最後に、コンソールのアドレスと一度だけ使えるセットアップリンクを表示します。見失った場合は sudo monopbx setup-url で新しいリンクを表示できます。
  2. アカウントを作成する. メールアドレス、パスワード、認証アプリのコードを入力します。これがお使いの PBX の最初の管理者になります。
  3. 7 日間の無料トライアルが始まります. すべての機能が有効です。SIP トランクを追加し、内線を作成して、QR コードで MonoPhone にサインインしましょう。
ubuntu@pbx:~インストール完了時の表示
curl -fsSL https://ilinaya.github.io/monopbx-apt/install.sh | sudo bash -s -- --domain pbx.example.com --email you@example.com
==> Prerequisites
==> MonoPbx APT repository: https://ilinaya.github.io/monopbx-apt
    signing key verified: 320D C78E FDC8 439C 04F5  FCA6 3E87 FE3D 4C71 5372
==> Installing monopbx (with Ubuntu's docker.io and docker-compose-v2 unless Docker is already installed)
==> monopbx setup --domain pbx.example.com --email you@example.com
    …
==> MonoPbx is ready
    console:        https://pbx.example.com
    web softphone:  wss://pbx.example.com/sip
    SIP:            pbx.example.com port 5060 (UDP/TCP), 5061 (TLS)
    first admin:    open the single-use setup link printed above (.../setup#token=...)
    manage:         monopbx status | logs | sudo monopbx backup | upgrade | uninstall

ポート

80/tcp証明書のチャレンジ、HTTPS へのリダイレクト
443/tcpコンソール、API、ブラウザーフォン (wss://…/sip)
5060 udp+tcpSIP
5061/tcpTLS 経由の SIP
30000–40000/udpRTP 音声。開放されていないと、通話は接続されても音声が聞こえません。

ufw が有効な場合、セットアップがこれらのポートを開放します。クラウドのファイアウォールでも同じポートを開放してください。

IMS モード(VoLTE と VoWiFi)

オプション機能で、管理者がオンにするまでオフです。MonoPbx を、自社の SIM カード向けの IMS コアにします。

コンポーネント
PBX エンジン、VoLTE 用の任意の P-CSCF の役割、VoWiFi 用の任意の ePDG(mpbx-epdg)。プライベートネットワーク上の認証済みリンクで通信します。
プロトコル
IPsec を使う SIP(TS 33.203)、EAP-AKA’ を使う IKEv2、TCP または SCTP 上の Diameter Cx と Rx(TLS は任意)、HTTP の Nudm と N5、IMS 経由の SMS。
加入者データ
MonoPbx 内、Diameter Cx 経由のお使いの HSS、または Nudm 経由の 5G UDM に保持します。
要件
P-CSCF と ePDG 用の Linux(CAP_NET_ADMIN 付き)。ePDG 用のパブリックアドレスと証明書。SIM の鍵、またはそれらを保持する HSS か UDM。モバイルコーデックを使う場合は、AMR をエンコードできるメディアサーバー。
500, 4500/udpePDG: UDP 上の IKEv2 と ESP(VoWiFi)
5064, 5065 (defaults)P-CSCF: IPsec トンネル経由の端末からの SIP(VoLTE)
Diameter peer port, tcp or sctpお使いの HSS または PCRF への外向き

IMS、VoLTE、VoWiFi → · オペレーターガイド →

セキュリティの概要

さらに詳しく

無料トライアルを開始 デモを予約