Uptime Kuma 监控同步
你会学到：如何启用并配置 Uptime Kuma 自动同步集成，控制监测站点的同步范围与心跳探测参数，以及 OpenFlare 与 Uptime Kuma 差分同步的底层原理。
功能概述
在边缘多节点运维中，及时了解各个代理站点的可用性至关重要。为了避免手动在监控系统中重复录入站点信息，OpenFlare 提供了与开源监控服务 Uptime Kuma 的深度集成。
启用集成后，OpenFlare 会启动一个后台同步调度器，自动将管理端配置的代理站点同步为 Uptime Kuma 中的 HTTP 监控任务。支持检测范围过滤、差分属性更新以及对下线站点的自动清理。
第一步：在系统设置中配置集成
- 登录管理端控制面板，进入左侧导航 「系统设置」 (Settings)，选择 「OpenFlare」 选项卡，在 「Uptime Kuma 集成」 区域进行配置。
- 配置以下核心连接参数：
- 启用状态 (Enabled)：开启集成开关。
- 实例地址 (Instance URL)：你的 Uptime Kuma 服务地址。例如
http://192.168.1.100:3001或https://kuma.example.com（必须包含协议前缀http://或https://）。 - 用户名 (Username) 与 密码 (Password)：具有管理权限的 Uptime Kuma 账户凭证，用于 API 鉴权。
第二步：控制监控范围与心跳参数
在集成面板中，你可以对监控范围和具体探测行为进行细粒度控制：
1. 监控范围 (Monitor Scope)
- 全部站点 (All)：默认选项。OpenFlare 将自动同步所有已启用的代理路由站点。当新站点被创建且启用，或者旧站点被停用时，监控列表将自动增删。
- 选择站点 (Selected)：仅监控指定站点。选择此模式后，可以点击 「选择监控站点」 弹出框。在弹出框内可以通过搜索过滤站点并进行勾选。被取消勾选或未勾选的站点将不会被同步（若已存在则会被自动清理）。
2. 监测频率与心跳设置
你可以为自动生成的监控项指定统一的探测参数：
- 同步间隔 (Sync Interval)：自动差分同步的频率（分钟），默认为
5分钟。即控制面每 5 分钟与 Uptime Kuma 进行一次状态比对。 - 心跳检测频率 (Interval)：Uptime Kuma 探测站点的频率（秒），默认为
60秒。 - 最大重试次数 (Retry)：探测失败后，判定为 Down 之前的最大重试次数，默认为
0。 - 重试间隔时间 (Retry Interval)：重试之间的等待秒数，默认为
60秒。 - 请求超时时间 (Timeout)：探测请求判定为超时的秒数，默认为
48秒。
同步与清理机制
- 专属标签隔离：所有自动创建的监控项均会绑定
OpenFlare专属标签（紫蓝色）。同步和清理程序仅操作带有该标签的监控任务，绝不干扰或破坏你在 Uptime Kuma 中手动创建的其他监控项。 - 差分增量同步：同步程序会周期性对比监控元数据。当检测到域名或心跳配置变更时，仅执行差分更新，避免中断历史统计数据；当站点停用或移出范围时，会自动执行监控下线清理。
TIP
关于 Uptime Kuma 监控同步的 Socket.IO 控制流、防污染标签模型及差分比对算法细节，请参阅 Uptime Kuma 监控同步设计。