Kuvasz：面向自托管环境的正常运行时间与 SSL 监控

项目用途

Kuvasz 是一个开源、自托管的正常运行时间与 SSL 监控服务，目标是帮助用户持续了解网站、网络服务和定时任务的状态。它提供 Web 界面、状态页、REST API 与 MCP server，既可以用于个人服务器和家庭实验室，也可以接入已有的可观测性体系。项目采用 AGPL-3.0 许可证；部署方式、运行依赖和资源需求应以官方部署文档为准，当前来源没有确认最低硬件配置。

图片来源：kuvasz。项目公开截图，界面可能随版本变化。

已知功能

监控类型覆盖 HTTP(S)、SSL 证书、Heartbeat、ICMP Ping、TCP 端口和 DNS。Heartbeat 适合 cron 任务、备份等由外部任务主动上报的场景；DNS 监控可检查解析结果、响应码，并对 A、MX、TXT、NS 等记录使用精确、子串或正则匹配。HTTP(S) 监控还可检查可用性与性能。

告警可以按监控项配置，项目 README 列出的渠道包括 Email、Discord、Slack、Telegram、Microsoft Teams、Apprise、Pushover、PagerDuty 和自定义 Webhook。用户还能创建公开或私有状态页，并用维护窗口暂停受影响的检查，减少计划停机造成的误报。

在集成方面，Kuvasz 提供 REST API，并可将指标导出到 Prometheus 与 OpenTelemetry。MCP server 允许通过 AI 助手查询监控状态、查看事件，以及创建或切换监控。官方 README 还提到 Home Assistant 集成，但该集成位于独立项目中，采用前应单独核实其维护状态与适配范围。

4.4.0 版本增加了监控分类：状态页和维护窗口可以按分类选择监控，列表也支持按分类过滤；监控详情图表增加事件标记和可选时间范围，状态页与维护窗口支持从列表编辑和克隆。这些功能对按产品、团队或服务分组管理的用户更有帮助。

适合人群

Kuvasz 适合希望自行掌握监控服务、通知配置和历史数据的个人运维者、家庭实验室用户、小型团队，以及需要 YAML、API 或指标导出的工程团队。若你已经使用 Prometheus 或 OpenTelemetry，它可以作为面向可用性检查的补充，而不是替代完整的日志、链路和基础设施监控体系。

采用前的限制与部署考虑

自托管意味着你需要自行负责部署、升级、备份、网络连通性、凭据管理和告警链路验证。项目支持状态页和多种通知渠道，但来源没有确认具体的可用性承诺、默认数据保留策略、最低硬件要求或各类部署环境的兼容矩阵，不能据此推断其适合生产规模。

监控位置也需要谨慎规划：README 说明可以部署到多个位置，但并非开箱即用的按位置监控。对于跨地域探测，应先确认部署拓扑和数据汇总方案。若使用 HTTP 自定义请求头，4.4.0 的安全修复值得关注；升级后仍应检查重定向、敏感凭据和被监控目标的配置。最终部署前，应阅读官方安装文档、核对版本变更，并在非生产环境验证通知、备份恢复、状态页访问控制与 API 权限。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-09-18