Skip to content
返回云服务

Uptime Kuma（自托管监控）

开源自托管可用性监控（UptimeRobot 替代），支持 HTTP/TCP/ping/DNS 检查、状态页和通知。

VPS 与自托管入门

为什么

Uptime Kuma 是单容器可用性监控，界面精致，70+ 通知集成（Slack、Discord、邮件、PagerDuty）和公开状态页。自托管避免 UptimeRobot 限制并保持监控数据私有。

支持 cron 作业的推送监控和证书过期告警。

何时使用

用 Uptime Kuma 监控自托管服务、外部 API 和 TLS 证书过期。运行在被监控服务不同的 VPS 上（使被监控主机宕机不影响监控器）。免费且无限。

如何做

1. 运行 Uptime Kuma 容器并带命名卷。 2. 打开端口 3001 的 UI 创建管理员账户。 3. 添加监控：HTTP（URL）、TCP（host:port）、Ping、DNS 或 Push。 4. 设置检查间隔和重试。 5. 配置通知（Slack webhook、邮件 SMTP 等）。 6. 按需创建公开状态页。 ```bash docker run -d --restart=always --name uptime-kuma \ -p 3001:3001 -v uptime-kuma:/app/data \ louislam/uptime-kuma:1 ```

示例

// vps-uptime-kuma — 配置示例 const config = { provider: "vps" }; 添加带 Slack 通知的 HTTP 监控和公开状态页： 1. 设置 > 通知 > Slack > 添加 webhook URL > 测试 > 保存。 2. 添加新监控 > HTTP(s) > URL：https://app.example.com/health > 间隔 60 秒 > 启用通知。 3. 添加证书监控：类型 "Certificate" > 域名 app.example.com > 过期 < 14 天告警。 4. 状态页 > 新建 > 添加监控 > 设置 slug "public" > 分享 https://status.example.com。 cron 作业的推送监控（作业每次运行 ping URL）： ```bash # 在 cron 作业中，成功后： curl -fsS "https://kuma.example.com/api/push/AbCd123?status=up&msg=OK&ping=42" ```

常见问题

  • ⚠监控显示宕机但站点正常 —— 监控的预期状态码或关键词过滤太严；检查监控的 'Keyword' 和 'Accepted Status Codes' 设置。
  • ⚠通知未触发 —— 通知渠道测试静默失败；在设置中重新测试并检查 webhook URL / SMTP 凭据。
  • ⚠环境间配置漂移 — 使用基础设施即代码（Terraform/Pulumi）保持 dev/staging/prod 一致

最佳实践

  • ✓将 Uptime Kuma 运行在与被监控服务不同的主机上，使单主机故障不会致监控失明。
  • ✓cron 作业和备份用推送监控 —— 作业成功时 ping Kuma，ping 停止时 Kuma 告警（作业挂起或失败）。
  • ✓为每个 TLS 端点添加证书过期监控，过期前 14 天告警，而非当天才告警。

常见问题解答

什么是Uptime Kuma（自托管监控）？它解决什么问题？

开源自托管可用性监控（UptimeRobot 替代），支持 HTTP/TCP/ping/DNS 检查、状态页和通知。 它可帮助开发者在不自建基础设施的前提下完成部署、存储与扩展，是云服务选型的核心参考。

如何在 5 分钟内上手Uptime Kuma（自托管监控）？

两步即可跑通：① 运行 Uptime Kuma 容器并带命名卷。；② 打开端口 3001 的 UI 创建管理员账户。。建议先用免费套餐验证流程，再接入生产环境。

Uptime Kuma（自托管监控） 最容易踩的坑是什么？

最高频的问题是：监控显示宕机但站点正常 —— 监控的预期状态码或关键词过滤太严；检查监控的 'Keyword' 和 'Accepted Status Codes' 设置。。建议在上线前用 checklist 逐项核对，并在 CI 中加入策略与配置扫描。

Uptime Kuma（自托管监控） 的最佳实践有哪些？

Uptime Kuma（自托管监控） 的最佳实践包括：将 Uptime Kuma 运行在与被监控服务不同的主机上，使单主机故障不会致监控失明。；cron 作业和备份用推送监控 —— 作业成功时 ping Kuma，ping 停止时 Kuma 告警（作业挂起或失败）。；为每个 TLS 端点添加证书过期监控，过期前 14 天告警，而非当天才告警。。其中首条「将 Uptime Kuma 运行在与被监控服务不同的主机上，使单主机故障不会致监控失明。」应作为团队默认规范写入 IaC 模板。

Uptime Kuma（自托管监控） 如何控制成本与避免账单意外？

三招防超支：① 为所有资源打 env/team 标签并启用账单告警；② 用预算阈值触发 Slack/邮件通知；③ 定期用 Cost Explorer 审查闲置资源并清理。Uptime Kuma（自托管监控） 多数提供免费套餐，先在免费额度内验证再放量。