公开状态页

ServerBee 提供一个公开状态页，地址为 https://your-server/status。它无需认证即可访问，方便你向用户或相关方公示服务健康状态。

页面展示管理员选定的服务器和模块，数据来自公开端点 GET /api/status/config 和 GET /api/status。

页面展示内容

• 在线/总服务器数量。
• 每台选中服务器的在线/离线状态和分组标签。
• 在线服务器的实时指标：CPU、内存、Swap、磁盘、磁盘 I/O、网络速率/流量、负载、连接数、uptime。
• 每台服务器的 90 天可用性时间线。
• 已配置的公开备注。
• 可选模块：服务器详情、网络质量、IP 质量、事件公告、维护窗口。

IP 地址、主机名、网卡等敏感标识会在 API 层脱敏，不会出现在公开页面上。

配置状态页

在 Settings → Status Page 中配置。状态页是单例：只有一个页面，原地编辑，而非按 slug 创建多个。

管理 API

更新示例：

{
  "title": "Production Status",
  "description": "Public health for production services",
  "server_ids": ["server-id-1", "server-id-2"],
  "default_layout": "grid",
  "show_server_detail": true,
  "show_network": true,
  "show_incidents": true,
  "show_maintenance": true,
  "enabled": true,
  "uptime_yellow_threshold": 99.9,
  "uptime_red_threshold": 95
}

公开 API

以下端点无需认证，是公开页面的数据来源：

每个服务器条目包含 id、name、group_name、地区/国家、os、online、in_maintenance、uptime_percent 和 uptime_daily。

可用性时间线

每台服务器展示 90 天可用性时间线，每根条代表一天：

• 绿色 -- 健康可用性。
• 黄色 -- 低于黄色阈值。
• 红色 -- 低于红色阈值。
• 灰色 -- 无数据。

可用性数据来自 uptime_daily 表，由服务端后台聚合任务生成。缺失日期会自动补齐，保证时间线连续。

事件公告（Incidents）

事件公告用于公开说明故障或服务降级，可选关联到指定服务器。

字段

一个事件可以包含多条 update，每条 update 有自己的 status 和 message。添加 update 会记录消息，并把事件状态更新为该 update 的状态。状态变为 resolved 时会设置 resolved_at。

API

维护窗口

维护窗口用于公告计划维护，并在活动期间抑制相关服务器的告警通知。

字段

API