技術情報
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 が動きます。
仮想マシンまたはクラウドサーバー
Ubuntu 24.04 LTS
VM インストーラーが、新しいサーバーにシングルノード構成をセットアップします。apt パッケージに含まれています。
VM ガイド →Linux パッケージ
Ubuntu 24.04 LTS
1 つのコマンドで Docker、本番用バンドル、monopbx コマンドをインストールし、Let’s Encrypt 証明書を取得します。
apt ガイド →Docker Compose
Docker 24 以降の 64 ビット Linux
Postgres、Valkey、ClickHouse、rtpengine を含む本番用バンドルです。すでに運用しているホスト向けです。
Compose ガイド →Kubernetes
Kubernetes 1.30 以降
kubectl apply -k (Kustomize) で適用するプレーンなマニフェストです。Helm チャートはありません。先に NAT 越しのメディアに関する注意事項をお読みください。
Kubernetes ガイド →
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
次の手順
- コンソールを開く. インストーラーは最後に、コンソールのアドレスと一度だけ使えるセットアップリンクを表示します。見失った場合は sudo monopbx setup-url で新しいリンクを表示できます。
- アカウントを作成する. メールアドレス、パスワード、認証アプリのコードを入力します。これがお使いの PBX の最初の管理者になります。
- 7 日間の無料トライアルが始まります. すべての機能が有効です。SIP トランクを追加し、内線を作成して、QR コードで MonoPhone にサインインしましょう。
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+tcp | SIP |
5061/tcp | TLS 経由の SIP |
30000–40000/udp | RTP 音声。開放されていないと、通話は接続されても音声が聞こえません。 |
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/udp | ePDG: UDP 上の IKEv2 と ESP(VoWiFi) |
|---|---|
5064, 5065 (defaults) | P-CSCF: IPsec トンネル経由の端末からの SIP(VoLTE) |
Diameter peer port, tcp or sctp | お使いの HSS または PCRF への外向き |
IMS、VoLTE、VoWiFi → · オペレーターガイド →
セキュリティの概要
- 録音とファイルはディスク上で暗号化されます。CRM とプロバイダーの認証情報は、会社の鍵で封印されます。
- パスキー、二要素サインイン、OpenID Connect シングルサインオン、SCIM、管理者向けの IP 許可リスト。ご自身のキーによる、サインイン時の reCAPTCHA(任意)。
- SIP 側と Web 側の自動 IP ブロック。確認できる一覧は 1 つです。
- SIP の入り口でのジオブロック、許可・拒否リスト、STIR/SHAKEN。SRTP はトランクごとに、任意または必須にできます。
- 監査ログ、変更履歴、新しいホストに復元できる、スケジュール実行の暗号化バックアップ。
- 通話、録音、履歴が当社を経由することはありません。電話機を起こすプッシュ通知だけがプッシュリレーを使い、これを使わずにインストールすることもできます。