
对外服务挂了,用户比你先知道?StatusBeam 是基于 Cloudflare 的开源状态页生成器:Cron 定时做 HTTP 检查,结果写入 D1 和 KV,Astro 加 shadcn/ui 在边缘渲染出带 90 天可用性、响应时间曲线和事件时间线的公开状态页。本文讲清它的部署姿势怎么选、4 个安装卡点、5 个必改设置,以及它和 Uptime Kuma、Better Stack 的分工边界。
基本信息
| 项目 | StatusBeam |
|---|---|
| 类型 | 开源状态页生成器(自托管) |
| 技术栈 | TypeScript + Astro + shadcn/ui(前端) |
| 运行平台 | Cloudflare:Cron Triggers(定时检查)+ D1(时间序列)+ KV + Workers Cache(边缘缓存) |
| 监控方式 | HTTP 检查(TCP/SSL 检查在官方路线图,选型前先确认) |
| 配置方式 | YAML 配置监控目标 |
| 输出 | 公开状态页、90 天可用性、响应时间图表、事件时间线、公开 JSON API、状态徽章 |
| 通知 | Slack、Webhook(状态变更推送) |
版本选择:三种部署姿势对比
| 姿势 | 特点 | 适合谁 |
|---|---|---|
| GitHub 仓库直连部署 | Cloudflare 全家桶一键起,检查层与展示层独立运行 | 纯 HTTP 服务监控首选 |
| 本地 Astro 预览调样式 | 改前端主题、调 shadcn/ui 样式时本地看效果 | 要定制状态页外观的 |
| 等 TCP/SSL 落地再上 | 当前版本只有 HTTP 检查 | 需要端口级探测、证书到期监控的先别上 |
明确推荐:纯 HTTP 服务监控现在就能用;要 TCP/SSL 探测或邮件、短信、电话等多通知渠道的,先去看官方路线图进度,别等部署完才发现不支持。
安装关键卡点(4 个)
- Cron 间隔先想好:检查间隔太密会吃掉 D1 的免费写额度。5 分钟一轮对大多数服务够用,核心接口再单独设 1 分钟。
- YAML 监控目标一次写全:每个目标的期望状态码、超时时间、关键字匹配一次配对。漏了超时设置,挂起的检查会拖慢整轮调度。
- D1 表初始化别跳过:wrangler d1 migrations apply 这步漏了,页面能打开但可用性图表全空,先排查这一步。
- 刚改完看到旧页面是缓存:状态页走 Workers Cache 边缘缓存,改完配置先清缓存再看,不是没生效。
装完必改的 5 个设置
- 检查间隔与超时分档:核心接口 1 分钟、边缘页面 5 分钟,超时按接口 P99 响应时间设,别一刀切。
- 状态阈值:连续几次失败才标红。一次网络抖动就全网公告,可信度掉得比服务还快。
- Slack/Webhook 通知:状态变更才推,恢复也要推一条。只推故障不推恢复,值班的人永远不知道什么时候能睡。
- 公开 JSON API 与状态徽章:把状态徽章挂到 README 和文档站首页,故障时用户先看状态页,而不是轰炸客服群。
- 事件时间线手工补录:计划内维护提前写成事件。否则”明明是计划维护”会被记成一次故障,SLA 白白扣分。
注意事项与常见问题
- 能监控 TCP 端口和 SSL 证书吗?当前版本是 HTTP 检查,TCP/SSL 在官方路线图里。选型前先确认,别部署完才发现不支持。
- 监控目标挂了,状态页会不会一起挂?不会。检查层和展示层独立跑在 Cloudflare 上,目标基础设施故障不影响状态页打开——这正是状态页独立部署的意义。
- 访客多会不会触发第三方 API 限流?不会。数据读的是自家 D1/KV,访客浏览器不直接调用第三方 API,这是它相对某些方案的优势。
- 免费额度够多少目标?看 Cloudflare 免费档的 Cron、D1、KV 配额,几十个目标按常规间隔一般没问题,超了再升档,先算好再加目标。
- 通知渠道只有 Slack 和 Webhook?目前是。邮件、短信、电话告警要自己接 Webhook 转出去,重度告警场景先评估这条链路。
适合谁、不适合谁
| StatusBeam | Uptime Kuma | Better Stack | |
|---|---|---|---|
| 部署 | Cloudflare 无服务器 | 自托管 Docker | SaaS |
| 成本 | 低(CF 免费额度) | 服务器成本 | 按量付费 |
| TCP/SSL 探测 | 路线图中 | 支持 | 支持 |
| 告警渠道 | Slack/Webhook | 多(90+) | 电话/短信/值班表 |
一句话判断:适合用 Cloudflare、偏好无服务器、要对外公示 SLA 的团队与独立开发者;不适合要 TCP/SSL 探测的(等路线图)、要 PagerDuty 级电话告警的(选 Better Stack)、纯内网服务监控的(Uptime Kuma 自托管更合适)。
开源地址
GitHub 国内访问较慢,如打不开可多刷新几次
推广

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
版权与使用提示
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›
文章推荐
标签推荐
正文完







