集群节点（ClusterNode）

这是什么

ClusterNode 是 Cluster 多节点部署模式下注册到中心表的一行记录。每个节点启动时会向其他节点注册自己（包括节点 ID、地址、密钥），并持续心跳。

如果你只部署单机，完全不需要关心本节。

在哪里看到

• 后台 → 集群设置：节点列表、状态、最后心跳时间
• 监控：每个节点都会通过 pusher 主动推送数据变更到其他节点

关键字段

字段	含义	设置后影响
node_id	节点 ID	全集群唯一标识；修改后该节点被认为「换了身份」
node_name	节点名称	展示用；修改不影响通信
status	状态	启用 / 禁用；禁用后不再接收其他节点的推送
address	host:port	节点间 HTTP 推送目标；写错则推送失败
secret	密钥	节点间互信的 Bearer Token；必须与集群内其他节点一致
last_heartbeat_time	最后心跳时间	Unix 秒；长时间未更新 → 标红「失联」

多节点部署

如果你计划部署 N 个节点：

1. 每个节点的 CLUSTER_NODE_ID 必须唯一
2. 每个节点的 CLUSTER_NODE_SECRET 必须相同
3. 每个节点要知道其他所有节点的 address
4. 节点间通过 HTTP 主动推送数据变更，无中心数据库

详见 去中心化 与 多节点部署。

相关页面

• Cluster 概览
• 节点管理
• 配置同步
• 节点健康
• 多节点部署
• 集群设置

相关 API

• GET /api/cluster_node/ — 列表
• POST /api/cluster_node/ — 新增
• PUT /api/cluster_node/ — 更新
• POST /api/cluster_node/:id/enable — 启用
• GET /api/cluster_node/ping/:id — Ping 测试