返回探索

详细介绍
uptime-kuma 仓库中文介绍文档
uptime-kuma 是一个自托管的监控工具,用于监控网站、服务器和网络服务的可用性,由 louislam 提供,支持多种监控方式和通知渠道,汇聚/支持/包含 HTTP(s)、TCP、WebSocket、Docker 容器等监控功能。
要点:
- 开头就要说清楚:这是什么工具、解决什么问题
- 包含Stars数(如有)、维护者信息
- 1-3句话,简洁有力
示例: OpenBB 是一款面向金融分析师、量化交易员与 AI 智能体的开源金融数据平台,以"一次连接、随处消费"为核心架构,统一接入股票、期权、加密等多资产数据。
一、核心信息速览
| 维度 | 详情 |
|---|---|
| :--- | :--- |
| 仓库地址 | [uptime-kuma](https://github.com/louislam/uptime-kuma) |
| 许可证 | MIT License |
| 核心定位 | 监控网站、服务器和网络服务的可用性 |
| 主要语言 | JavaScript |
| 适用人群 | 系统管理员;开发者;运维人员 |
| 关键亮点 | 自托管;支持多种监控方式;丰富的通知渠道;响应式界面 |
二、核心功能
| 功能模块 | 描述 | 典型场景 |
|---|---|---|
| :--- | :--- | :--- |
| HTTP(S) 监控 | 监控网页是否可达 | 检查网站是否正常运行 |
| TCP 监控 | 检测 TCP 端口是否开放 | 检查数据库或服务端口状态 |
| WebSocket 监控 | 检测 WebSocket 连接 | 实时通信服务状态监测 |
| Docker 容器监控 | 监控容器运行状态 | 确保容器服务稳定 |
| 多语言支持 | 支持多种语言界面 | 全球用户使用 |
| 多个状态页面 | 显示多个状态页面 | 为不同项目提供独立状态页 |
| 通知系统 | 支持多种通知方式 | 及时获取异常通知 |
| 2FA 支持 | 增强账户安全 | 防止未授权访问 |
三、快速上手
1. 环境准备
需要安装 Docker 和 Docker Compose。
2. 安装方式
mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
3. 基础配置
无需额外配置,直接通过 http://localhost:3001 访问即可。
4. 核心示例
docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
四、核心亮点
- 自托管:完全可以在本地部署,保护隐私。
- 支持多种监控方式:包括 HTTP(S)、TCP、WebSocket、Docker 容器等。
- 丰富的通知渠道:支持 Telegram、Discord、Slack、邮件等。
- 响应式界面:适用于桌面和移动端。
- 多语言支持:支持多种语言,便于全球用户使用。
- 安全性高:支持 2FA,增强账户安全性。
五、适用场景
- 系统管理员:监控服务器和网络服务的可用性。
- 开发者:确保开发环境中的服务正常运行。
- 运维人员:实时监控关键服务的状态。
- 团队协作:通过状态页面共享服务状态。
- 个人使用:监控个人网站或服务的可用性。
六、优缺点
优势
- 完全自托管,隐私性强。
- 支持多种监控方式和通知渠道。
- 界面友好,易于使用。
- 多语言支持,适合全球用户。
不足
- 需要一定的技术基础进行部署。
- 对于新手来说,配置可能稍显复杂。
七、与同类工具对比(可选)
| 工具 | 类型 | 核心差异 |
|---|---|---|
| :--- | :--- | :--- |
| uptime-kuma | 开源 | 免费开源、易用、功能全面 |
| UptimeRobot | 商业 | 有免费版本,但功能有限 |



