インストールおよびデプロイガイド

CXMind Core（オープンソース版）へようこそ！このガイドでは、Docker Compose を使用して、ローカルまたはサーバー上に完全なシグナリング監視および分析システムを迅速にデプロイする手順を説明します。

1. 環境の要件

開始する前に、サーバーまたはローカルの開発環境に以下の基本ソフトウェアがインストールされていることを確認してください：

• Docker Engine (バージョン 20.10.0+ 以上)
• Docker Compose (バージョン v2.0.0+ 以上)
• Linux サーバーをご利用の場合、Rocky Linux 9 または Ubuntu 22.04 LTS を推奨します。
• 推奨構成：2 CPU コア、4GB メモリ、20GB ディスクスペース。

2. クイックデプロイ (Docker Compose)

CXMind コミュニティ版では、すべての依存コンポーネント（Ingestion Engine、データベース、メモリキャッシュ、管理画面）が事前設定済みの docker-compose.community.yml にパッケージ化されています。わずか2ステップで完全なシステムを立ち上げることができます：

ステップ 1：ソースコードリポジトリのクローン

git clone https://github.com/cxmind/cxmind-core.git
cd cxmind-core

ステップ 2：コミュニティ版サービスの起動

以下のコマンドを実行すると、Docker が自動的に必要なイメージをプルし、すべてのコンテナを起動します：

docker-compose -f docker-compose.community.yml up -d

起動プロセスには通常1〜2分かかります（初回起動時はイメージのダウンロードとデータベース構造の初期化が必要です）。少々お待ちください。

ステップ 3：実行状態の確認

以下のコマンドを使用して、すべてのコンテナが Up 状態であるかを確認します：

docker-compose -f docker-compose.community.yml ps

すべて正常であれば、ie (Ingestion Engine)、admin-ui (管理画面)、surrealdb、および redis などの重要なサービスが実行されていることが確認できます。

3. 管理画面 (Admin UI) へのアクセス

サービスが正常に起動したら、モダンブラウザを使用してローカルの管理コンソールインターフェースにアクセスできます：

• アクセスアドレス: http://localhost:5173 (クラウドサーバーにデプロイしている場合は、localhost をサーバーのパブリック IP に置き換えてください)
• デフォルトアカウント: admin@cxmi.ai
• デフォルトパスワード: admin123

セキュリティのヒント：初回ログイン後、システム設定で管理者パスワードを変更することを強くお勧めします。

4. シミュレーター経由でのデータインジェストの検証

通信プロトコルに初めて触れる開発者が迅速に体験できるよう、PCAP シグナリングシミュレーターを組み込んでいます。物理的な PBX がなくても、シミュレートされた通話フローを生成できます：

# cxmind-core のルートディレクトリで実行
cd simulator
npm install
npm start

この時点で、シミュレーターは SIP/RTCP シグナリングフローをローカルにスローし、Admin UI の監視ダッシュボードでアクティブな通話カードがリアルタイムに現れるのを即座に確認できます。

5. 高度なデプロイ：トポロジーごとのモジュールインストール

高度な Sniffer-Go トポロジーを使用して分散環境に CXMind を展開する場合、異なるサーバーに異なるコンポーネントをインストールする必要があります。

5.1 シンプルモード（単一サーバー）

すべてのコンポーネントが同じサーバー上に存在します。

• サーバー: SIP PBX, RTPEngine, CXMind Core (IE, AS, AU, DB, Redis), Sniffer-Go.

5.2 リレーモード（SIP と RTP の分離）

SIP シグナリングと RTP メディアは別々のサーバーで処理されます。

• SIP サーバー: SIP PBX, Sniffer-Go（RTP サーバーの Sniffer-Go へ HEP を転送するように構成）。
• RTP サーバー: RTPEngine, Sniffer-Go（リレーモード relay_upstream: true で構成）。
• 中央サーバー: CXMind Core (IE, AS, AU, DB, Redis).

5.3 ピアメッシュモード（HA クラスター）

複数のサーバーが SIP と RTP の両方を処理し、サーバー間のメディアルーティングが発生する可能性があります。

• クラスターノード (A, B, C...): SIP PBX, RTPEngine, Sniffer-Go（hep_peers で構成）。
• 中央サーバー: CXMind Core (IE, AS, AU, DB, Redis).

これらのトポロジーの詳細な config.yaml の例については、エンタープライズ向けのプライベートランブックを参照してください：docs/runbooks/sniffer-go-deployment-topologies.md。

6. よくある問題のトラブルシューティング

起動時に問題が発生した場合は、以下を確認してください：

1. ポートの競合: ローカルポート 5173 (フロントエンド)、6379 (Redis)、およびシグナリング待受 UDP ポート 5060 と 9060 が占有されていないことを確認してください。
2. ログの確認: docker-compose -f docker-compose.community.yml logs -f ie を使用して、コア Ingestion Engine のランタイムログをリアルタイムで表示し、特定の構成項目が欠落していないか判断します。

---

体験後、AI 感情認識、高同時実行メディア録音分析、および RTP 音声キャプチャ 機能をアンロックしたい場合は、cxmi.ai にアクセスして Pro 商用ライセンスを申請してください。