源码系统概览
文章正文
Uptime Kuma 是一款广受欢迎的自托管监控告警工具，本仓库提供其中文镜像源码免费下载与二次开发参考。
它以单容器部署、美观的中文界面和丰富的通知渠道著称，适合个人站长和小团队自己掌控监控数据。
下面从源码结构、技术栈与部署方式等角度，带你快速了解这套开源监控面板。
源码简介
Uptime Kuma 是一个类 UptimeRobot 的自托管监控服务，核心定位是监控网站、端口、数据库与 Docker 容器等在线服务的可用性，并在异常时自动告警。
与按监控项收费的商用 SaaS 不同，它采用单容器自托管模式，数据完全由用户自己掌控，监控项数量没有上限，也不会产生订阅费用。
本源码版本基于官方 2.5.3 分支，使用 MIT 开源协议发布，内置完整中文界面，方便国内用户直接部署和使用。
项目由开发者 louislam 发起并维护，在 GitHub 上累计获得 9 万+ Star，是自建监控领域最具代表性的开源项目之一。
源码结构清晰，前端页面与后端服务分目录组织，二次开发和维护门槛相对较低。
适用场景
个人站长可以用它监控自己的博客、官网和接口，第一时间发现网站宕机或 SSL 证书到期。
小团队和创业公司可以把它作为轻量运维面板，统一查看多个业务服务的存活状态。
需要对外展示服务可用性的组织，可以用它生成公开的品牌状态页，向用户透明同步故障与恢复情况。
对数据隐私敏感的用户，借助自托管特性把监控数据留在自己的服务器，避免交给第三方平台。
功能亮点
监控类型覆盖全面，支持 HTTP(s)、TCP、Ping、DNS、Docker 容器，以及 MySQL、PostgreSQL、SQL Server、Oracle、MongoDB、MQTT、Kafka、gRPC 等多种协议与服务。
通知渠道超过 90 种，包含邮件、企业微信、钉钉、Telegram、Slack、Webhook 和 PagerDuty 等，异常时能多通道同时触达负责人。
内置状态页功能，可生成带自定义 Logo 和域名的公开页面，并支持 RSS 订阅，方便对外展示服务状态。
提供 SSL 证书监控、响应时间图表、事件管理、维护计划与标签分组等实用能力，日常运维所需基本齐全。
支持双因素认证（2FA），管理后台安全性有保障，且界面原生支持中文等多语言。
在同类自建监控方案中，Uptime Kuma 更侧重”开箱即用”和”状态页展示”，与偏企业级的 Zabbix 形成明显差异：
| 对比维度 | Uptime Kuma | Zabbix |
|---|---|---|
| 技术栈 | Node.js + Vue 3 单容器 | 后端 C、前端 PHP，依赖 MySQL/PostgreSQL |
| 部署复杂度 | 一条 docker run 即可启动 | 需服务端、数据库与前端，配置较重 |
| 功能侧重 | 可用性监控、状态页、多渠道通知 | 指标采集、自动化告警，偏企业大规模 |
如果你只需要轻量地看护服务和对外展示状态，Uptime Kuma 是比 Zabbix 更省心的选择；若要做深度指标采集，两者也可互补使用。
技术架构与部署指南
技术栈与运行环境
前端：Vue 3 + Vite.js（含 179 个 .vue 页面组件，配套 SCSS 与 dayjs）
后端：Node.js >= 20.4（Express + Socket.IO，JavaScript ESM，少量 TypeScript）
数据库：SQLite（默认内置）/ MariaDB（通过 Knex 迁移，两种均可）
运行环境：推荐 Docker 部署，监听 3001 端口，支持 PM2 进程守护
其他依赖：Knex ORM、axios、Socket.IO 及 90+ 通知渠道 Provider
安装与部署提示
最推荐的方式是使用官方 Docker 镜像，执行一条命令即可拉起服务并挂载数据卷。
命令为 docker run -d –restart=always -p 3001:3001 -v uptime-kuma:/app/data –name uptime-kuma louislam/uptime-kuma:2。
若选择源码运行，需先安装 Node.js 20.4 以上版本，执行 npm run setup 完成依赖与数据库初始化。
随后通过 npm run start 启动服务，默认监听 3001 端口，也可配合 compose.yaml 或 PM2 托管。
首次访问 http://localhost:3001 会进入初始化向导，按提示创建管理员账号即可开始添加监控。
截图与演示说明
初次打开系统会进入 Setup 初始化页面，用于创建管理员账号和设置基础选项，对应前端 src/pages/Setup.vue。
登录后的 Dashboard 仪表盘（src/pages/Dashboard.vue）以卡片列表展示所有监控项的实时状态与响应耗时。
点击 AddMonitor（src/pages/AddMonitor.vue）可新建监控，填写目标网址、选择监控类型并设置检查间隔。
EditMonitor 与 Details 页面分别负责监控项编辑和单项的时延曲线、证书信息等详情展示。
ManageStatusPage（src/pages/ManageStatusPage.vue）用于配置对外公开的状态页，最终通过 /status/:slug 路由展示。
Settings 设置页集中管理通知渠道、2FA、标签和维护计划，对应后端 server 下的多个 router 与 model。
常见问题
问：Uptime Kuma 是什么？
答：它是一款开源的自托管监控工具，用于检测网站、端口、数据库和容器等服务的可用性，并在异常时通过多种渠道发送告警。
问：Uptime Kuma 免费吗？可以商用吗？
答：项目以 MIT 协议开源发布，源码可免费下载和使用；商用前请自行确认协议条款与合规性，本仓库仅作学习研究参考。
问：它和 Zabbix、UptimeRobot 有什么区别？
答：相比偏企业级的 Zabbix，Uptime Kuma 部署更轻、更聚焦状态页；相比按监控项收费的 UptimeRobot SaaS，它自托管且数据私有、无订阅费。
问：支持哪些通知渠道？
答：内置 90 多种通知方式，包括邮件、企业微信、钉钉、Telegram、Slack、Webhook、PagerDuty 等常见渠道。
问：部署后怎么访问管理后台？
答：服务默认监听 3001 端口，浏览器打开 http://服务器IP:3001 即可进入安装与登录界面。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本仓库为 Uptime Kuma 开源项目的镜像源码，遵循上游 MIT 协议，下载后建议对照官方仓库核对版本与完整性。
部署到公网时请务必设置强密码并开启双因素认证，避免监控后台被未授权访问。
GitHub项目开源地址：https://github.com/louislam/uptime-kuma
最后更新：2026-08-27
