实用指南6 分钟
Server mode 与 Web UI
把 Conflux 作为常驻服务运行，并通过 HTTP / WebSocket 进行远程观察。
当你希望 Conflux 以长期运行的 daemon 形式工作，而不是一次性的本地命令时，就应该考虑 server mode。
什么时候值得使用 server mode
如果你需要以下任意一项，它就很有价值：
- 远程 TUI
- 常驻浏览器仪表盘
- HTTP 与 WebSocket API
- 由 server 端管理的 proposal session
- user-level 的后台服务
启动 server
Terminal
cflx server启动后，daemon 会提供 Web UI 与 API。
快速启用 Web UI
启动 cflx server 即可获得浏览器仪表盘。如有需要，可在项目配置中调整绑定地址和端口。
Terminal
cflx server连接远程 TUI
Terminal
cflx tui --server http://host:39876当 orchestrator 跑在另一台机器上，但你仍想在本地终端中交互观察时，这很有用。
仪表盘能看到什么
Web UI 实际上提供了：
http://localhost:<port>/下的 dashboard- 基于 WebSocket 的实时更新
- 查询状态的 REST API
- 在 TUI 中通过
w打开的二维码弹窗
主要 REST 端点如下：
| Endpoint | Method | 用途 |
|---|---|---|
/api/health | GET | 健康检查 |
/api/state | GET | orchestrator 全局状态 |
/api/changes | GET | 查看所有 change 与进度 |
/api/changes/{id} | GET | 查看单个 change 详情 |
WebSocket 地址是 ws://localhost:<port>/ws。
推荐
如果你想给团队做一次有效演示，cflx server
往往是最高性价比的入口。大家可以一起看浏览器状态，而不必共享同一个终端。
service 管理
cflx service 用于把 server 包装成 user-level 后台服务。
Terminal
cflx service install cflx service start cflx service status cflx service
restart cflx service stop cflx service uninstall
各平台对应实现：
- macOS：
launchduser agent - Linux：
systemd --user - Windows：Scheduled Task
常见排障
仪表盘打不开
先确认 cflx server 是否正在运行，并确认访问的端口正确。
Address already in use
修改 server.port 配置为可用端口，或设为 0 让操作系统自动分配。
其他设备无法访问
显式绑定到所有网卡：
{
"server": {
"bind": "0.0.0.0",
"port": 9000,
},
}
WebSocket 经常断开
先排查网络质量，再判断是不是 orchestrator 有问题。dashboard 会自动尝试重连。