应用简介
Uptime Kuma 是一款功能强大的开源服务器监控工具,专为个人和小型团队设计。它提供了直观的界面来监控网站、API、数据库等服务的运行状态,并在服务出现问题时及时发送通知。Uptime Kuma 是一个轻量级应用,非常适合在 NAS 上部署,帮助用户实时监控各种服务的可用性。
- 开源免费:基于 MIT 许可证开源,完全免费使用
- 功能丰富:支持多种监控类型,如 HTTP、HTTPS、TCP、ICMP、DNS 等
- 实时监控:提供实时监控和历史数据统计
- 多通知渠道:支持邮件、Telegram、Discord、Slack 等多种通知方式
- 用户友好:直观的 Web 界面,操作简单

功能特点
核心功能
- 多种监控类型:
- HTTP/HTTPS 网站监控
- TCP 端口监控
- ICMP (Ping) 监控
- DNS 监控
- 自定义监控(如数据库连接)
- Docker 容器监控
- 通知系统:
- 邮件通知
- Telegram 机器人通知
- Discord 通知
- Slack 通知
- Webhook 通知
- 以及更多通知渠道
- 监控设置:
- 自定义监控间隔
- 超时设置
- 重试次数设置
- 自定义 HTTP 头和请求体
- 状态码验证
- 响应内容验证
- 数据可视化:
- 实时状态监控
- 历史数据图表
- 状态变更记录
- 正常运行时间统计
特色功能
- 多语言支持:支持多种语言界面
- 暗黑模式:提供暗黑主题,减少眼睛疲劳
- 维护模式:支持设置维护时间段,避免误报
- 多用户支持:支持创建多个用户,设置不同权限
- 仪表盘:提供概览仪表盘,快速查看所有监控项状态
- 导入/导出:支持监控配置的导入和导出
安装与配置
Docker Compose 配置
在 NAS 上部署 Uptime Kuma 非常简单,使用 Docker Compose 即可快速搭建。以下是完整的配置文件:
version: '3'
services:
uptime-kuma:
image: louislam/uptime-kuma:latest
container_name: uptime-kuma
ports:
- "3001:3001"
volumes:
- ./data:/app/data
restart: unless-stopped
部署步骤
已飞牛为例,项目设置如下:

使用指南
首次登录需创建管理员账户

基本操作
- 添加监控项:
- 点击仪表盘上的 "Add New Monitor" 按钮
- 选择监控类型(如 HTTP(s))
- 输入监控名称和目标 URL
- 设置监控间隔和其他参数
- 点击 "Save" 保存监控项
- 查看监控状态:
- 仪表盘上会显示所有监控项的实时状态
- 绿色表示正常,红色表示异常
- 点击监控项查看详细信息和历史数据
- 配置通知:
- 点击左侧菜单的 "Settings" → "Notifications"
- 点击 "Add Notification"
- 选择通知类型,填写相关配置
- 点击 "Test" 测试通知是否正常
- 点击 "Save" 保存通知配置


高级功能
- 设置维护模式:
- 编辑监控项
- 开启 "Maintenance Mode"
- 设置维护开始和结束时间
- 保存设置后,在此期间不会发送通知
- 创建状态页面:
- 点击左侧菜单的 "Status Pages"
- 点击 "Create Status Page"
- 配置状态页面名称和描述
- 选择要显示的监控项
- 保存后,可通过生成的 URL 访问公共状态页面
- 多用户管理:
- 点击左侧菜单的 "Settings" → "Users"
- 点击 "Add User"
- 填写用户名、邮箱和密码
- 设置用户角色(管理员或普通用户)
- 点击 "Save" 创建用户
注意事项
- 存储空间:Uptime Kuma 的数据存储相对较小,但如果监控项较多或历史数据保留时间较长,仍需确保有足够的存储空间
- 性能要求:
- 对于少量监控项(< 50),普通 NAS 设备完全可以胜任
- 对于大量监控项(> 100),可能需要更强大的硬件配置
- 数据备份:
- 定期备份
./data目录,以防数据丢失 - 可以通过导出监控配置作为额外备份
- 定期备份
- 网络设置:
- 确保 NAS 能够访问被监控的服务
- 如果监控外部服务,确保 NAS 有互联网连接
- 更新维护:
- 定期更新 Docker 镜像,以获取最新的功能和安全修复
- 更新前建议备份数据
常见问题
1. 监控项显示 "Down",但服务实际上是正常的
解决方案:
- 检查网络连接是否正常
- 确认监控目标 URL 是否正确
- 检查防火墙设置是否阻止了访问
- 尝试调整超时设置
2. 通知不工作
解决方案:
- 检查通知配置是否正确
- 点击 "Test" 按钮测试通知
- 检查网络连接是否允许发送通知
- 查看 Uptime Kuma 的日志以获取更多信息
3. 性能问题(监控响应缓慢)
解决方案:
- 减少监控项数量
- 增加监控间隔
- 确保 NAS 有足够的 CPU 和内存资源
- 考虑使用更强大的硬件
总结
Uptime Kuma 是一款功能强大且易于使用的服务器监控工具,非常适合在 NAS 上部署。它提供了丰富的监控类型和通知渠道,可以满足个人和小型团队的监控需求。通过 Docker Compose 部署,用户可以快速搭建自己的监控系统,实时监控各种服务的可用性。
无论是监控网站、API、数据库还是其他服务,Uptime Kuma 都能提供可靠的监控能力,并在服务出现问题时及时发送通知,帮助用户快速响应和解决问题。它是 NAS 应用生态中的重要工具,为用户的服务可靠性提供了有力保障。