プライベートノードを使うと、有料ユーザーは転送の実行をすべて自分のサーバーで行えます。Web 設定、ルールエンジン、配信履歴は ChannelFlow が管理し、Linux サーバーでは Node Agent、送信元ごとの監視コンテナ、ノード単位の配信コンテナが動作します。監視も配信もサーバー上で実行されます。
ノードの「オンライン」はサーバーの登録完了だけを示します。送信元アカウントの接続と、テストメッセージが実際の送信先へ届くことも確認してください。
事前準備
次のものが必要です。
- 有効な ChannelFlow 有料プラン。現在、各有料ユーザーはプライベートノードを 1 台作成できます。
- SSH で接続でき、
rootまたはsudo権限を持つ Linux サーバー。 - HTTPS、Docker イメージと依存パッケージの配布元、利用する各プラットフォームへの外向き通信。
- 2 CPU、2 GB RAM、10 GB の空きディスクを推奨します。実際の容量は通信量とメディア処理量で変わります。
新しい公開受信ポートは不要です。Debian/Ubuntu ではインストーラーが docker.io を導入できます。それ以外のディストリビューションでは、先に Docker をインストールして起動してください。
1. プライベートノードを作成する
- ChannelFlow にログインし、「転送インスタンス」を開きます。
- 「インスタンス設定」の「プライベート実行ノード」を開きます。
- ノード名とリージョンを入力し、「プライベートノードを作成」を選択します。
- 表示された Node ID、1 回限りの登録 Key、インストールコマンドをコピーします。
登録 Key が完全に表示されるのは 1 回だけです。スクリーンショット、チャット、チケット、公開リポジトリに保存しないでください。ノードが「接続待ち」の間に紛失した場合は再生成できます。古い Key は直ちに無効になります。
2. 自分のサーバーでインストールする
管理画面で「接続コマンドをコピー」を選び、SSH で Linux サーバーへ接続して実行します。公式インストーラーが Docker を確認または導入し、Node Agent、選択した監視 Worker、配信 Worker をビルドしたあと、登録 Key の入力を求めます。
登録 Key をコマンドに直接追加しないでください。Shell 履歴に残る可能性があります。初回インストールはネットワークとビルド速度により数分かかります。
3. オンラインを確認する
管理画面の状態が「接続待ち」から「オンライン」に変わることを確認します。サーバー側では次も確認できます。
docker ps --filter name=channelflow-node-agent
docker ps --filter name=channelflow-delivery
docker logs --tail 50 channelflow-node-agent
接続後は Node Agent と送信元ごとの監視コンテナが表示されます。配信タスクがある場合、Agent はノード単位の配信コンテナ channelflow-delivery-<Node ID> を自動起動します。
接続待ちのままの場合は、https://channelflow.cc への通信、Docker の状態、空きディスク、登録 Key と Node ID の組み合わせを確認してください。
4. 転送インスタンスを割り当てる
転送インスタンスを作成するとき、「実行ノード」で追加したプライベートノードを選択します。まだ Worker を作成していない既存インスタンスも、「インスタンス設定」から割り当てできます。
最初の Worker が作成されると、そのインスタンスはノードに固定されます。既存 Worker を別ノードへ直接移動することはできず、ノードがオフラインでも自動移行しません。同じアカウントが 2 台のサーバーで同時にログインすることを防ぐためです。
5. 実際の転送を確認する
- Discord、Telegram、QQ、X などの送信元アカウントを追加します。
- 送信先を追加し、チャンネル転送ルールを作成します。
- インスタンスを開始または再起動し、送信元が接続済みであることを確認します。
- 送信元から専用のテストメッセージを送ります。
- 「配信履歴」を確認し、送信先プラットフォームで実際の受信を確認します。
監視も配信もノード上のコンテナが実行し、プラットフォームはルールエンジン、アウトボックス、配信履歴を管理します。
ノードがオンライン、送信元が接続済み、配信履歴が成功、送信先で受信済み、の 4 条件がそろって初めて接続完了です。
保守とセキュリティ
- ノードデータは
/opt/channelflow-nodeに保存されます。別サーバーへコピーしないでください。 - 制御サーバーのデータベースパスワード、Kafka アドレス、暗号鍵、他ユーザーの資格情報をノードへ置かないでください。
- ノード上の配信コンテナが持つのは、プラットフォームが発行した配信専用の資格情報のみで、このノードのインスタンスの配信タスクだけを取得できます。データベースのパスワード、暗号鍵、他のユーザー資格情報は含まれません。
- ノードを停止すると通信が切れ、割り当て済みインスタンスに影響します。先に保守時間を確保してください。
- 有料プランが失効するとプライベートノードは停止します。更新後はノードとインスタンスの状態を再確認してください。
- インストーラーは初回接続または同じホストでの復旧用です。既存ノードの自動更新やインスタンス移行は行いません。
登録後にローカルの長期資格情報を失った場合は、古い Agent を停止して ChannelFlow サポートへ連絡してください。同じノード ID を 2 台のサーバーへ複製しないでください。