源码系统概览
文章正文
Uptime Kuma是一款开源的自托管网站监控工具系统，支持HTTP、TCP、DNS、Ping等多种监控方式，提供实时状态页面和告警通知。项目基于Node.js开发，包含src前端源码、server后端服务、db数据库层、extra扩展工具等6个目录共785个文件，GitHub星标9万，是运维监控领域最受欢迎的开源项目之一。
源码简介
Uptime Kuma（当前版本v1.23.13）是Louis Lam开发的自托管监控工具，采用MIT许可证，GitHub星标90595颗。
项目源码共785个文件，src目录包含Vue.js前端单页应用代码，server目录是Node.js后端服务实现监控调度和WebSocket推送，db目录使用SQLite存储监控配置和历史数据，extra目录存放构建辅助脚本和工具，test目录包含测试用例。
系统支持HTTP/HTTPS、TCP、DNS、Ping、Docker容器、数据库（MySQL/PostgreSQL/MongoDB）等多种监控类型，通过Socket.IO实现实时状态推送，内置状态页面生成器，支持Telegram、Discord、Slack、邮件、Webhook等90+通知渠道。
官网uptime.kuma.pet提供演示。
适用场景
适用于运维团队的网站可用性监控与告警、SaaS服务的SLA达标率追踪、API接口健康状态检测、数据库连接状态监控、Docker容器运行状态监测。
内置状态页面可直接对外展示服务可用性，适合需要向用户透明展示服务健康状态的团队。
也可用于个人自托管服务的统一监控面板。
技术栈与运行环境
技术栈基于Node.js和Vue.js，版本v1.23.13，许可证MIT，GitHub星标90595颗。
后端使用Express和Socket.IO，数据库采用SQLite（嵌入式无需额外安装），前端使用Vue 3和Bootstrap。
源码包含src、server、db、extra、test、.github等6个主要目录共785个文件。
与Prometheus等监控方案对比，Uptime Kuma的优势在于开箱即用零配置、内置90+通知渠道、单文件SQLite无需数据库运维、自带状态页面生成器。
功能亮点
- 支持HTTP/HTTPS、TCP、DNS、Ping、gRPC等多种监控协议
- 数据库监控：MySQL、PostgreSQL、MongoDB、Redis连接检测
- Socket.IO实时WebSocket推送，状态变化即时通知
- 90+告警通知渠道：Telegram、Discord、Slack、邮件、Webhook等
- 内置状态页面生成器，可自定义品牌和域名对外展示
- Docker一键部署，SQLite嵌入式数据库无需额外安装
技术架构与部署指南
安装与部署提示
推荐使用Docker一键部署：docker run -d –name uptime-kuma -p 3001:3001 louislam/uptime-kuma:1。
最后更新 2026 年，当前版本v1.23.13。
更新日志：v1.23.13修复多个安全漏洞和稳定性问题；v1.23新增gRPC监控和更多通知渠道；v1.22重构server目录优化监控调度性能。
部署时注意数据卷挂载持久化/db目录，首次访问需设置管理员账号密码。
截图与演示说明
封面截图展示Uptime Kuma的监控仪表盘主界面，可以看到多个监控项以卡片形式排列，每张卡片显示服务名称、当前状态（绿色正常/红色故障）、响应时间、可用率百分比和最近检查时间。
顶部导航栏提供添加监控、状态页面、设置等功能入口，整体界面简洁现代，信息一目了然。
同类工具对比
以下是Uptime-Kuma与其他网站监控工具的主要区别和对比：
| 项目 | 类型 | 许可证 | 主要特点 |
|---|---|---|---|
| Uptime-Kuma | 开源 | MIT | 网站监控，社区活跃 |
| Prometheus | 同类 | 各异 | 功能相似 |
| Pingdom | 同类 | 各异 | 侧重不同 |
| UptimeRobot | 同类 | 各异 | 各有优势 |
Uptime-Kuma和Prometheus的区别在于部署方式不同，Uptime-Kuma和Pingdom对比各有侧重，Uptime-Kuma可作为UptimeRobot的替代方案。
常见问题
问：Uptime Kuma是免费的吗？
完全免费开源，MIT许可证允许商用和修改。
自托管无任何限制，不依赖任何云端服务或订阅。
问：支持哪些监控类型？
支持HTTP/HTTPS、TCP、DNS、Ping、gRPC、Docker容器、以及MySQL、PostgreSQL、MongoDB、Redis等数据库连接监控。
问：如何配置告警通知？
在设置页面选择通知渠道（支持Telegram、Discord、Slack、邮件、Webhook等90+渠道），配置对应平台的Token或凭据后在监控项中关联即可。
问：可以监控多少个服务？
无硬性限制，取决于服务器硬件资源。
社区用户通常单实例监控数百到上千个服务项，SQLite数据库轻量高效。
问：如何实现高可用部署？
Uptime Kuma设计为单实例运行，高可用可通过多实例配合外部负载均衡实现。
社区也在探索分布式方案，关注GitHub Issues获取最新进展。
安全风险提示
监控系统可访问目标服务的连接信息，建议部署在内网或通过反向代理增加认证层。
SQLite数据库文件需设置适当权限避免未授权访问，告警通知中的Webhook URL可能包含敏感凭据需妥善保管。
下载说明
本源码已打包整理，提供百度网盘和蓝奏云双链下载，提取码8888。
下载后请先阅读README文件了解Docker部署步骤和环境配置方法，确保Node.js 18+环境就绪后再运行。
GitHub项目开源地址：https://github.com/louislam/uptime-kuma。