Server mode と Web UI

server mode は、Conflux を単発のローカルコマンドではなく、常駐 daemon として扱いたい時に使います。

server mode が効く場面

次のどれかが欲しいなら検討価値があります。

• remote TUI
• 常時使えるブラウザダッシュボード
• HTTP / WebSocket API
• server 側管理の proposal session
• user-level background service

server を起動する

cflx server

これで daemon が Web UI と API を公開します。

Web UI を使う

ブラウザダッシュボードを使う場合は server mode を起動します。

cflx server

ブラウザダッシュボードが必要な場合は server mode を使います。

remote TUI をつなぐ

cflx tui --server http://host:39876

orchestrator を別マシンで動かしつつ、手元から TUI を見たい時に便利です。

ダッシュボードで見えるもの

Web UI では主に次が使えます。

• http://localhost:<port>/ のダッシュボード
• WebSocket 経由のリアルタイム更新
• 状態取得用 REST API
• TUI の w で出せる QR popup

主要な REST endpoint は次の通りです。

WebSocket は ws://localhost:<port>/ws に接続します。

service 管理

cflx service を使うと server を user-level service として扱えます。

cflx service install cflx service start cflx service status cflx service
restart cflx service stop cflx service uninstall

プラットフォームごとの実体は次です。

• macOS: launchd user agent
• Linux: systemd --user
• Windows: Scheduled Task

よくある詰まりどころ

ダッシュボードが開かない

cflx server が起動しているか、URL のポート番号が正しいかをまず確認します。

Address already in use

server の port 設定を未使用ポートへ変更します。

別端末から見えない

server の bind 設定を明示的に全 interface へ向けます。

{
  "server": {
    "bind": "0.0.0.0",
    "port": 9000,
  },
}

WebSocket が切れる

まずネットワークの安定性を確認します。ダッシュボードは自動再接続を試みます。