uptime-kuma (自建网站监控工具)
93,546
Stars
—
Forks
0
Watchers
—
Open Issues
待补全
许可证
JavaScript
语言
—
创建时间
最近更新
项目能做什么
一款开箱即用、界面美观的自托管运维监控工具。
来源:AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
{
"project_name": "Uptime Kuma",
"markdown_docs": "## 项目简介\n\nUptime Kuma 是一款美观且易于上手的自建(self-hosted)服务监控工具。\n\n## 核心功能\n\n- **多类型监控**:支持 HTTP(s)、TCP、HTTP(s) 关键字、HTTP(s) Json Query、Websocket、Ping、DNS Record、Push、Steam 游戏服务器以及 Docker Containers。\n- **优秀的 UI/UX**:界面精致、响应迅速、交互流畅。\n- **丰富的告警通知**:支持 Telegram、Discord、Gotify、Slack、Pushover、Email (SMTP) 以及 90 多种其他通知渠道。\n- **高频监控**:支持 20 秒监控间隔。\n- **状态页(Status Page)**:支持创建多个状态页,并支持将状态页映射至特定域名。\n- **其他特性**:提供多语言支持、Ping 图表展示、SSL/TLS 证书信息查询、代理(Proxy)支持以及双因素认证(2FA)。\n\n## 适合谁用\n\n此部分原文未说明,请查看原仓库。\n\n## 安装步骤\n\n### 方式一:Docker Compose(推荐)\n\n```bash\nmkdir uptime-kuma\ncd uptime-kuma\ncurl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml\ndocker compose up -d\n```\n\n> **注意**:不支持 NFS 等网络文件系统,挂载时请映射至本地目录或本地 volume。\n\n### 方式二:Docker 命令\n\n运行以下命令启动容器:\n\n```bash\ndocker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2\n```\n\n如果仅允许本机访问,可限制端口绑定:\n\n```bash\ndocker run ... -p 127.0.0.1:3001:3001 ...\n```\n\n启动完成后,在浏览器访问 `http://localhost:3001` 或 `http://your-ip:3001` 即可使用。\n\n### 方式三:非 Docker 环境安装\n\n**系统与环境要求**:\n- 支持平台:主流 Linux 发行版(如 Debian、Ubuntu、Fedora、ArchLinux 等)、Windows 10 (x64)、Windows Server 2012 R2 (x64) 或更高版本。\n- 不支持平台:FreeBSD / OpenBSD / NetBSD、Replit / Heroku。\n- 依赖软件:Node.js >= 20.4、Git、pm2(用于后台运行)。\n\n**操作步骤**:\n\n```bash\n# 拉取代码并初始化环境\ngit clone https://github.com/louislam/uptime-kuma.git\ncd uptime-kuma\nnpm run setup\n\n# 选项 1:直接运行测试\nnode server/server.js\n\n# 选项 2(推荐):使用 PM2 在后台运行\n# 如果尚未安装 PM2,先执行安装:\nnpm install pm2 -g && pm2 install pm2-logrotate\n\n# 启动服务\npm2 start server/server.js --name uptime-kuma\n```\n\n常用 PM2 管理命令:\n```bash\n# 查看当前控制台输出\npm2 monit\n\n# 设置开机自启并保存状态\npm2 startup && pm2 save\n```\n\n服务启动后,同样通过 `http://localhost:3001` 或 `http://your-ip:3001` 访问。\n\n## 配置说明\n\n关于高级安装、反向代理配置等更详细的内容,请参阅官方 Wiki: \nhttps://github.com/louislam/uptime-kuma/wiki/%F0%9F%94%A7-How-to-Install\n\n## 常见问题\n\n此部分原文未说明,请查看原仓库。"
}
原始 README 摘录(英文原文,节选前 3000 字符)
<div align="center" width="100%">
<img src="./public/icon.svg" width="128" alt="Uptime Kuma Logo" />
</div>
# Uptime Kuma
Uptime Kuma is an easy-to-use self-hosted monitoring tool.
<a target="_blank" href="https://github.com/louislam/uptime-kuma"><img src="https://img.shields.io/github/stars/louislam/uptime-kuma?style=flat" /></a> <a target="_blank" href="https://hub.docker.com/r/louislam/uptime-kuma"><img src="https://img.shields.io/docker/pulls/louislam/uptime-kuma" /></a> <a target="_blank" href="https://hub.docker.com/r/louislam/uptime-kuma"><img src="https://img.shields.io/docker/v/louislam/uptime-kuma/2?label=docker%20image%20ver." /></a> <a target="_blank" href="https://github.com/louislam/uptime-kuma"><img src="https://img.shields.io/github/last-commit/louislam/uptime-kuma" /></a> <a target="_blank" href="https://opencollective.com/uptime-kuma"><img src="https://opencollective.com/uptime-kuma/total/badge.svg?label=Open%20Collective%20Backers&color=brightgreen" /></a>
[](https://github.com/sponsors/louislam) <a href="https://weblate.kuma.pet/projects/uptime-kuma/uptime-kuma/">
<img src="https://weblate.kuma.pet/widgets/uptime-kuma/-/svg-badge.svg" alt="Translation status" />
</a>
<img src="https://user-images.githubusercontent.com/1336778/212262296-e6205815-ad62-488c-83ec-a5b0d0689f7c.jpg" width="700" alt="Uptime Kuma Dashboard Screenshot" />
## 🥔 Live Demo
Try it!
Demo Server (Location: Frankfurt - Germany): <https://demo.kuma.pet/start-demo>
It is a temporary live demo, all data will be deleted after 10 minutes. Sponsored by [Uptime Kuma Sponsors](https://github.com/louislam/uptime-kuma#%EF%B8%8F-sponsors).
## ⭐ Features
- Monitoring uptime for HTTP(s) / TCP / HTTP(s) Keyword / HTTP(s) Json Query / Websocket / Ping / DNS Record / Push / Steam Game Server / Docker Containers
- Fancy, Reactive, Fast UI/UX
- Notifications via Telegram, Discord, Gotify, Slack, Pushover, Email (SMTP), and [90+ notification services, click here for the full list](https://github.com/louislam/uptime-kuma/tree/master/src/components/notifications)
- 20-second intervals
- [Multi Languages](https://github.com/louislam/uptime-kuma/tree/master/src/lang)
- Multiple status pages
- Map status pages to specific domains
- Ping chart
- Certificate info
- Proxy support
- 2FA support
## 🔧 How to Install
### 🐳 Docker Compose
```bash
mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
```
Uptime Kuma is now running on all network interfaces (e.g. http://localhost:3001 or http://your-ip:3001).
> [!WARNING]
> File Systems like **NFS** (Network File System) are **NOT** supported. Please map to a local directory or volume.
### 🐳 Docker Command
```bash
docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
```
Uptime Kum
阅读完整原文
项目深度分析 AI 生成
托管型 Uptime Kuma (Managed SaaS)
| 产品构想 | 提供免运维、开箱即用的云端托管服务,集成多地域节点探测,解决自建自测'自测服务器挂了无法自知'的痛点。 |
| 核心功能 | 一键注册即用、全球 5-10 个区域分布式探测节点对比、自定义域名状态页托管、集成 SMS/语音告警。 |
| 目标用户 | 不想自行购买服务器维护 Docker 的中小站长、初创团队及自由职业者。 |
| 难度/周期 | 中等 · 1 - 2 个月 · 成本:每月 $100 - $300(多区域轻量云服务器/VPS成本及带宽) |
| 收费模式 | 按监控站点数量及检查频率(如20秒、60秒)订阅收费,提供基础免费层与 $5-$30/月阶梯订阅。 |
| 竞争风险 | 自建 SaaS 赛道竞争激烈(已有 Better Uptime、UptimeRobot 等成熟竞品),且需承担多节点网络稳定性和抗 DDoS 成本。 |
| 依据 | 已验证事实 |
多探针集群与集中管理插件/控制台 (Kuma Hub)
| 产品构想 | 针对已有自建实例的企业用户,开发多实例统一聚合看板及远程 Agent 探针分发扩展,增强跨云/内网监控能力。 |
| 核心功能 | 集中式 Dashboard 汇总多个 Kuma 实例状态、跨网络私有探针数据汇总、多租户与 RBAC 权限控制。 |
| 目标用户 | 拥有多云、混合云或多个独立客户环境的 MSP(IT服务外包商)、企业运维团队。 |
| 难度/周期 | 中等 · 2 - 3 个月 · 成本:开发机器与少量测试云资源,极低运维成本 |
| 收费模式 | 售卖私有部署的企业级插件授权或按管理的实例/探针数量按年收取 License 费用。 |
| 竞争风险 | 开源社区本身在持续演进,官方未来若原生实现多节点/探针架构可能削弱产品独特性(推测)。 |
| 依据 | AI推测 |
移动端 Native App 与增值告警网关
| 产品构想 | 开发适配 iOS / Android 的高质量移动端客户端,并提供高可靠的 VoIP 电话呼叫和短信突发告警增值通道。 |
| 核心功能 | 原生推送通知(绕过系统休眠)、Widget 桌面小组件、一键直连自建实例 API、付费接入电话/SMS紧急呼叫通道。 |
| 目标用户 | 需要全天候响应告警的 SRE、运维工程师、自建 Kuma 实例的系统管理员。 |
| 难度/周期 | 较低 · 1 - 1.5 个月 · 成本:Apple/Google 开发者账号费用(约 $125/年)+ 通信网关(如 Twilio)按量费用 |
| 收费模式 | 应用买断制(如 $4.99)或告警额度包(SMS/电话按量充值)、月度通知保障订阅。 |
| 竞争风险 | 依赖官方 API 兼容性,且部分用户可能倾向于直接使用 Telegram/Discord 等免费渠道替代通知。 |
| 依据 | 数据支持的判断 |
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
相似项目数据正在完善中,暂不展示(避免误导)
项目优势与风险
| 技术成熟度 | 创建时间待补全,最近推送 ,发布过 100 个 Release |
| 社区活跃 | Star 93,546 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
此项目未提供 Docker 镜像,安装步骤以原仓库 README 为准(涉及依赖安装与环境配置,对新手门槛较高)。